1. OpenClaw 接入企业微信时AgentId 与回调地址到底卡在哪OpenClaw 接入企业微信WeCom这件事说难不难说简单也容易翻车。核心检索词就三个OpenClaw、企业微信、AgentId 与回调地址配置。OpenClaw 是一个可自托管的 AI Agent 网关能把大模型能力挂到各种消息通道上企业微信则是国内企业 IM 里覆盖率最高的平台员工不用装新软件就能用。把这两者接起来适合谁适合手里有 OpenClaw 实例、又想让全公司同事在企微工作台里直接对话 AI 的开发者或运维。我试过在测试企业里从零走一遍最耗时间的不是写代码而是三件事AgentId 拿错、回调地址验证不过、鉴权链路里 Secret 和 Token 混用。企业微信自建应用的 AgentId 是数字格式比如 1000002它和 CorpIdww 开头、Secret 是三套不同的凭证少一个都跑不通。回调地址更麻烦企业微信保存时会发一个 GET 请求做 URL 验证Gateway 没起来就直接失败。还有一个隐藏坑很多人把模型调用的 Key 和企微的 Secret 放在同一个配置文件里结果轮换时互相污染。我的做法是把模型侧统一走 TaoToken 的 Key企微侧只保留通道凭证两边解耦。下面按“先拿凭证、再配回调、最后验证回环”的顺序走一遍每一步都给可复制的片段。2. TaoToken 前置准备统一 Key 与 OpenClaw 模型侧接入在动企业微信之前先把 OpenClaw 的模型侧接好否则回调通了、消息进来了Agent 却没法回。TaoToken 在这里的角色是统一模型入口你拿一个 Key就能在 OpenClaw 里调用多个模型不用为每个模型单独配一套鉴权。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 。第一步去控制台创建 API Key。打开 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 登录后进 API Keys 页面新建一个 Key复制保存。这个 Key 只显示一次丢了只能重建。建议命名成 openclaw-wecom-prod 这种带环境的方便后面轮换。第二步确认你要用的模型 ID。在模型对话页 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 里可以先试跑一下确认模型能正常回复再把它写进 OpenClaw 配置。模型 ID 要一字不差写错了 OpenClaw 启动时不会报错但消息进来会返回空。第三步把 Key 写进 OpenClaw 的模型配置。OpenClaw 的模型段和通道段是分开的别混在一起。下面是一个最小可用的模型配置片段路径按你实际的 openclaw.config.json5 来{ // 模型侧统一走 TaoToken models: { default: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: ${TAOTOKEN_API_KEY}, model: your-model-id } } }注意 apiKey 用环境变量 ${TAOTOKEN_API_KEY}不要硬编码。启动前 export 一下export TAOTOKEN_API_KEYsk-你的Key如果你用的是 Coding Plan 做长期编码或 Agent 任务可以在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 看套餐说明把额度规划好再上生产。模型侧通了之后再进企业微信通道配置这样排障时能明确是通道问题还是模型问题。3. 可复制配置AgentId、回调地址与鉴权链路这一节是全文的核心直接给可复制的配置。企业微信侧要准备四样东西CorpId、AgentId、Secret、回调 Token 与 EncodingAESKey。前三个在管理后台拿后两个在配置回调时生成。先看企业微信后台的路径。登录管理后台进“应用管理 → 自建 → 创建应用”填名称和可见范围。创建后进应用详情页AgentId 就在页面上数字格式。Secret 点“查看”扫码验证后复制。CorpId 在“我的企业 → 企业信息”底部ww 开头。这三个先记到安全的地方。然后是回调配置。在应用详情页点“接收消息 → 设置 API 接收”填 URL、Token、EncodingAESKey。URL 指向你的 OpenClaw Gateway格式是 https://你的域名/api/channels/wecom/webhook 。Token 和 EncodingAESKey 可以点随机生成生成后先复制出来因为保存时企业微信会立刻发验证请求Gateway 必须已经在跑。下面是 OpenClaw 侧的完整通道配置片段路径 openclaw.config.json5{ channels: { wecom: { enabled: true, // 企业IDww 开头 corpId: ww7xxxxxxxxxxxxxxx, // 应用 AgentId数字格式 agentId: 1000002, // 应用 Secret secret: ${WECOM_SECRET}, // 回调 Token与企业微信后台一致 token: ${WECOM_TOKEN}, // 回调 EncodingAESKey43 位 encodingAESKey: ${WECOM_ENCODING_AES_KEY}, // 企业内部应用建议 open dmPolicy: open, group: { enabled: true, mentionOnly: true, quoteReply: true, contextRounds: 5, maxConcurrentReplies: 3 } } } }三件套对照表别搞混配置项来源格式用途corpId我的企业 → 企业信息ww 开头标识企业agentId应用详情页纯数字标识应用secret应用详情页查看长字符串应用鉴权token回调设置生成自定义消息签名encodingAESKey回调设置生成43 位消息加解密环境变量方式更安全对应关系是 WECOM_CORP_ID、WECOM_AGENT_ID、WECOM_SECRET、WECOM_TOKEN、WECOM_ENCODING_AES_KEY。启动前统一 export配置文件里只留引用。这样 Secret 不会进代码仓库轮换时也只改环境变量。如果你同时用 Claude Code 做开发模型侧可以走 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 的接入方式和企微通道互不影响。配置写完先别急着启动下一节讲怎么验证。4. 验证请求一次消息回环确认回调可达与鉴权通过配置写完启动 Gatewayopenclaw gateway正常启动日志应该包含这几行[INFO] WeCom channel initialized [INFO] WeCom callback verified successfully [INFO] Gateway listening on :3000 [INFO] Bot ready: OpenClaw 智能助手 (AgentId: 1000002)看到 “callback verified successfully” 说明企业微信的 URL 验证过了。如果这行没出现回到第 5 节排障。接下来做消息回环验证。第一步确认回调地址公网可达curl -I https://你的域名/api/channels/wecom/webhook返回 200 或 403 都算通403 是因为缺少企业微信签名参数属于正常。返回连接超时就是网络或证书问题。第二步在企业微信客户端里从工作台打开你的应用发一条消息比如“你好”。同时开 debug 日志看原始消息openclaw gateway --log-level debug你应该能看到类似这样的入站日志[DEBUG] WeCom inbound: { msgtype: text, content: 你好, from: zhangsan } [DEBUG] Model request - taotoken, model: your-model-id [DEBUG] WeCom outbound: { content: 你好我是 OpenClaw 智能助手 }第三步确认企业微信侧收到回复。如果客户端里看到了 AI 回复说明整条链路通了企业微信 → 回调地址 → OpenClaw 鉴权 → TaoToken 模型 → 回复回传。这一步是整个接入的验收点别跳过。群聊验证也做一次。把应用机器人加到群里它发消息确认 mentionOnly 生效——不 不回复。如果群里没反应但私聊正常多半是 group.enabled 没开或机器人没加进群。5. 本篇常见错排查401、回调失败与 choices 读取异常排障按“先通道后模型”的顺序能省一半时间。回调地址请求不通过。企业微信保存时提示这个先确认 Gateway 在跑再 curl 回调地址。常见原因是 HTTPS 证书是自签的企业微信不认或者防火墙没放 443。Token 和 EncodingAESKey 必须和后台完全一致多一个空格都会失败。401 鉴权失败。如果日志里出现 401先分清是哪一侧。模型侧 401 通常是 TaoToken Key 无效或没 export检查环境变量echo $TAOTOKEN_API_KEY企微侧 401 多半是 Secret 或 AgentId 配错。AgentId 是数字别加引号写成字符串Secret 别把 CorpId 填进去。local proxy failed。这个报错通常出现在 Gateway 无法访问模型基址时。确认 baseUrl 是 https://taotoken.net/api 不要带多余路径。如果你本地有网络策略确认出站 443 放通。reading choices 报错。日志里出现 reading choices 说明模型返回体不是预期结构常见于模型 ID 写错或 baseUrl 指到了非兼容端点。回到模型对话页确认模型 ID再核对 baseUrl。OAuth 相关报错。如果你用了 Claude Code 的 OAuth 流程报错时检查 token 是否过期。企微通道本身不走 OAuth别把两套鉴权混在一起。消息乱码。encodingAESKey 必须是 43 位长度不对会解密失败。检查配置里的值别把 Token 填到 AESKey 里。应用在工作台不显示。确认当前账号在可见范围内应用状态是启用。改完可见范围让成员重新登录一次。排障时把日志级别开到 debug原始消息和出站内容都能看到定位快很多。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite Key 管理在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 对照着看能少走弯路。6. 把企业微信通道接进 OpenClaw 的长期用法通道通了之后日常维护就三件事Key 轮换、日志巡检、额度规划。Key 轮换时只改环境变量重启 Gateway 即可配置文件不用动。日志巡检重点看回调验证和 401出现就及时处理。额度方面如果全公司都在用提前在 Coding Plan 页面规划好避免高峰期限流。群聊场景建议保持 mentionOnly否则机器人会刷屏。审批流和通知功能按需开别一上来全开先跑通私聊和群聊再扩展。安全上生产环境开 encryptMessage配 IP 白名单Secret 永远走环境变量。最后留一个实用技巧把回调地址和 AgentId 写进你的部署清单每次换服务器或换域名时对照检查一遍。这两个值一变企业微信后台必须同步改否则回调直接断。接入这件事配一次记一辈子后面就是稳定运行了。