龙虾接入微信的原理、方法和常见问题

1 接入微信微信现在已经支持个人机器人通过正规渠道接入了。这次开放的不只是 OpenClaw 的接入能力更准确地说微信把一套机器人接入协议放出来了。有人拿它接 OpenClaw也有人拿它接 Claude Code。只要按这套协议来理论上别的机器人也能接进去包括自己写的。这和以前只能走企业微信、公众号后台或者自己想办法绕路已经不是一个量级。微信当然也加了不少限制比如机器人不能加群一个账号只能接一个机器人机器人目前只能收文件、不能给用户发文件至少我现在测到的版本是这样。这也正常毕竟这里碰到的是聊天、隐私和交易这些高权限场景不可能一开始就完全放开。但趋势已经很清楚了。后面机器人只会越来越多平台迟早都得支持这件事。谁开放得早谁就更容易先占住生态位。1.1 原理接口跑在https://ilinkai.weixin.qq.com。微信官方提供了tencent-weixin/openclaw-weixin插件npm 包里就是完整的 TypeScript 源码。原理不复杂基本就是三步认证先调ilink/bot/get_bot_qrcode拿二维码用户扫码后再通过ilink/bot/get_qrcode_status长轮询拿认证结果里面会带bot_token收消息调ilink/bot/getupdates做 HTTP 长轮询。有新消息就返回没有就挂起等待。每条消息都会带context_token发消息调ilink/bot/sendmessage带上bot_token和context_token消息就能回到微信里按这套逻辑写一个 service本质上就是在自己这边实现一个微信机器人。想自己接不一定非得依赖官方插件参考文末的开源项目也能走通。详见参考21.2 具体方法实际接入分两部分手机端我 - 设置 - 插件 - 微信 ClawBot电脑端给 OpenClaw 装openclaw-weixin插件插件地址https://npmx.dev/package/tencent-weixin/openclaw-weixindockerexec-itopenclaw-openclaw-gateway-1bashopenclaw pluginsinstalltencent-weixin/openclaw-weixinopenclaw configsetplugins.entries.openclaw-weixin.enabledtrueopenclaw channels login--channelopenclaw-weixin# 此时用微信扫码即可装完后会自动重启 Docker。扫码成功后就可以直接在微信里和龙虾对话了。如果提示 ClawHub 连不上一般走代理就能解决。插件和配置都保存在宿主机的$HOME/.openclaw目录里所以 Docker 重启后也还在。1.3 使用注意事项目前 iOS 和 Android 都已支持先把微信升到最新版本我 - 设置 - 关于微信 - 版本更新再确认插件入口已经出现我 - 设置 - 插件电脑端插件装好后再扫码登录1.4 现在的问题我现在用的版本里用户可以给机器人传文件但机器人还不能把文件回传给用户估计是出于安全考虑。1.5 一个延伸想法后面大概率会出现一层桥接服务一边连微信、飞书、Telegram、Discord 这些 client一边连 Claude Code、OpenClaw 这类 agent。它自己不一定负责智能主要做的事是把入口和机器人接起来变成一个稳定的 hub。2 常见问题2.1 流量税一个很常见的问题是为什么一天都没和小龙虾说话账单还是在涨我当时开了两个龙虾服务默认模型是copilot/gpt-5.4按 request 收费。粗算下来大概一小时会产生 2 个 request也就是0.04 x 2 x 24 1.92 美元。这样一只虾一天差不多就是 13 块人民币。写程序的人对这个数字会比较敏感因为 50 多个 gpt-5.4 的 request 已经够解决不少实际问题了。就算换成便宜一点的copilot/gpt-5.4-mini一天也要 4.5 元左右。我后来判断主要是心跳引起的。心跳的作用是让 AI 定期执行HEARTBEAT.md里的任务比如每日提醒、定时检查。如果暂时不需要这些能力把心跳关掉会省不少钱。做法是改$HOME/.openclaw/openclaw.json里的agents配置同时把默认模型换成便宜一点的版本例如agents:{defaults:{heartbeat:{every:0m},model:{primary:github-copilot/gpt-5.4-mini},models:{github-copilot/gpt-5.4-mini:{},github-copilot/gpt-5.4:{}},......我改完以后重启服务额外费用就基本没了。2.2 切换模型安装 OpenClaw 时会指定一个默认模型但因为价格和能力差别很大实际用的时候经常要来回切换。最稳的方式是直接在聊天界面里用内置命令model/model github-copilot/git-5.4-mini这种方式成功率最高。直接说“请切换到 xx 模型”有时候也能切但不一定稳定。2.3 重新加载技能如果在后台或者别的对话里装了 skill当前对话往往不会立刻生效这时需要重新加载。最简单的方法是直接开一个新会话/new这样通常就能把新装的 skill 带进来。3 参考微信官方接入龙虾我顺手给接上了 Claude Code。已开源https://mp.weixin.qq.com/s/FrSNOFwok8cenLksrkFG8w?poc_tokenHCL2wWmjlj3KTVteV2nYFpCim-elwRwFx6-teuWsclaude-code-wechat-channelhttps://github.com/Johnixr/claude-code-wechat-channel