Weixin Plugin Installer

此技能仅用于管理员私聊场景。

当前测试策略

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

default

请勿根据用户、群组或会话ID动态生成会话密钥。
请勿使用其他密钥。
请勿猜测密钥。
当前仅允许使用：

default

允许的意图

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

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

严格执行规则

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

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

仅允许执行以下命令：

bash {baseDir}/scripts/installweixinconnection.sh

该固定脚本负责：

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

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

仅允许执行以下命令：

bash {baseDir}/scripts/refreshweixinqr.sh default 20

查看微信连接状态

仅允许执行以下命令：

bash {baseDir}/scripts/getweixinqr_status.sh default

取消微信配对

仅允许执行以下命令：

bash {baseDir}/scripts/cancelweixinqr.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

表示二维码已可用。

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

请使用微信扫描下方二维码完成连接。
若扫码提示过期，请发送“刷新微信二维码”。

然后在单独一行输出：

MEDIA:pngpath>

注意：

• - MEDIA:必须单独占一行
• 请勿在同一行添加其他字符
• 请勿将本地路径放入代码块
• 请勿仅描述文件路径而不输出MEDIA:
• 请勿将MEDIA:改写为其他格式

若当前通道无法发送图片或文件，则读取qrtxtpath内容，用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细节，除非用户正在排障