处理微信个人号接入 OpenClaw 的官方登录流程与排障。用于安装 `@tencent-weixin/openclaw-weixin`、获取新的二维码授权链接、查询扫码状态、修复 `openclaw-weixin` 卡在 `SETUP / no token`、以及整理微信 8.0.70+ 接入 OpenClaw 的说明文档。
这个 skill 用来安装、排查、记录微信个人号接入 OpenClaw 的官方登录流程。
npx -y @tencent-weixin/openclaw-weixin-cli installconfirmed 或 bot_token。openclaw status 检查渠道状态。SETUP / no token,检查本地状态文件 ~/.openclaw/openclaw-weixin/。优先使用本 skill 自带脚本:
scripts/get-login-url.jsscripts/poll-login-status.py <qrcode>如果只需要快速人工操作,可继续使用下面的命令版步骤。
插件源码表明,登录本质上是调用腾讯 ilink 接口并拿到一个真实的二维码页面 URL。
优先命令:
node scripts/get-login-url.js
脚本会打印:
qrcode_img_content:真正应该在浏览器打开的二维码页面链接QRCODE=...:用于查询扫码状态的 token如果不想用脚本,也可以直接执行:
node - <<'NODE'
const url='https://ilinkai.weixin.qq.com/ilink/bot/get_bot_qrcode?bot_type=3';
fetch(url)
.then(r=>r.json())
.then(j=>{
console.log(j.qrcode_img_content || '');
console.log('QRCODE=' + j.qrcode);
});
NODE
相比转发终端字符二维码,这种方式通常更稳。
推荐脚本:
python3 scripts/poll-login-status.py <qrcode>
例如:
python3 scripts/poll-login-status.py 1cf42ee545e62408992daa64b38a37d9
如果只想单次查询,也可以用命令方式:
python3 - <<'PY'
import urllib.request, json
qrcode = 'REPLACE_ME'
url = f'https://ilinkai.weixin.qq.com/ilink/bot/get_qrcode_status?qrcode={qrcode}'
req = urllib.request.Request(url, headers={'iLink-App-ClientVersion':'1'})
with urllib.request.urlopen(req, timeout=40) as r:
print(json.loads(r.read().decode()))
PY
常见状态:
wait:还没扫码scaned:已经扫码,但还没最终确认confirmed:已确认登录bot_token、ilink_bot_id、baseurl、ilink_user_id只要出现 bot_token,就可以认定腾讯侧登录已经成功,即使 OpenClaw 本地状态还没立刻刷新。
检查这些路径:
~/.openclaw/openclaw-weixin/accounts.json~/.openclaw/openclaw-weixin/accounts/<account-id>.json*.sync.json一个正常的账号文件通常长这样:
{
"token": "<bot_token>",
"savedAt": "<timestamp>",
"baseUrl": "https://ilinkai.weixin.qq.com"
}
账号 id 一般会把 @ 和 . 规范化成 -,例如:
[email protected]4b22f436d38f-im-bot执行:
openclaw status
成功时通常表现为:
openclaw-weixinOKno token失败时通常表现为:
SETUPno tokenno tokenbot_token。~/.openclaw/openclaw-weixin/ 下对应文件是否已写入。openclaw gateway restartopenclaw status 确认状态。如果需要更底层的实现说明,读取 references/implementation-notes.md。