1. 为什么我最后选了企业微信 wecom-app 这条链路OpenClaw 本身是个很能打的本地智能体框架能读文件、跑命令、调工具但它的原生交互入口一直是个短板。飞书和钉钉的机器人场景偏办公Telegram、Discord 在国内日常使用里又不太顺手而微信是我们每天真正会打开几十次的聊天软件。把 OpenClaw 接进微信意味着你不用切应用、不用记复杂指令直接在熟悉的聊天框里把事办了。我试过几种方案最后落地在企业微信的「微信插件」上。原理不复杂企业微信提供一个 wecom-app 类型的应用OpenClaw 通过官方插件openclaw-china/wecom-app以 webhook 方式接收企业微信推送的消息处理完再回调回去而企业微信的「微信插件」功能会把应用消息同步到个人微信侧于是你在个人微信里就能和 OpenClaw 对话。整条链路的关键点有三个公网可达的 webhook 地址、企业微信应用的四组凭证企业 ID、Secret、AgentID、Token/EncodingAESKey、以及 OpenClaw 侧的插件配置。这篇教程面向的是想把 AI 能力落到微信侧的个人开发者和小团队。我会交付可复制的config.toml骨架、TaoToken 统一 Key 的settings.json配置片段以及 webhook 回调的验证动作和排错清单。跟着走一遍你应该能一次跑通接入并确认消息收发正常。在开始之前先把模型调用这一层统一掉。OpenClaw 支持多种模型后端但如果你不想在每台机器、每个项目里重复填 Key用 TaoToken 做统一入口会省很多事——一个 Key 覆盖对话、编码、Agent 场景配置只写一次。2. TaoToken 前置统一 Key 与 settings.json 配置TaoToken 在这里扮演的角色是「模型调用的统一网关」。OpenClaw 的 wecom-app 插件负责消息通道真正生成回复的还是底层模型而模型这一层通过 TaoToken 的 API 来调用。这样做的好处是你不需要在 OpenClaw 里为每个模型单独配 Key也不用担心换模型时要改一堆地方。2.1 获取统一 Key先到 TaoToken 控制台创建一个 API Key。地址是https://taotoken.net/api-keys登录后新建一个 Key复制保存。这个 Key 后面会写进 OpenClaw 的settings.json作为模型调用的凭证。注意Key 只在创建时完整显示一次务必当场复制到安全的地方。如果泄露了回控制台吊销重建即可。2.2 settings.json 配置片段OpenClaw 的模型配置放在settings.json里。下面是我实测可用的片段把base_url指向 TaoToken 的 API 地址api_key填你刚复制的 Key{ model: { provider: openai-compatible, base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model: claude-sonnet-4-20250514, max_tokens: 4096, temperature: 0.7 } }几个参数说明一下。provider用openai-compatible是因为 TaoToken 的接口兼容 OpenAI 格式OpenClaw 能直接识别。base_url必须是https://taotoken.net/api不要加多余的路径后缀。model字段填你想用的模型名TaoToken 支持多个模型按需替换即可。max_tokens和temperature按你的场景调微信对话场景下 4096 和 0.7 是比较稳的组合。如果你用的是 Coding Plan 做长期编码或 Agent 任务Key 的获取和配置方式一致只是套餐侧重点不同。配置写完后OpenClaw 启动时会读取这个文件模型调用就走 TaoToken 了。2.3 验证模型层是否通在配 webhook 之前先确认模型层没问题。执行一条最简单的调用curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-20250514, messages: [{role: user, content: 你好}] }如果返回里有正常的choices内容说明 Key 和网络都没问题。这一步过了再往下配企业微信排错范围会小很多。3. 可复制配置config.toml 骨架与 wecom-app 插件模型层通了之后进入消息通道的配置。OpenClaw 的插件配置放在config.toml里wecom-app 插件需要企业微信那边的四组凭证。3.1 企业微信侧准备打开企业微信管理后台https://work.weixin.qq.com/wework_admin按顺序拿这几样东西第一企业 ID。在「我的企业」→「企业ID」里复制保存。第二创建应用。在「应用管理」→「创建应用」填应用名和描述创建完成后进入应用详情页。第三Secret 和 AgentID。在应用详情页查看 Secret点击发送后企业微信手机 App 会收到一条含 Secret 的系统消息复制保存同时复制页面上的 AgentID。第四设置 API 接收。在应用详情页点「接收消息」卡片里的「设置API接收」生成 Token 和 EncodingAESKey复制保存。URL 先填你的云主机公网地址加路径比如http://你的公网IP:18789/wecom/callback这个路径要和后面config.toml里的路径一致。第五配置企业可信 IP。在应用详情页点「企业可信IP」卡片里的「设置」填入云主机的公网 IP。这一步不做的话企业微信会拒绝你的回调请求。3.2 config.toml 骨架下面是 wecom-app 插件的配置骨架把上面拿到的凭证填进去[plugins.wecom-app] enabled true corp_id ww你的企业ID agent_id 1000002 secret 你的应用Secret token 你生成的Token encoding_aes_key 你生成的EncodingAESKey callback_path /wecom/callback listen_port 18789corp_id是企业 IDagent_id是应用 AgentIDsecret是应用 Secrettoken和encoding_aes_key是设置 API 接收时生成的。callback_path必须和企业微信后台填的 URL 路径一致listen_port是 OpenClaw 监听的端口默认 18789如果你改了企业微信后台的 URL 也要同步改。3.3 安装插件并初始化在云主机上执行openclaw plugins install openclaw-china/wecom-app安装完成后运行配置向导openclaw china setup向导会依次问你企业 ID、Secret、AgentID、Token、EncodingAESKey 等信息按提示填入即可。如果你已经手动写了config.toml这一步可以跳过但建议跑一遍确认没有遗漏字段。3.4 安全组放行端口云主机默认不放行 18789 端口需要去云厂商控制台的安全组里加一条入站规则协议 TCP端口 18789来源0.0.0.0/0。如果你只从企业微信回调理论上可以限制来源 IP但企业微信的回调 IP 段会变实际用0.0.0.0/0更省事配合 Token 校验已经够安全。4. 验证请求webhook 回调与消息收发配置写完重启 OpenClaw 让插件生效openclaw restart然后看日志确认插件启动成功openclaw logs --follow日志里应该能看到 wecom-app 插件监听在 18789 端口并且没有报凭证错误。4.1 企业微信后台验证回调回到企业微信应用详情页的「设置API接收」点保存。企业微信会向你的 URL 发一个验证请求OpenClaw 的插件会自动处理并返回正确的校验值。如果保存成功说明 webhook 回调链路通了。如果报错看 OpenClaw 日志里的具体信息通常是 Token 或 EncodingAESKey 不匹配或者端口没放行。4.2 扫码接入个人微信在企业微信后台点「我的企业」→「微信插件」→「微信关注」用手机个人微信扫描页面二维码。关注后你会看到刚才创建的应用名比如 OpenClaw点进去发送「你好」。如果 OpenClaw 正常回复说明整条链路跑通了个人微信 → 企业微信插件 → webhook 回调 → OpenClaw 处理 → TaoToken 模型调用 → 回复回传 → 个人微信收到。4.3 确认消息收发正常发几条不同类型的消息测试一下纯文本、带换行的多行文本、以及一个简单指令比如「帮我列一下当前目录」。观察回复是否完整、是否有截断。如果多行文本回复格式乱了检查config.toml里有没有开启 markdown 渲染相关的选项。如果指令执行没反应看日志里模型调用是否成功可能是 TaoToken 的 Key 或模型名配错了。5. 本篇常见错排查清单接入过程中最容易卡在这几个地方我按出现频率排一下。回调验证失败。企业微信保存 API 接收时提示校验不通过。先确认callback_path和企业微信后台填的路径完全一致包括大小写。再确认token和encoding_aes_key没有多余空格。最后确认云主机安全组放行了 18789 端口并且企业可信 IP 填的是当前云主机的公网 IP。消息发出去没回复。个人微信里发了消息OpenClaw 没反应。先看openclaw logs --follow里有没有收到 webhook 请求。如果收到了但没回复大概率是模型调用失败检查settings.json里的base_url是不是https://taotoken.net/apiKey 有没有过期。如果日志里根本没收到请求检查企业微信应用是否开启了「接收消息」以及可信 IP 是否配置正确。回复内容为空或报错。模型返回了但内容异常。确认model字段填的模型名在 TaoToken 侧是可用的max_tokens不要设得太小。如果用的是 Coding Plan确认套餐覆盖了当前模型。插件安装后不生效。openclaw plugins install执行成功但配置没加载。检查config.toml里[plugins.wecom-app]段的enabled是否为true以及openclaw restart是否真的重启了服务。有时候需要先openclaw stop再openclaw start。个人微信收不到企业微信插件消息。扫码关注后应用列表里没有出现。确认企业微信后台的「微信插件」功能已开启并且你扫码的微信账号在企业成员列表里。如果不是企业成员需要先邀请加入。6. 接入之后把 Key 和通道都统一起来整条链路跑通后你会发现真正需要维护的只有两样东西TaoToken 的统一 Key和 wecom-app 的 webhook 配置。前者管模型调用后者管消息通道两者解耦换模型不用动通道换通道也不用动模型。如果你后面要接更多入口比如再挂一个飞书机器人模型层还是同一套settings.jsonKey 不用重复配。这就是统一 Key 的价值——配置只写一次入口随便加。需要复查接入细节的话接入文档在https://taotoken.net/docAPI Key 管理在https://taotoken.net/api-keys。想先验证模型回复效果可以直接在模型对话页试几条 prompt确认模型侧没问题再往通道里接。长期跑编码或 Agent 任务的话Coding Plan 的套餐会更合适Key 配置方式和上面完全一致。
