1. OpenClaw 接入企业微信到底在解决什么问题OpenClaw 是一个可以跑在本地或云服务器上的智能机器人框架企业微信则是很多团队日常沟通的主阵地。把这两者接起来本质上是让企业微信里的成员能直接跟 OpenClaw 对话而 OpenClaw 背后可以挂你自己的模型、知识库或自动化流程。适合谁用需要在内网或自有服务器上跑机器人、又不想折腾公网域名和证书的开发者尤其是习惯在命令行里完成配置的人。传统做法是 URL 回调模式企业微信把消息推到一个公网可访问的地址你的服务收到后处理再返回。这条路要求你有域名、有 HTTPS、有备案对本地开发和内网部署很不友好。长连接模式换了个思路——由 OpenClaw 主动向企业微信建立一条持久连接消息通过这条连接双向流动不需要你暴露任何端口也不需要域名和 IP。这就是本篇要落地的方案。整条链路涉及三个角色企业微信侧的智能机器人提供 Bot ID 和 Secret、OpenClaw 本体负责建立长连接、收发消息、以及你操作终端执行命令、改配置、看日志。配置的核心就是把 Bot ID 和 Secret 填进 OpenClaw 的渠道配置里然后启动服务验证消息能通。下面按可复制的顺序拆开讲每一步都给出命令和预期结果。2. 前置准备TaoToken 与 OpenClaw 环境在动企业微信之前先把 OpenClaw 的模型通道准备好。OpenClaw 本身不带模型它需要调用一个兼容 OpenAI 接口的服务来生成回复。我这边习惯用 TaoToken 作为模型接入层它的接口格式跟 OpenAI 一致配置起来省事。你需要先拿到一个 API Key。登录 TaoToken 控制台在 API Keys 页面创建一个新的 Key复制保存。这个 Key 后面会写进 OpenClaw 的模型配置里。控制台地址是 https://taotoken.net/console 创建 Key 的入口在 https://taotoken.net/api-keys 。接口基地址用 https://taotoken.net/api 注意这个地址不带任何查询参数。环境方面确认三件事企业微信客户端更新到较新版本本地或服务器上已经装好 OpenClaw终端能正常执行命令。如果你是在云服务器上部署用 SSH 连上去操作本地部署就直接开终端。OpenClaw 的版本建议升到 2026.2.13 或以上低版本在加载企微插件时会报版本不兼容的错这个坑后面排障部分会细说。模型配置先写进 OpenClaw 的配置文件。OpenClaw 的配置目录默认在~/.openclaw主配置文件是config.toml。如果你还没配过模型先补上这一段[models.default] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model gpt-4o-minibase_url指向 TaoToken 的 API 地址api_key填你刚创建的那个 Keymodel按你实际想用的模型名填。保存后先别急着接企业微信用一条命令验证模型通道是否通openclaw model test --model default如果返回正常的补全结果说明模型这层没问题可以继续往下走。如果报 401多半是 Key 复制时带了空格报连接超时检查base_url有没有写错。3. 企业微信侧长连接机器人的创建与参数获取这一步在企业微信客户端里完成不涉及命令行但拿到的两个参数是后面配置的关键。打开企业微信进入「工作台」→「智能机器人」点击「创建机器人」→「手动创建」。进入创建页面后注意选择「API 模式创建」页面上会有提示说明这种方式适合用自有系统接收和回复消息。接着在 API 配置页面连接方式选「使用长连接」。这里要区分清楚URL 回调方式需要你填一个公网地址长连接方式不需要域名和 IP由客户端主动连出去正好匹配 OpenClaw 的部署形态。选完长连接后页面会自动生成 Bot ID 和 Secret。这两个值只展示一次务必当场复制保存。Bot ID 是机器人的唯一标识Secret 相当于密码两者一起用于 OpenClaw 侧的身份校验。最后补充机器人的可见范围其他项保持默认保存配置。API 模式下暂时不支持预览和调试保存完就算创建成功。有一点要提醒长连接方式下机器人不会主动向你推送任何东西必须等 OpenClaw 侧建立连接后才会开始工作。所以创建完机器人后企业微信里暂时是找不到能对话的入口的这是正常的等 OpenClaw 连上之后才会出现。4. 可复制的 config.toml 骨架与插件安装回到终端。OpenClaw 通过插件的方式支持企业微信渠道先装插件npx -y wecom/wecom-openclaw-cli install这条命令会拉取企微渠道插件并注册到 OpenClaw。执行完看到安装成功的提示即可。如果你用的是云服务器上的 OpenClaw 镜像有些镜像已经内置了这个插件可以跳过。接下来编辑~/.openclaw/config.toml加入企业微信渠道配置。下面是一个可以直接抄的骨架[channels.wecom] enabled true mode long_connection bot_id 你的BotID secret 你的Secret # 长连接心跳间隔秒 heartbeat_interval 30 # 断线后重连的退避基数秒 reconnect_backoff 5 # 日志级别debug 能看到原始消息帧 log_level info几个参数说明一下。mode必须是long_connection填错会走 URL 回调逻辑然后报缺少回调地址。bot_id和secret就是上一步保存的两个值注意不要有多余空格。heartbeat_interval控制心跳频率默认 30 秒够用网络不稳可以调小。reconnect_backoff是断线重连的起始等待时间实际会按指数退避增长。log_level排查阶段建议先设debug跑通后再改回info减少日志量。如果你更习惯用命令行交互式配置也可以用 OpenClaw 自带的渠道添加命令openclaw channel add wecom --mode long_connection它会依次提示你输入 Bot ID 和 Secret然后自动写入配置文件。两种方式效果一样选顺手的就行。配置写完后建议用一条校验命令确认语法没问题openclaw config validate返回config is valid就说明 TOML 格式和必填项都过了。5. 启动、消息收发与日志验证配置就绪后启动 OpenClaw 服务openclaw start前台启动能看到实时日志。如果想让它在后台跑用openclaw start --daemon启动过程中日志里应该出现类似wecom channel connecting...和wecom long connection established的行。看到 established说明长连接已经建起来了。这时候回到企业微信进入「工作台」→「智能机器人」→ 找到你创建的机器人 →「详情」→「去使用」→「发消息」发一条测试消息比如「你好」。正常情况下OpenClaw 的日志里会打印收到消息的记录然后调用模型生成回复再通过长连接发回去。企业微信里几秒内就能看到机器人的回复。如果日志里只有收到消息、没有发出回复问题多半在模型通道回去检查第 2 节的模型配置。想更细地看消息流转把log_level设成debug再重启日志里会打出原始的消息帧结构包括发送者、消息类型、内容字段。这对排查「消息收到了但解析失败」这类问题很有用。另外可以用状态命令确认渠道健康度openclaw channel status wecom输出里会显示连接状态、最近一次心跳时间、累计收发消息数。心跳时间如果停在很久之前说明连接已经断了但没触发重连检查网络或调小heartbeat_interval。6. 本篇常见错误排查报错一版本不兼容。启动时提示 OpenClaw 版本过低、无法加载企微插件。这是最常见的坑。解决办法是先备份再升级cp -r ~/.openclaw ~/.openclaw.backup.$(date %Y%m%d) openclaw update升级过程中如果问Migrate legacy state now?选 Yes。升级完重启服务。备份这一步别省虽然升级一般不动数据但配置目录里可能有你手写的渠道信息留个底更稳。报错二长连接建立失败日志反复重连。先确认bot_id和secret没填错尤其是 Secret 里可能包含容易看混的字符。再确认企业微信侧机器人确实是「使用长连接」模式创建的如果建成了 URL 回调模式OpenClaw 这边怎么连都连不上。还有一种情况是服务器出网被限制长连接需要主动向外建立 TCP 连接确认防火墙允许出站。报错三消息收到但回复为空。日志显示收到消息、也调用了模型但返回内容为空。这通常是模型配置问题检查base_url和api_key用第 2 节的openclaw model test单独验证模型通道。如果模型通道正常检查config.toml里[models.default]的model字段是不是写了一个不存在的模型名。报错四企业微信里找不到机器人入口。创建完机器人后没立刻出现是正常的需要 OpenClaw 连上之后才会显示。如果连上后还是找不到去「工作台」→「智能机器人」→「详情」→「去使用」这个路径手动进入。另外确认机器人的可见范围包含了你当前账号。报错五配置文件改了不生效。OpenClaw 启动时读取配置改完config.toml必须重启服务。用openclaw restart或先stop再start。改完记得跑一次openclaw config validate避免 TOML 语法错误导致启动直接失败。排查时如果卡在接入环节优先看 API Keys 和接入文档https://taotoken.net/api-keys 和 https://taotoken.net/doc 。想先验证模型本身能不能正常对话用模型对话页面快速试一条https://taotoken.net/chat 。如果你打算长期跑编码类或 Agent 类任务走 Coding Plan 更划算https://taotoken.net/coding-plan 。Claude Code 相关的接入配置参考https://taotoken.net/claudecode 。