个人微信 Connect Skill

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

本 skill 仅适用于个人微信，以下关键词触发：
- "连接个人微信" / "接入个人微信" / "绑定个人微信"
- "个人微信扫码" / "微信扫码登录"
- "连接微信"（未带"企业"二字时，默认为个人微信）

以下关键词不属于本 skill，禁止触发：
- "企业微信" / "企微" / "wecom" / "WeCom" → 使用 wecom-connect skill

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

核心原则

• 严格按步骤走，不要加戏，不要自作聪明加额外命令。
• 速度优先！ 二维码有效期仅约 1 分钟，把能合并的命令用 && 链起来一次执行，禁止拆成多个单独的 exec 调用。
• qrcode_img_content 是一个 URL 字符串，必须用 qrcode npm 库把它编码成 PNG 图片。 这个 URL 指向的是网页不是图片，绝对禁止用 curl -o 直接下载。
• 图片展示只能用 upload_to_cdn 返回的 CDN URL。 CDN 失败则引导用户打开 workspace 文件。禁止使用任何其他展示方式。
• 不要自动轮询。 给完二维码等用户说"扫完了"再轮询。
• 不要手动改写 openclaw.json。

执行流程

第 1 步：安装 legacy 版本插件（1 次 exec）

直接安装兼容的 legacy 版本，不需要做版本检查：

cd /tmp && npm pack @tencent-weixin/openclaw-weixin@legacy 2>&1 | tail -1 && rm -rf ~/.openclaw/extensions/openclaw-weixin && mkdir -p ~/.openclaw/extensions/openclaw-weixin && tar -xzf /tmp/tencent-weixin-openclaw-weixin-*.tgz -C ~/.openclaw/extensions/openclaw-weixin --strip-components=1 && cd ~/.openclaw/extensions/openclaw-weixin && npm install --production 2>&1 | tail -3 && (ln -sf "$(npm root -g)/openclaw" node_modules/openclaw 2>/dev/null || ln -sf "$(dirname "$(which openclaw)")/../lib/node_modules/openclaw" node_modules/openclaw) && ls node_modules/openclaw/package.json >/dev/null 2>&1 && echo "READY" || echo "FAILED"

• READY → 继续第 2 步
• FAILED → 告诉用户安装失败，需要人工排查

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

curl -s "https://ilinkai.weixin.qq.com/ilink/bot/get_bot_qrcode?bot_type=3"

从返回 JSON 提取：
- qrcode — 保存，轮询用
- qrcode_img_content — 这是一个 URL 字符串，下一步用 qrcode npm 库将它编码为 PNG 图片

第 3 步：生成 PNG → upload_to_cdn + workspace 双保险

一气呵成。

cd /tmp && npm install qrcode 2>/dev/null | tail -1

cd /tmp && node -e "const qr=require('qrcode'); qr.toFile('/tmp/weixin_qr.png','<qrcode_img_content>',{width:400,margin:2},(e)=>{if(e)console.error(e);else console.log('saved');})"

同时做两件事：

1. upload_to_cdn：

upload_to_cdn /tmp/weixin_qr.png

2. 保存 workspace 备份（无论 CDN 是否成功）：

cp /tmp/weixin_qr.png ~/workspace/weixin_qr.png

CDN 结果处理：
- 成功 → 第 4 步用 CDN URL 展示
- 失败 → 重试 upload_to_cdn，最多 3 次
- 3 次仍失败 → 用 workspace 备份兜底

禁止任何替代上传方案（0x0.st、catbox、imgbb、base64、canvas、openclaw upload 等全部禁止）。

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

CDN 成功时（推荐引导语）：

微信扫码登录

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

<CDN 图片 URL>

（已保存备用图片至 ~/workspace/weixin_qr.png）

操作步骤：
1. 打开手机微信 App
2. 扫一扫上面的二维码
3. 在手机上确认登录
4. 扫完告诉我"ok"，我会继续后续步骤

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

CDN 失败（workspace 兜底时）：

微信扫码登录

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

扫完在手机上确认登录，然后告诉我"ok"。

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

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

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

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

curl -s --max-time 10 "https://ilinkai.weixin.qq.com/ilink/bot/get_qrcode_status?qrcode=<qrcode>"

5b. 写入凭证（confirmed 后必须执行）：

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

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

将真实值内联写入 JS 脚本并执行（cat 和 node 写在同一个 exec 里）：

cat > /tmp/write_weixin_account.js << 'SCRIPT'
const fs = require('fs');
const path = require('path');
const home = process.env.HOME;

const accountId = '<accountId>';
const data = {
  token: '<bot_token>',
  savedAt: new Date().toISOString(),
  baseUrl: '<baseurl>',
  userId: '<ilink_user_id>'
};

const accountsDir = path.join(home, '.openclaw/openclaw-weixin/accounts');
fs.mkdirSync(accountsDir, { recursive: true });

const accountFile = path.join(accountsDir, accountId + '.json');
fs.writeFileSync(accountFile, JSON.stringify(data, null, 2));
fs.chmodSync(accountFile, 0o600);

const indexPath = path.join(home, '.openclaw/openclaw-weixin/accounts.json');
let existing = [];
try { existing = JSON.parse(fs.readFileSync(indexPath, 'utf-8')); } catch {}
if (!existing.includes(accountId)) existing.push(accountId);
fs.writeFileSync(indexPath, JSON.stringify(existing, null, 2));

console.log('凭证 + 索引写入成功');
SCRIPT
node /tmp/write_weixin_account.js

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

5c. 重启 Gateway：

openclaw gateway restart

成功回复

微信连接结果

• 状态：已绑定成功
• Gateway：已重启
• ilink_bot_id: <ilink_bot_id>
• ilink_user_id: <ilink_user_id>

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

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

二维码过期处理

用户说"过期了" → 只需从第 2 步重新获取二维码，不需要重新执行第 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: 语法 等方式展示二维码 — 只能用 upload_to_cdn 返回的 CDN URL，或引导用户打开 workspace 文件
• 禁止把能合并的命令拆成多次 exec（二维码有效期只有 1 分钟，拆太碎会过期）
• 禁止自动开轮询（等用户说"扫完了 / ok"）
• 禁止手动改写 openclaw.json
• 禁止跳过写凭证步骤（不写凭证插件无法连接）
• 禁止给用户 qrcode_img_content 原始 URL
• 禁止使用替代上传方案（0x0.st、catbox、imgbb、base64 等）
• 禁止在 token 前拼接 ilink_bot_id:（bot_token 已包含前缀）
• 禁止在 PNG 生成成功后再用 curl 下载覆盖文件

一句话总结

安装 legacy 插件（1 次 exec）→ curl 拿二维码（1 次 exec）→ npm install qrcode + 生成 PNG → upload_to_cdn + workspace 备份 → 展示二维码等用户扫 → 轮询确认 → 写凭证+执行（1 次 exec）→ 重启 gateway → 完成。