openClaw 对接个人微信教程：openclaw-wechat 配置与验证

1. 为什么要在本地把 openClaw 接到个人微信openClaw 是一个可以本地部署的 AI 网关它把「消息通道」和「模型能力」拆成两层通道负责收发微信消息模型层负责生成回复。openclaw-wechat 就是它的微信通道插件作用是让你的个人微信号变成一个能自动回复、能跑技能Skill的 AI 助手。适合谁想在本地跑通消息收发、又不想把聊天记录交给第三方云端的开发者想拿微信当 Agent 入口做实验的人以及需要 7×24 小时在线客服原型的小团队。我这次的目标很明确本地起 openClaw通过 openclaw-wechat 接入个人微信用 TaoToken 统一 Key 和 API 通道最后在微信里发一条消息验证连通。整条链路里最容易卡住的不是模型而是通道配置——config.toml 里少一个字段、插件没进 allow 列表、网关没重启都会表现为「消息发出去没反应」。下面按可复制的顺序走一遍每一步都给命令和预期结果。先说清楚两个概念避免后面混淆。openClaw 的「网关gateway」是常驻进程负责调度通道和模型「通道channel」是具体某个 IM 的适配器openclaw-wechat 就是微信通道。模型请求走 OpenAI 兼容协议所以只要有一个兼容的 base_url 和 key就能接任意模型。TaoToken 在这里的角色就是提供这个统一的 Key 和 API 通道省去你分别去各家申请、分别改配置的麻烦。2. 前置准备openClaw 安装与 TaoToken Key2.1 安装 openClaw 并确认版本openClaw 通过 npm 分发Node 建议 20 LTS 以上。先装再验版本版本太低会缺通道能力。# 全局安装 npm install -g openclawlatest # 确认版本建议 0.5.0 openclaw --version # 启动网关 openclaw gateway start # 查看状态 openclaw gateway statusgateway status正常会输出 running 和监听端口。如果显示 not running先看日志再继续别急着配通道。2.2 拿到 TaoToken 的 Key 与 API 地址模型层要一个 OpenAI 兼容的入口。打开 TaoToken 控制台创建 API Key地址是 https://taotoken.net/api Key 只在创建时完整显示一次复制后存到本地环境变量或.env不要写进会提交到 git 的文件。# 写入本地环境文件后续配置引用 cat ~/.openclaw/.env EOF TAOTOKEN_API_KEYsk-你的Key TAOTOKEN_BASE_URLhttps://taotoken.net/api EOF这里 base_url 用https://taotoken.net/api不要多加/v1openClaw 的 OpenAI 兼容客户端会自己拼路径。Key 的权限建议只开模型调用别开无关的管理权限。2.3 微信侧的准备个人微信要能扫码登录手机端保持在线。openclaw-wechat 走的是扫码配对所以你需要一台能显示二维码的终端。iOS 和 Android 都建议更新到较新版本老版本协议差异会导致扫码后无法建立会话。3. 可复制配置config.toml 骨架与 openclaw-wechat 通道openClaw 支持openclaw.json和config.toml两种配置。这篇用config.toml因为注释友好、层级清晰。文件默认在~/.openclaw/config.toml没有就新建。3.1 完整 config.toml 骨架# ~/.openclaw/config.toml [gateway] host 127.0.0.1 port 8787 # 模型层统一走 TaoToken 的 OpenAI 兼容通道 [models.default] provider openai-compatible base_url https://taotoken.net/api api_key ${TAOTOKEN_API_KEY} model gpt-4o-mini # 微信通道openclaw-wechat [channels.wechat] enabled true plugin openclaw-wechat [channels.wechat.accounts.default] # 扫码登录后由插件回填先留空 session_file ~/.openclaw/wechat-session.json auto_reply true # 插件白名单必须包含 openclaw-wechat [plugins] allow [openclaw-wechat] [plugins.entries.openclaw-wechat] enabled true几个关键点。base_url和api_key是模型层决定 AI 能不能回话channels.wechat是通道层决定消息能不能进来出去plugins.allow是白名单openclaw-wechat 不在里面通道即使 enabled 也不会加载。这三处任何一处错现象都是「没反应」所以配完要逐项核对。3.2 安装 openclaw-wechat 插件插件通过 openClaw 的插件机制安装装完再重启网关让它加载。# 安装微信通道插件 openclaw plugins install openclaw-wechat # 确认已安装 openclaw plugins list # 重启网关加载插件 openclaw gateway restartplugins list里应能看到 openclaw-wechat 且状态为 enabled。如果显示 installed 但没 enabled回到 config.toml 检查plugins.entries那段。3.3 扫码登录个人微信通道加载后触发扫码登录。这一步会在终端打印二维码用手机微信扫。openclaw channels login --channel wechat扫码成功后插件会把会话写入session_file指定的路径。终端会提示 login success此时~/.openclaw/wechat-session.json应该存在。如果二维码没出来先确认网关在跑、插件已 enabled再重试登录命令。4. 验证请求发消息确认连通配置对不对发一条消息就知道。分两步验证先验模型层再验通道层这样出问题能定位到是哪一层。4.1 先验模型层不经过微信直接让 openClaw 调一次模型确认 TaoToken 通道通。openclaw models test --model default --prompt 只回复pong预期输出包含pong。如果报 401是 Key 问题报 404多半是 base_url 拼错报超时检查网络到taotoken.net是否可达。这一步过了说明模型层没问题后面微信不回话就只可能是通道层。4.2 再验通道层保持网关运行用手机微信给「文件传输助手」或自己的另一个号发一条消息内容随意比如「你好」。openClaw 收到后会走模型生成回复。# 实时看日志确认消息进出 openclaw gateway logs --follow日志里应能看到类似wechat message received和model response sent两条。手机端几秒内收到 AI 回复就说明整条链路通了。如果只看到 received 没有 sent是模型层的问题如果连 received 都没有是通道层没接上。4.3 用 TaoToken 模型对话做交叉验证想单独确认 TaoToken 通道本身是否正常可以打开模型对话页面直接发一条和 openClaw 里的表现对照。如果对话页面正常、openClaw 不正常问题在 openClaw 配置如果两边都不正常问题在 Key 或额度。5. 本篇常见错排查5.1 扫码后无法登录 / 二维码不出现先确认网关在运行openclaw gateway status。再确认插件已加载openclaw plugins list里 openclaw-wechat 为 enabled。最后确认 config.toml 的plugins.allow包含 openclaw-wechat。三者都正常还不行删掉旧的wechat-session.json重新登录残留会话有时会卡住新登录。5.2 消息发出去没有 AI 回复按层排查。看日志有没有wechat message received没有就是通道层回去查channels.wechat.enabled和插件白名单有 received 但没有 response就是模型层跑一次openclaw models test定位。模型层报错优先看 Key 是否过期、base_url 是否为https://taotoken.net/api。5.3 配置改了不生效openClaw 不会热加载 config.toml改完必须重启网关。openclaw gateway restart openclaw gateway status只 stop 不 start 会导致网关不在跑现象和配置错一样。养成改完就 restart 再 status 的习惯。5.4 日志里出现插件加载失败多半是插件版本和 openClaw 版本不匹配。先升级 openClaw 到最新再重装插件npm install -g openclawlatest openclaw plugins install openclaw-wechat openclaw gateway restart5.5 想长期跑编码类 Agent如果你不只是想让微信回消息而是想把 openClaw 当长期编码或 Agent 入口模型调用量会明显上升建议单独规划额度与 Key 管理避免和实验用的 Key 混在一起。Coding Plan 更适合这种持续调用的场景配置方式仍是同一套 OpenAI 兼容通道只是 Key 和额度分开管理。6. 把 Key 和通道固定下来跑通之后最容易出问题的是 Key 散落在多个文件里。我的做法是所有模型调用只认TAOTOKEN_API_KEY这一个环境变量config.toml 里用${TAOTOKEN_API_KEY}引用不写明文。这样换 Key 只改一处也不会误提交。通道侧同理session_file固定路径重装或迁移时直接带走这个文件就能免扫码。接入文档里有 OpenAI 兼容通道的完整参数说明配其他模型时对照着改models.default即可。API Keys 页面负责创建和吊销 Key建议给 openClaw 单独建一个 Key出问题能单独吊销而不影响其他服务。验证模型是否正常用模型对话最快长期编码或 Agent 场景再考虑 Coding Plan。整条链路的核心就三件事Key 对、base_url 对、插件在白名单里其余都是重启和看日志能解决的。