1. 微信里多了一个「AI 联系人」:ClawBot 插件到底解决什么问题
微信 ClawBot 插件最近上线后,很多做本地 AI 部署的开发者第一反应是:终于不用再折腾内网穿透、反向代理那一套了。它的核心价值很直接——把运行在你电脑或服务器上的 OpenClaw(也就是大家常说的「龙虾」)变成一个微信联系人。你在微信里发消息,OpenClaw 收到后处理并回复,支持文本、图片、文件,单条消息长度限制在 4000 字符左右。
适合谁用?三类人最明显。第一类是本地部署了 OpenClaw、想在外面用手机随时调用的开发者;第二类是做内容创作、需要随手把灵感丢给 AI 处理的人;第三类是想把 AI 能力接进日常沟通流、但不想额外装 App 的人。目前 ClawBot 只支持私聊,不支持群聊,插件本身只作为消息通道,不会自动操作你的微信账号,数据留在本地或你自己的服务器上。
但真正落地时,卡点往往不在插件本身,而在「OpenClaw 的模型调用链路怎么统一管理」。如果你同时用多个模型供应商,Key 散落在各个配置文件里,换一个模型就要改一遍配置,非常痛苦。这篇就围绕「微信 ClawBot 插件接入 OpenClaw 三步走」这个场景,把 config.toml 和 settings.json 的骨架、TaoToken 统一 Key 的填写位置、以及三步接入后的连通性验证动作讲清楚,让你一次配好、长期省心。
2. 前置准备:TaoToken 统一 Key 与 OpenClaw 环境确认
在动微信之前,先把 OpenClaw 这一侧的环境理顺。核心思路是:让 OpenClaw 通过一个统一的 API 入口去调用模型,而不是在每个地方硬编码不同厂商的 Key。TaoToken 在这里扮演的就是这个统一入口的角色——你只需要一个 Key,就能在 OpenClaw 里切换不同模型。
先确认你的 OpenClaw 已经能正常运行。打开终端,执行:
openclaw --version如果能看到版本号,说明基础环境没问题。接着去 TaoToken 控制台创建一个 API Key。访问 https://taotoken.net/api-keys 登录后新建 Key,复制出来备用。注意这个 Key 只在创建时完整显示一次,建议先存到密码管理器里。
TaoToken 的 API 基础地址是:
https://taotoken.net/api这个地址后面会填到 OpenClaw 的配置里。如果你还没注册,可以先到 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 了解一下,注册后在控制台就能拿到 Key。
环境确认清单:
- OpenClaw 已安装且
openclaw --version有输出 - 微信已更新到 Android 8.0.70 以上(iOS 对应最新版)
- TaoToken API Key 已创建并保存
- 终端能正常访问外网 API 地址
这四步都 OK 之后,再进入配置环节。很多人跳过环境确认直接改配置,结果报错时不知道是网络问题还是配置问题,排查成本翻倍。
3. 三步接入:config.toml 与 settings.json 可复制骨架
3.1 第一步:配置 OpenClaw 的模型调用入口
OpenClaw 的主配置文件通常在~/.openclaw/config.toml(Windows 在%USERPROFILE%\.openclaw\config.toml)。用编辑器打开,找到[model]或[provider]段落,按下面的骨架填写:
# ~/.openclaw/config.toml [provider] name = "taotoken" base_url = "https://taotoken.net/api" api_key = "sk-你的TaoToken密钥" default_model = "claude-sonnet-4-20250514" [gateway] host = "127.0.0.1" port = 8765 enable_plugin = true [plugin.clawbot] enabled = true channel = "wechat" max_message_length = 4000几个关键点说明。base_url必须填https://taotoken.net/api,不要多加斜杠或路径。api_key填你刚才在控制台创建的 Key。default_model可以按需换成你常用的模型标识,TaoToken 支持多种模型,具体名称在控制台的模型列表里能看到。enable_plugin = true是打开插件通道的总开关,[plugin.clawbot]段落是 ClawBot 专属配置。
改完后保存,先别急着启动,继续第二步。
3.2 第二步:配置 ClawBot 插件的 settings.json
ClawBot 插件自己的配置文件在 OpenClaw 安装目录下的plugins/clawbot/settings.json。如果目录不存在,手动创建:
mkdir -p ~/.openclaw/plugins/clawbot然后写入以下骨架:
{ "plugin": "clawbot", "version": "1.0.0", "gateway_url": "http://127.0.0.1:8765", "auth": { "provider": "taotoken", "api_key_ref": "config.toml" }, "message": { "max_length": 4000, "support_types": ["text", "image", "file"], "private_only": true }, "logging": { "level": "info", "path": "~/.openclaw/logs/clawbot.log" } }这里gateway_url要和 config.toml 里的host和port对应上。api_key_ref指向 config.toml,意思是 Key 统一从主配置读取,避免两处维护。private_only: true对应目前只支持私聊的限制。support_types列出了文本、图片、文件三种消息类型。
3.3 第三步:重启网关并生成绑定二维码
配置写完后,先停掉正在运行的 OpenClaw:
openclaw gateway stop然后重新启动:
openclaw gateway start --plugin clawbot如果启动成功,终端会输出一段日志,并在最后生成一个二维码。用微信扫这个二维码完成绑定。绑定成功后,OpenClaw 会出现在你的微信聊天列表里,直接发消息就能对话。
三步到这里就完成了。但「配置完成」不等于「链路正常」,下一步必须做连通性验证。
4. 验证请求:确认调用链路真的通了
4.1 本地网关健康检查
先确认网关本身在跑:
curl -s http://127.0.0.1:8765/health正常返回类似:
{"status":"ok","plugin":"clawbot","provider":"taotoken"}如果返回connection refused,说明网关没起来,回去检查openclaw gateway start的日志。
4.2 直接测试模型调用
绕过微信,先直接测 TaoToken 的模型接口是否通:
curl -s https://taotoken.net/api/v1/chat/completions \ -H "Authorization: Bearer sk-你的TaoToken密钥" \ -H "Content-Type: application/json" \ -d '{ "model": "claude-sonnet-4-20250514", "messages": [{"role": "user", "content": "回复:链路正常"}] }'如果返回里有"content": "链路正常"之类的回复,说明 Key 和网络都没问题。这一步能排除掉大部分「以为是插件问题、其实是 Key 或网络问题」的情况。
4.3 微信侧端到端验证
打开微信,找到 OpenClaw 联系人,发一条简单消息,比如「你好,报一下当前模型」。观察回复。如果几秒内收到回复,说明整条链路——微信 → ClawBot 插件 → OpenClaw 网关 → TaoToken → 模型——全部打通。
再测一下边界情况:发一张图片,看是否被正确接收;发一条接近 4000 字符的长消息,确认没有被截断。这两项过了,日常使用基本没问题。
5. 本篇常见错排查:配置不生效、二维码扫不上、回复超时
5.1 改了 config.toml 但没生效
最常见的原因是改完没重启网关。OpenClaw 的配置是启动时加载的,热改不会自动生效。执行:
openclaw gateway stop && openclaw gateway start --plugin clawbot另外确认你改的是正确的配置文件路径。有些用户系统里有多个 OpenClaw 安装,改错了目录。用openclaw config path可以打印当前生效的配置路径。
5.2 二维码扫不上或绑定失败
先检查微信版本。Android 需要 8.0.70 以上,低于这个版本在「我」-「设置」-「插件」里可能看不到 ClawBot 卡片。更新后重启微信再试。
如果二维码显示但扫码无反应,检查网关的host是不是127.0.0.1。如果 OpenClaw 跑在服务器上,而你在另一台设备扫码,需要把host改成服务器内网 IP,并确保手机和服务器在同一网络,或者通过其他合规方式访问。
5.3 微信发消息后长时间无回复
按链路从后往前查。先看~/.openclaw/logs/clawbot.log有没有收到消息记录。如果有收到但没回复,问题在模型调用侧,回去跑 4.2 的直接测试。如果日志里连消息都没有,问题在插件到网关这一段,检查gateway_url和端口是否一致。
还有一种情况是消息超过 4000 字符被静默丢弃。ClawBot 目前对超长消息的处理是截断或拒绝,具体看版本。发长内容前先分段。
5.4 报 401 或鉴权失败
说明 Key 有问题。检查三点:Key 是否复制完整(有没有漏字符)、config.toml 里api_key有没有被引号包住、Key 是否在 TaoToken 控制台被禁用或删除。重新生成一个 Key 替换测试是最快的定位方式。
6. 配好之后:把统一 Key 用在更多场景
链路打通后,你会发现 TaoToken 统一 Key 的好处不只是省事。同一个 Key 可以同时给 OpenClaw、你的本地脚本、甚至其他支持自定义 API 地址的工具用。换模型时只改default_model一行,不用到处翻配置。
如果你主要在微信里做轻量对话和内容处理,现在的配置已经够用。如果你打算把 OpenClaw 接进更长的编码工作流或 Agent 任务,可以看看 Coding Plan 相关的接入方式,把模型调用和任务编排分开管理。需要查具体接口参数时,接入文档里有完整的字段说明。想先试试模型对话效果,也可以直接在模型对话页面里验证。
我自己的习惯是:每接一个新工具,先用 curl 把模型接口单独测通,再配插件。这样出问题时能立刻判断是「模型侧」还是「插件侧」,省掉大量来回试错的时间。