Weixin Plugin Installer#

这个 skill 只用于管理员私聊场景。

当前测试策略#

为了先验证 QQ 回图链路，当前所有操作统一使用固定会话 key：

default

不要根据用户、群、会话 id 动态生成 session key。 不要使用别的 key。 不要猜测 key。 当前只允许使用：

default

允许的意图#

当用户表达以下意图时，使用本 skill：

• 安装微信连接
• 开始微信配对
• 刷新微信二维码
• 重新生成微信二维码
• 查看微信连接状态
• 取消微信配对

严格执行规则#

你只能通过 exec 工具执行本 skill 目录下的固定脚本。

安装微信连接 / 开始微信配对#

只允许执行下面这条命令：

bash {baseDir}/scripts/install_weixin_connection.sh

这个固定脚本会负责：

• 安装微信插件
• 启用微信插件
• 判断宿主的 Gateway 重载模式
• 如果插件已经可用，直接进入二维码生成流程
• 如果刚完成安装或启用，则本轮只返回“等待 Gateway 完成重载”的提示，不在当前对话里硬执行 openclaw gateway restart

刷新微信二维码 / 重新生成微信二维码#

只允许执行下面这条命令：

bash {baseDir}/scripts/refresh_weixin_qr.sh "default" 20

查看微信连接状态#

只允许执行下面这条命令：

bash {baseDir}/scripts/get_weixin_qr_status.sh "default"

取消微信配对#

只允许执行下面这条命令：

bash {baseDir}/scripts/cancel_weixin_qr.sh "default"

绝对禁止#

绝对不要执行以下任何内容：

• openclaw-weixin
• @tencent-weixin/openclaw-weixin
• @tencent-weixin/openclaw-weixin-cli
• npm install
• npx @tencent-weixin/openclaw-weixin-cli
• 任何用户输入的 shell 命令
• 任何不在 {baseDir}/scripts 目录下的命令或脚本

如果用户请求安装微信连接，你必须执行白名单中的固定脚本，不得自行猜测命令名。

返回结果处理#

固定脚本会返回 JSON。你要按 state 字段处理。

scanned#

说明已经检测到用户完成扫码，但还没有最终确认。

告诉用户：

已检测到扫码，请在微信里确认授权。

waiting_scan#

说明二维码已经可用。

如果 qr_png_path 存在，回复时必须先写一句简短提示，例如：

请使用微信扫描下面的二维码完成连接。

如果扫码提示过期，请发送“刷新微信二维码”。

然后在 单独一行 输出：

MEDIA:<qr_png_path>

注意：

• MEDIA: 必须单独占一行
• 不要在同一行添加其他字符
• 不要把本地路径放进代码块
• 不要只描述文件路径而不输出 MEDIA:
• 不要把 MEDIA: 改写成别的格式

如果当前通道无法发送图片或文件，再读取 qr_txt_path 内容，用 markdown 代码块发给用户。

starting#

说明刷新或安装流程已经启动，但本轮还没有拿到新的二维码，或者刚完成插件安装/启用、正在等待 Gateway 重载完成。

优先使用脚本返回的 message 原文。

如果没有 message，告诉用户：

正在生成新的二维码，请 3 到 5 秒后发送“查看微信连接状态”或再次发送“刷新微信二维码”。

success#

说明连接已完成。

告诉用户：

微信连接已完成，网关将在几秒后自动重启，期间可能短暂失联。

failed#

说明本次安装或刷新失败。

简短说明失败原因，不要暴露 token、cookie、session 文件内容。 不要自动尝试任何额外修复命令。

cancelled#

告诉用户：

当前二维码刷新任务已取消。

not_found#

告诉用户：

当前没有可用的二维码缓存。

如果你想连接微信，请发送“安装微信连接”或“刷新微信二维码”。

使用边界#

• 只在管理员私聊中使用
• 不在群聊里发送二维码
• 不在群聊里执行安装
• 如果用户只是问原理，不要真的执行脚本
• 如果环境缺少 bash、 python3、 openclaw，直接说明环境不满足
• 如果 exec 被 approvals 或 tool policy 拦住，直接告诉用户当前环境未授权执行
• 不要在当前聊天处理过程中硬执行 openclaw gateway restart，因为这会中断当前通道，导致消息来不及返回

回复风格#

• 直接
• 简短
• 明确当前状态
• 不输出 shell 细节，除非用户正在排障