1. 为什么企业微信渠道值得单独配一遍

OpenClaw 接入企业微信这件事，真正卡人的地方从来不是"点哪个按钮"，而是三个东西凑不齐：机器人侧要拿到 Bot ID 和 Secret，连接方式要选长连接，权限要一次性授权完整。少任何一环，表现都是"配置看起来保存成功了，但机器人不回消息"。

我见过太多人卡在最后一步：企业微信里发"你好"，机器人一动不动，然后开始怀疑是不是 OpenClaw 坏了。其实九成情况是权限没授全，或者 Secret 复制时带了个空格。

这篇教程聚焦 OpenClaw 企业微信渠道的 API 模式 + 长连接配置，把全部授权流程走完，最后交付一份可以直接抄的config.toml骨架，以及用 TaoToken 统一 Key 接入模型侧的配置。适合两类人：一是第一次给 OpenClaw 接企业微信、想要一份能照着做到底的清单；二是已经接了但机器人不回复、想按排查顺序定位问题的人。

整篇的节奏是：先把企业微信机器人侧参数拿到手，再回到 OpenClaw 填渠道配置，然后配模型 Key，最后发消息验证。每一步都给可复制的命令或配置，不玩"自行理解"。

2. 前置准备：企业微信机器人参数与 TaoToken Key

2.1 企业微信侧要拿到什么

在动手改 OpenClaw 之前，先把企业微信这边的三样东西确认好：

第一，当前企业微信账号要有创建和管理智能机器人的权限。没有这个权限，工作台里根本看不到"智能机器人"入口。

第二，机器人必须走API 模式创建，而不是普通模式。普通模式拿不到 Bot ID 和 Secret，后面 OpenClaw 就没法填。

第三，连接方式选使用长连接。长连接的好处是不需要你暴露公网回调地址，OpenClaw 主动和企业微信保持通道，内网环境也能跑通。

操作路径大致是：企业微信客户端 → 工作台 → 智能机器人 → 创建机器人 → 填名称头像简介 → 滚到底部点"API 模式创建" → 连接方式选"使用长连接" → 点"点击获取"拿到 Secret → 展开权限列表 → 滚到底部点"全部授权" → 看到"全部授权成功"提示 → 返回保存 → 进"API 配置"复制 Bot ID 和 Secret。

这里有个容易忽略的点：全部授权按钮在权限弹窗的最底部，很多人滚到一半以为看完了就返回，结果权限只授了一部分。授权不完整最典型的症状就是机器人能收到消息但不回复，因为缺少调用能力或读取消息的权限。

2.2 TaoToken 侧要准备什么

OpenClaw 本身是渠道框架，真正生成回复内容要靠背后的模型。这里用 TaoToken 做统一 Key 接入，好处是一个 Key 管多个模型，切换模型不用改一堆环境变量。

先去控制台建一个 API Key：

• 控制台入口：https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=wecom_channel
• API Key 管理：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=wecom_channel

建好之后把 Key 复制出来，格式通常是一串以sk-开头的字符串。这个 Key 后面要写进 OpenClaw 的模型配置里。

API 的基础地址是https://taotoken.net/api，注意这个地址不带任何查询参数，直接作为 base_url 用。

提示：Key 只显示一次，复制后先存到本地密码管理器或临时文件里，别直接贴在聊天窗口。

3. 可复制配置：config.toml 骨架与渠道填写

3.1 OpenClaw 企业微信渠道填写

回到 OpenClaw，点右上角设置 → 左侧"聊天配置" → 找到"企业微信（WeCom）"。

如果这里显示"安装插件"，先点安装。企业微信接入依赖插件@wecom/wecom-openclaw-plugin，没装插件的话，下面的 Bot ID 和 Secret 输入框填了也不生效。

插件装完后，把企业微信 API 配置页复制的两个值填进去：

• Bot ID：企业微信机器人 API 配置页里的 Bot ID
• Secret：同一页面里的 Secret

填完点右上角"保存渠道配置"。这一步保存的是渠道凭证，和后面的模型配置是两回事，别混在一起。

3.2 config.toml 骨架

OpenClaw 的配置文件一般放在用户目录下的.openclaw/config.toml（Windows 是%USERPROFILE%\.openclaw\config.toml）。下面是一份可以直接改的骨架，渠道部分和模型部分分开写：

# OpenClaw 主配置骨架 # 渠道：企业微信（长连接模式） [channels.wecom] enabled = true bot_id = "你的BotID" secret = "你的Secret" connection_mode = "long_connection" # 长连接，无需公网回调 plugin = "@wecom/wecom-openclaw-plugin" # 模型：TaoToken 统一 Key 接入 [models.default] provider = "openai-compatible" base_url = "https://taotoken.net/api" api_key = "sk-你的TaoTokenKey" model = "claude-sonnet-4-5" timeout = 60 # 网关 [gateway] listen = "127.0.0.1:8787" log_level = "info"

几个参数说明：

如果你更习惯用环境变量而不是写死在 toml 里，可以把 Key 抽出来：

# Linux / macOS export TAOTOKEN_API_KEY="sk-你的TaoTokenKey" # Windows PowerShell $env:TAOTOKEN_API_KEY="sk-你的TaoTokenKey"

然后在 toml 里写api_key = "${TAOTOKEN_API_KEY}"。这样换 Key 不用动配置文件，也避免 Key 进版本库。

3.3 长连接模式的关键点

长连接模式下，OpenClaw 启动后会主动向企业微信建立并维持一条通道。你不需要在企微后台配回调 URL，也不需要公网 IP。代价是这条连接要保持活跃，如果 OpenClaw 进程挂了或者网络断了，通道就断，机器人自然不回消息。

所以配置完之后，第一件事是确认 OpenClaw 顶部的 Gateway 状态是在线的。Gateway 不在线，后面所有验证都是白搭。

4. 验证请求：从发消息到确认回复

4.1 先验证模型侧通不通

在验证企业微信之前，先单独确认 TaoToken 这条链路是通的。用 curl 打一个最小请求：

curl https://taotoken.net/api/v1/chat/completions \ -H "Authorization: Bearer sk-你的TaoTokenKey" \ -H "Content-Type: application/json" \ -d '{ "model": "claude-sonnet-4-5", "messages": [{"role": "user", "content": "只回复两个字：收到"}] }'

如果返回里有正常的choices内容，说明 Key 和 base_url 都没问题。这一步能过，后面企业微信不回消息就基本可以排除模型侧的原因。

想先在网页里直观试一下模型效果，可以用模型对话页：

https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=wecom_channel

4.2 再验证企业微信渠道

模型通了之后，回到企业微信机器人详情页，点右上角"去使用"，进入机器人聊天窗口，发一条测试消息，比如"你好"。

正常情况机器人会返回内容。如果返回了，说明整条链路——企业微信 → 长连接 → OpenClaw → TaoToken → 模型——全部打通。

4.3 授权范围核对清单

发消息之前，建议对着这份清单逐项打勾，避免"配了但不回"：

• 企业微信里已成功创建智能机器人
• 创建时走的是 API 模式
• 连接方式选的是使用长连接
• Bot ID 和 Secret 已复制且无多余空格
• 权限列表已滚到底部点"全部授权"
• 页面出现过"全部授权成功"提示
• OpenClaw 里企业微信插件已安装完成
• Bot ID 和 Secret 已正确粘贴并保存渠道配置
• OpenClaw 顶部 Gateway 状态在线
• 已向机器人发送测试消息并收到回复

这份清单的价值在于：出问题时你不用瞎猜，从上往下逐项排除就行。

5. 本篇常见错排查

5.1 机器人不回复，按这个顺序查

第一，看 OpenClaw 顶部 Gateway 是否在线。不在线先解决 Gateway，别往下查。

第二，确认企业微信插件装完了。插件没装，渠道配置保存了也是空转。

第三，检查 Bot ID 和 Secret 有没有复制完整。Secret 经常在复制时带上首尾空格，肉眼看不出来，粘到输入框里就会鉴权失败。建议粘完后手动检查一遍首尾。

第四，回企业微信 API 配置页确认连接方式确实是"使用长连接"，不是别的模式。

第五，确认权限是"全部授权"而不是部分授权。部分授权时机器人可能能收到消息但无法调用能力，表现就是不回复。

第六，确认点过"保存渠道配置"。有人填完参数直接关窗口，没保存。

以上都排完还不回复，重启一次 OpenClaw 再测。重启会重新建立长连接，能解决一部分通道僵死的情况。

5.2 模型侧报错怎么定位

如果企业微信能收到消息但返回的是错误提示，问题多半在模型配置。常见两类：

一是401或鉴权失败，检查api_key是不是复制错了，或者环境变量没生效。用 4.1 的 curl 单独测一次就能定位。

二是model not found，说明model字段写的模型名不对。换成你账号下确实可用的模型名再试。

5.3 长连接频繁掉线

长连接掉线通常和网络稳定性有关。如果 OpenClaw 跑在会休眠的机器上，或者网络经常切换，通道就容易断。可以考虑把 OpenClaw 放在常开的机器上，或者加一个进程守护，挂了自动拉起。

6. 后续：把 Key 和渠道管起来

渠道配通只是第一步。真正长期用起来，你会遇到两个需求：一是换模型不想改配置，二是多个渠道共用一套 Key。

TaoToken 的统一 Key 正好解决这两点。一个 Key 可以调不同模型，OpenClaw 里只改model字段就行，base_url和api_key不用动。如果你还要接别的渠道，也可以复用同一个 Key，省得每个渠道单独维护一套凭证。

Key 的管理入口在这里：

https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=wecom_channel

接入相关的文档在：

https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=wecom_channel

如果你打算把 OpenClaw 用在长期编码或 Agent 场景，频繁调用模型，可以看一下 Coding Plan，额度模型更适合这种持续跑的场景：

https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=wecom_channel

最后给一个实操建议：把config.toml里的 Key 换成环境变量引用，然后给这份配置做个备份。企业微信的 Secret 如果哪天重置了，你只需要改渠道那两行，模型配置完全不用动。这样下次再遇到"机器人不回复"，排查范围能直接缩小一半。