1. OpenClaw 微信对接前先把模型通道这件事想清楚OpenClaw龙虾助手本身是一个本地运行的智能体网关它负责把微信、企业微信这类消息通道收到的内容转成模型请求再返回结果。很多人卡住的地方不是微信扫码而是模型 API 这一层通道通了消息也进来了但模型请求 401、超时、或者返回体里读不到 choices最后表现就是“微信能收到消息机器人不回复”。这篇内容面向需要把 OpenClaw 接入微信/企业微信的开发者重点讲清楚三件事企业微信网关的配置片段怎么写、TaoToken 统一 Key 的 endpoint 与鉴权参数填在哪个字段、以及一条消息回环怎么验证收发链路真的通了。适合已经装好 OpenClaw、手里有企业微信机器人凭据、但还没把模型通道理顺的人。我试过把模型通道和消息通道分开排查效率会高很多。消息通道负责“消息进得来、回得去”模型通道负责“回的内容是模型生成的”。两者混在一起看日志很容易误判。所以下面会先讲模型通道的前置准备再讲企业微信网关配置最后用一条回环消息把两段链路串起来验证。OpenClaw 的版本建议不低于 v2026.3.1用openclaw --version确认。网关状态用openclaw gateway status看必须是 running。企业微信这边你需要先在管理后台创建一个智能机器人拿到 Bot ID 和 Secret连接方式选长连接WebSocket这样本地部署不需要公网 IP。模型通道这块OpenClaw 支持多种 provider。如果你希望一个 Key 同时覆盖对话、代码、Agent 场景可以用 TaoToken 的统一 Key。它的 API 地址是https://taotoken.net/api在 OpenClaw 的模型配置里Base URL 填这个API Key 填你申请到的 KeyModel ID 填你要用的模型名。注意 Base URL 不要带多余路径OpenClaw 会自己拼接/v1/chat/completions这类端点。这里有个容易忽略的点OpenClaw 的模型配置和通道配置是分开的两个文件区域。模型配置通常在~/.openclaw/openclaw.json的models或providers段通道配置在channels段。很多人把 API Key 填到了通道的 secret 字段里结果模型请求一直 401。企业微信的 Secret 是机器人密钥不是模型 Key这两个不能混。如果你还没拿到 TaoToken 的 Key可以去控制台创建一个。创建时注意权限范围如果你只是做对话验证选基础对话权限就够如果后面要跑 Coding Plan 或 Agent 任务再按需开对应权限。Key 创建后只显示一次记得保存好。模型通道确认可用的一个简单办法是先用命令行直接发一条请求不经过微信。比如用 curl 打 TaoToken 的 APIcurl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer 你的Key \ -H Content-Type: application/json \ -d { model: 你的ModelID, messages: [{role: user, content: 你好}] }如果返回体里有choices数组说明模型通道是通的。这一步过了再去配企业微信网关排障范围就小很多。如果这一步就报 401先检查 Key 有没有多余空格、Authorization 头格式对不对。如果报 model not found检查 Model ID 拼写。2. TaoToken 统一 Key 在 OpenClaw 里的前置配置与 endpoint 填写位置这一节把模型通道的配置写完整因为后面企业微信网关能不能回消息直接取决于这里。OpenClaw 的配置文件默认在~/.openclaw/openclaw.jsonWindows 下在C:\Users\你的用户名\.openclaw\openclaw.json。如果你用的是交互式向导openclaw models add会引导你填但手动改文件更直观也方便版本管理。先看模型 provider 的配置结构。OpenClaw 把模型提供方抽象成 provider每个 provider 有 baseUrl、apiKey、models 列表。TaoToken 作为统一入口baseUrl 填https://taotoken.net/apiapiKey 填你的 Key。下面是一个可复制的 JSON 片段路径与 OpenClaw 默认配置一致{ providers: { taotoken: { type: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoTokenKey, models: [ { id: claude-sonnet-4-5, name: Claude Sonnet 4.5, contextWindow: 200000 }, { id: gpt-4.1, name: GPT-4.1, contextWindow: 128000 } ] } }, defaultModel: taotoken/claude-sonnet-4-5 }这里有几个参数要解释清楚。type填openai-compatible因为 TaoToken 的 API 兼容 OpenAI 的请求格式OpenClaw 会用这套适配器去发请求。baseUrl只写到/api不要写成/api/v1否则 OpenClaw 拼出来的路径会变成/api/v1/v1/chat/completions直接 404。apiKey就是你在控制台创建的 Key注意不要泄露到公开仓库。models数组里每个模型的id是发给 API 的模型标识name是显示名contextWindow用于 OpenClaw 判断上下文长度。如果你不确定某个模型 ID 怎么写可以先在模型对话页面里试一下确认能正常返回再填进配置。defaultModel用provider/modelId的格式这样 OpenClaw 知道默认走哪个 provider。如果你用的是 TOML 风格的配置部分 OpenClaw 版本支持等价写法是这样[providers.taotoken] type openai-compatible baseUrl https://taotoken.net/api apiKey sk-你的TaoTokenKey defaultModel claude-sonnet-4-5 [[providers.taotoken.models]] id claude-sonnet-4-5 name Claude Sonnet 4.5 contextWindow 200000改完配置后不要急着重启网关先用openclaw models list看 provider 有没有被正确加载。如果列表里能看到 taotoken 和它的模型说明配置语法没问题。然后用openclaw models test taotoken/claude-sonnet-4-5发一条测试请求确认鉴权和 endpoint 都对。这一步常见的坑是 Key 权限不足。有些 Key 只开了特定模型的权限你填了另一个模型 ID请求会返回 403 或 model not found。遇到这种情况去控制台确认 Key 的权限范围或者换一个已授权的模型 ID。另一个坑是网络层如果你的机器需要走内网 DNS 才能解析外部域名taotoken.net可能解析失败表现为连接超时。用curl -v https://taotoken.net/api看握手过程能快速定位是 DNS 还是 TLS 问题。模型通道确认可用后再进入企业微信网关配置。这样如果后面微信不回消息你可以先看openclaw gateway logs -f里模型请求有没有发出、返回是什么而不是盲目怀疑微信通道。3. 企业微信网关配置片段Bot ID、Secret 与 WebSocket 长连接企业微信机器人是团队场景里比较稳的通道支持群聊、回复、文件传输而且用长连接模式不需要公网 IP。这一节给出可复制的配置片段并说明每个字段填什么。前置动作是在企业微信管理后台创建智能机器人连接方式选长连接拿到 Bot ID 和 Secret。创建路径是企业微信客户端 → 工作台 → 智能机器人 → 创建机器人 → 选择 API 模式 → 连接方式选长连接。填完名称、简介、可见范围后复制 Bot ID 和 Secret。注意 Secret 只在创建时显示一次丢了要重新生成。拿到凭据后编辑~/.openclaw/openclaw.json在channels段加入 wecom 配置。下面这个片段可以直接复制把 botId 和 secret 替换成你的值{ channels: { wecom: { enabled: true, botId: 你的BotID, secret: 你的Secret, connectionMode: websocket, dmPolicy: pairing, groupPolicy: mention, model: taotoken/claude-sonnet-4-5 } } }逐字段说明。enabled设为 true 才会加载这个通道。botId和secret是企业微信后台给的不要和模型 Key 混。connectionMode填websocket这是长连接模式本地部署首选如果你有公网回调地址也可以填callback但配置更复杂。dmPolicy控制私聊策略pairing表示需要配对后才能对话适合内部使用如果你想放开可以改成open但要注意权限。groupPolicy填mention表示群里只有 机器人 才回复改成all则所有消息都触发。model字段指定这个通道用哪个模型。这里填taotoken/claude-sonnet-4-5对应上一节配置的 provider。如果你有多个通道每个通道可以指定不同模型比如企业微信用强模型个人微信测试用轻量模型。这个字段不填的话会走defaultModel。如果你更习惯用命令行配置等价命令是openclaw channels add # 选择 WeCom # 粘贴 Bot ID # 粘贴 Secret # 连接方式选 WebSocket交互式向导会帮你写入配置文件但不会自动填model字段需要你手动补。补完后用openclaw channels list确认 wecom 通道已启用。配置写完后重启网关openclaw gateway restart重启后看日志openclaw gateway logs -f正常的话日志里会出现类似wecom channel connected或websocket handshake success的行。如果出现invalid botId or secret说明凭据填错了回后台重新复制。如果出现connection timeout检查你的网络能不能访问企业微信的长连接服务有些内网环境会拦 WebSocket。这里有个细节企业微信的长连接和模型请求是两条独立的网络链路。长连接断了消息进不来模型请求失败消息进来了但回不去。日志里要分别看。wecom channel connected只代表消息通道通了不代表模型通道通。所以下一步必须做一条完整的回环验证。4. 一条消息回环验证从企业微信发消息到模型返回配置写完、网关重启后不要只看日志说 connected 就结束。真正要验证的是“发一条消息能收到模型生成的回复”。这一节给出完整的验证动作和预期结果。第一步在企业微信里找到你创建的机器人发一条测试消息你好用一句话介绍你的能力第二步同时观察网关日志。你应该能看到类似这样的输出[wecom] received message from user: xxx [model] request to taotoken/claude-sonnet-4-5 [model] response received, tokens: 42 [wecom] reply sent to user: xxx这四行分别对应消息通道收到消息、模型通道发出请求、模型通道收到响应、消息通道发出回复。如果只有第一行没有第二行说明通道到模型的转发有问题检查model字段有没有填对。如果有第二行没有第三行说明模型请求失败看日志里的错误码。第三步确认企业微信里收到了回复。如果回复内容正常说明整条链路通了。如果回复是空的或者报错文案看日志里的模型返回体。如果日志里出现401 Unauthorized说明 TaoToken 的 Key 有问题。检查配置文件里apiKey有没有多余空格Key 有没有过期权限范围是否包含你填的模型。如果出现local proxy failed或connection refused说明 OpenClaw 到taotoken.net的网络不通用 curl 单独测一下。如果出现reading choices: unexpected end of JSON说明返回体不是预期的 OpenAI 格式可能是 baseUrl 写错了检查是不是多写了/v1。如果日志里出现OAuth相关报错比如oauth token expired这通常不是 TaoToken 的问题而是企业微信侧的凭据刷新失败。重新生成 Secret 并更新配置即可。回环验证通过后你可以再测一条群聊消息。把机器人拉进一个测试群它发消息确认groupPolicy: mention生效。如果群里没 也回复了检查groupPolicy是不是被改成了all。这一步的验证动作看起来简单但它把消息通道、模型通道、鉴权、网络四件事一次性串起来了。任何一环有问题都会在这条回环里暴露。所以每次改完配置都建议重跑一遍这个验证而不是只看channels list的状态。5. 本篇常见报错排查401、local proxy failed、reading choices、OAuth这一节把对接过程中最容易遇到的几类报错集中列出来给出定位方法和修复动作。这些报错在日志里的原文和含义以及对应的配置检查点都写清楚方便你对照。第一类401 Unauthorized。日志原文通常是model request failed: 401。原因几乎都是模型 Key 不对。检查三处配置文件里apiKey的值有没有复制错、有没有多余空格、Key 是否已过期或被禁用。如果你用的是环境变量注入 Key检查环境变量名和配置文件里引用的名字是否一致。修复后重启网关再测。第二类local proxy failed或connection refused。这表示 OpenClaw 发模型请求时连不上目标地址。先确认baseUrl是https://taotoken.net/api没有多余路径。然后用 curl 在同一个机器上测curl -v https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer 你的Key \ -H Content-Type: application/json \ -d {model:你的ModelID,messages:[{role:user,content:ping}]}如果 curl 也连不上说明是网络层问题检查 DNS、防火墙、是否需要内网代理。如果 curl 能通但 OpenClaw 不通检查 OpenClaw 有没有自己的网络配置比如是否走了不同的 DNS 或代理设置。第三类reading choices: unexpected end of JSON或cannot read property choices。这表示模型返回体不是预期的 OpenAI 格式。最常见原因是baseUrl写成了https://taotoken.net/api/v1导致实际请求路径变成/api/v1/v1/chat/completions返回 404 的 HTML 而不是 JSON。把baseUrl改回https://taotoken.net/api即可。另一个原因是模型 ID 不存在API 返回了错误结构检查models数组里的id拼写。第四类OAuth相关报错比如oauth token invalid或refresh token failed。这类报错通常出现在企业微信通道不是模型通道。原因是企业微信的 Secret 失效或机器人被删除。回企业微信后台确认机器人还在重新生成 Secret更新配置文件里的secret字段重启网关。第五类消息通道显示 connected 但发消息没反应。先看日志有没有received message。如果没有说明消息根本没进来检查企业微信机器人的可见范围是否包含你、长连接是否真的建立。如果有received message但没有model request检查通道配置里的model字段是否指向了一个存在的 provider/model。如果有model request但没有reply sent看模型返回的错误码回到第一类到第三类排查。第六类model not found或403 Forbidden。这表示 Key 权限不包含你请求的模型。去控制台确认 Key 的权限范围或者换一个已授权的模型 ID。如果你用的是 Coding Plan 的 Key注意它可能只覆盖编码类模型对话类模型需要另外的权限。把这些报错和配置检查点对照着看大部分问题能在几分钟内定位。关键是不要一看到“机器人不回复”就去重装微信插件先看日志里模型请求有没有发出去、返回是什么。6. 对接完成后的下一步模型对话验证与长期编码场景企业微信回环验证通过后说明消息通道和模型通道都通了。接下来可以按你的实际场景往下走。如果你只是想验证模型能力可以直接在模型对话页面里试不同模型确认哪个模型在你的任务上表现更好再把它填回通道配置的model字段。如果你要把 OpenClaw 用在长期编码或 Agent 任务上建议单独配一个 Coding Plan 的 Key和对话场景的 Key 分开。这样权限更清晰也方便按场景统计用量。Coding Plan 的配置方式和普通 Key 一样只是 Key 的权限范围不同填到 provider 的apiKey字段即可。你可以给编码场景单独建一个 provider比如taotoken-codingbaseUrl 同样是https://taotoken.net/api然后在需要编码的通道或技能里引用这个 provider。如果你在配置过程中遇到鉴权或接入问题可以对照接入文档里的参数说明逐项检查。文档里对 Base URL、Key、Model ID 三个字段的填写位置有明确说明和这篇里的配置片段是一致的。需要新建 Key 或调整权限时去 API Keys 页面操作。对于需要长期跑 Agent 任务的场景建议把网关做成开机自启并配置日志轮转避免日志文件把磁盘写满。openclaw gateway logs -f适合调试生产环境用openclaw gateway logs --tail 1000看最近日志就够了。另外企业微信机器人的 Secret 建议定期轮换轮换后更新配置文件并重启网关。最后提醒一个实操细节改完任何配置都先跑一遍第 4 节的消息回环验证确认收发链路可用再去测更复杂的功能。这样每次变更都有明确的验证点不会在多个变量之间来回猜。
