个人微信 Connect Skill

⚠️ 匹配规则（严格区分，不得混淆）

本 skill 仅适用于个人微信，以下关键词触发：

• - "连接个人微信" / "接入个人微信" / "绑定个人微信"
• "个人微信扫码" / "微信扫码登录"
• "连接微信"（未带"企业"二字时，默认为个人微信）

以下关键词不属于本 skill，禁止触发：

• - "企业微信" / "企微" / "wecom" / "WeCom" → 使用 wecom-connect skill

一旦读取本 skill，必须严格按下方流程从第 0 步执行到底，不得跳步、不得自由发挥、不得读取其他文档。

核心原则

• - 严格按步骤走，不要加戏，不要自作聪明加额外命令。
• 二维码相关步骤（第 2-3 步）速度优先！ 二维码有效期仅约 1 分钟，获取和生成二维码的命令用 && 链起来一次执行。其他步骤（版本检测、插件安装、凭证写入等）可以分步执行，便于用户检查中间输出。
• qrcode_img_content 是一个 URL 字符串，必须用 qrcode npm 库把它编码成 PNG 图片。 这个 URL 指向的是网页不是图片，绝对禁止用 curl -o 直接下载。
• 二维码展示以本地 workspace 文件为主。 优先引导用户打开 ~/workspace/weixin_qr.png。如果用户环境不便打开本地文件，可使用 upload_to_cdn 作为辅助手段（注意：CDN 上传会将一次性授权二维码暴露到外部，仅在必要时使用）。
• 凭证写入前必须展示并确认。 写入 token 等敏感信息到磁盘前，必须先向用户展示即将写入的内容（accountId、token 前 8 位 + 掩码、baseUrl、userId），等用户确认后再执行写入。
• 不要自动轮询。 给完二维码等用户说"扫完了"再轮询。
• 不要手动改写 openclaw.json。
• 运行时安装的包说明： 本 skill 会在运行时通过 npm/npx 安装以下包：① openclaw（OpenClaw CLI 工具）来源 registry.npmmirror.com ② @tencent-weixin/openclaw-weixin-cli（腾讯官方微信插件）③ qrcode（二维码生成库，仅安装在 /tmp 临时目录）。执行前应确认用户信任这些包来源。

执行流程

第 0 步：检测 openclaw 版本，决定安装路径

CODEBLOCK0

从输出中提取版本号（格式：OpenClaw 2026.X.Y），按以下规则分支：

条件	路径
版本 ≤ 2026.3.x（含 3.13）	路径 A：先升级插件，再升级 openclaw
版本 > 2026.3.13（如 2026.3.23 及以上）

路径 B：先升级插件，再更新 openclaw 版本 |
| 未安装 / 命令不存在 | 告诉用户先安装 openclaw：npm install -g openclaw@latest --registry=https://registry.npmmirror.com，然后重新从第 0 步开始 |

---

第 1 步：安装插件（根据路径分支）

路径 A：旧版本（≤ 2026.3.13）→ 先删旧插件，再装新插件，最后升级 openclaw

1a. 检测并删除旧版微信插件（1 次 exec）：

先检查是否已安装旧版微信插件，如果存在则必须先删除，否则新版插件安装会冲突：

CODEBLOCK1

如果输出中包含 weixin 相关插件，则执行卸载：

CODEBLOCK2

如果未检测到旧插件，跳过卸载直接进入 1b。

1b. 安装最新版微信插件（1 次 exec）：

CODEBLOCK3

1c. 升级 openclaw 到最新版（1 次 exec）：

CODEBLOCK4

升级完成后告知用户："旧插件已清理，新插件已安装，openclaw 已更新到最新版。"

路径 B：较新版本（> 2026.3.13）→ 先升级插件，再更新 openclaw

1a. 先安装/升级微信插件（1 次 exec）：

CODEBLOCK5

1b. 再升级 openclaw 到最新版（1 次 exec）：

CODEBLOCK6

升级完成后告知用户："插件已安装，openclaw 已更新到最新版。"

---

两条路径安装完成后，输出包含 success 或 installed 关键词则继续；否则告知用户安装失败，需人工排查。

第 2 步：获取二维码（1 次 exec）

CODEBLOCK7

从返回 JSON 提取：

• - qrcode — 保存，轮询用
• INLINECODE15 — 这是一个 URL 字符串，下一步用 qrcode npm 库将它编码为 PNG 图片

第 3 步：生成 PNG 并保存到 workspace

二维码相关步骤需要快速完成（有效期约 1 分钟）。

CODEBLOCK8

CODEBLOCK9

保存到 workspace（必须执行）：

CODEBLOCK10

CDN 上传（可选，仅在用户无法打开本地文件时使用）：

⚠️ 注意：CDN 上传会将一次性授权二维码暴露到外部网络。仅在用户明确表示无法打开本地文件、或处于纯远程 chat 环境时才使用。

CODEBLOCK11

CDN 上传失败不阻塞流程，直接用 workspace 本地文件。

第 4 步：展示二维码，等用户扫码

默认展示方式（本地文件优先）：

---

微信扫码登录

二维码已生成并保存到 ~/workspace/weixin_qr.png，请打开文件后用微信扫码。

操作步骤：

1. 1. 打开 ~/workspace/weixin_qr.png 文件
2. 用手机微信 App 扫一扫
3. 在手机上确认登录
4. 扫完告诉我"ok"，我会继续后续步骤

⏱ 有效期：约 1 分钟，如果过期了告诉我"过期了"，我会立即生成新的二维码。

如果打开本地文件不方便，告诉我，我可以通过 CDN 上传后提供在线链接（注意：二维码会短暂暴露到外部网络）。

---

如果用户要求 CDN 链接（已通过 uploadtocdn 上传成功）：

---

微信扫码登录

用微信扫一扫下面的二维码：

（本地备份：~/workspace/weixin_qr.png）

扫完告诉我"ok"，我会继续后续步骤。

⏱ 有效期：约 1 分钟，如果过期了告诉我"过期了"，我会立即生成新的二维码。

---

然后停下来，等用户确认。

第 5 步：用户确认后 → 轮询 + 写凭证 + 重启

5a. 轮询状态（必须加 --max-time 10，此 API 是长轮询）：

CODEBLOCK12

status	处理
超时（exit code 28）或 INLINECODE20	等 3 秒再 poll
INLINECODE21

告诉用户"已扫码，请在手机上确认登录" |
| confirmed | 成功！提取 ilink_bot_id、bot_token、baseurl、ilink_user_id |
| expired | 从第 2 步重来（不需要重新装插件） |

5b. 展示凭证并等待用户确认（confirmed 后必须执行）：

将 ilink_bot_id 中的 @ → -、. → - 得到 accountId（例：a34b410e2e6f@im.bot → a34b410e2e6f-im-bot）。

⚠️ API 返回的 bot_token 已包含 ilink_bot_id: 前缀，直接用 bot_token 的值作为 token，不要再拼接 ilink_bot_id:，否则 token 双重前缀、认证失败（errcode -14）。

先向用户展示即将写入的凭证信息，等待确认：

---

即将写入以下凭证

字段	值
accountId	INLINECODE40
token

<bot_token 前 8 位>****（已脱敏） |
| baseUrl | <baseurl> |
| userId | <ilink_user_id> |

写入位置：INLINECODE44

确认写入请回复"ok"，如有疑问请告诉我。

---

用户确认后，执行写入：

CODEBLOCK13

⚠️ <accountId>、<bot_token>、<baseurl>、<ilink_user_id> 是占位符，写入脚本时必须替换为 5a 步 confirmed 返回的真实值。

5c. 重启 Gateway：

CODEBLOCK14

成功回复

---

微信连接结果

• - ✅ 状态：已绑定成功
• ✅ Gateway：已重启
• ilinkbotid: INLINECODE49
• ilinkuserid: INLINECODE50

现在可以直接在微信里发消息了 🎉

---

到此为止。不要再做任何额外操作。不要读文档。

二维码过期处理

用户说"过期了" → 只需从第 2 步重新获取二维码，不需要重新执行第 0、1 步。

绝对禁止

• - ❌ 禁止用 curl -o / curl --output / wget 下载 qrcode_img_content URL — 这个 URL 指向的是 HTML 网页不是 PNG 图片，下载得到的是一堆 HTML 代码。必须用 qrcode npm 库的 toFile() 将 URL 字符串编码为 PNG
• ❌ 禁止用 canvas、browser、Generate Images、Image Understanding、MEDIA: 语法、终端字符渲染等方式展示二维码
• ❌ 禁止自动开轮询（等用户说"扫完了 / ok"）
• ❌ 禁止手动改写 INLINECODE57
• ❌ 禁止跳过写凭证步骤（不写凭证插件无法连接）
• ❌ 禁止给用户 qrcode_img_content 原始 URL
• ❌ 禁止使用第三方上传服务（0x0.st、catbox、imgbb 等），CDN 仅限 INLINECODE59
• ❌ 禁止在 token 前拼接 ilink_bot_id:（bot_token 已包含前缀）
• ❌ 禁止在 PNG 生成成功后再用 curl 下载覆盖文件
• ❌ 禁止跳过第 0 步版本检测直接进第 1 步
• ❌ 禁止跳过凭证展示确认步骤直接写入磁盘

一句话总结

检测版本（第 0 步）→ 先删旧插件（如有）再装新插件再更新 openclaw（第 1 步）→ curl 拿二维码（第 2 步）→ npm install qrcode + 生成 PNG → 保存到 workspace（+ 可选 CDN 上传）（第 3 步）→ 展示二维码等用户扫（第 4 步）→ 轮询确认 → 展示凭证等用户确认 → 写凭证 → 重启 gateway（第 5 步）→ 完成。