1. 企微群机器人 Webhook 创建与 OpenClaw 参数填写从零跑通消息推送企业微信的群机器人本质上是一个「只认 Webhook 地址的收件箱」——你往那个地址 POST 一段 JSON群里就冒出一条消息。它不需要你申请企业应用、不用配置可信 IP、也不用走管理员审批只要群主在群设置里点几下就能拿到地址。而 OpenClaw 这类本地 Agent 工具的价值在于它能把大模型的输出、定时任务的结果、代码执行的回执自动组装成企微要求的消息格式替你完成「生成内容 → 推送群聊」这条链路。适合谁适合需要在内部群快速落地告警通知、日报推送、CI 结果播报的开发者尤其是那些不想为了一条消息去搭一整套企业应用的团队。我试过的场景是这样的团队有个内部运维群之前每次部署完都要人工在群里发一句「v2.3.1 已上线」后来想改成自动推送于是开始研究企微机器人。踩过的第一个坑就是——网上很多教程把「群机器人 Webhook」和「企业应用 API 机器人」混着讲前者是群维度的、后者是企业维度的凭证体系完全不同。这篇按群机器人 Webhook 这条线走同时把 OpenClaw 侧的参数逐项拆开最后用 TaoToken 的统一 Key 完成一次真实的鉴权与消息发送验证。先明确两个概念的区别不然后面填参数会懵类型创建入口核心凭证适用场景群机器人 Webhook群设置 → 群机器人 → 添加Webhook URL含 key单群消息推送、告警、日报企业应用 API 机器人工作台 → 智能机器人Bot ID Secret多群管理、读取消息、指令调用群机器人 Webhook 的地址长这样https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key693a91f6-7xxx-4bc4-97a0-0ec2sifa5aaa那个key就是全部鉴权信息泄露了别人就能往你群里发消息所以别往公开仓库里提交。OpenClaw 侧要填的主要就是这个 Webhook 地址外加消息格式相关的参数。下面从创建开始一步步来。2. TaoToken 统一 Key 前置准备为什么 Agent 推送要走统一通道在讲 OpenClaw 参数之前得先说清楚鉴权这一层。OpenClaw 本身是个壳它调用大模型生成消息内容时需要一个大模型 API 的 Key。如果你同时用 Claude、GPT、通义好几个模型每个都去官网申请 Key、每个都配一遍环境变量管理成本会很高。TaoToken 做的是统一入口一个 Key 走所有模型Base URL 统一成https://taotoken.net/api模型 ID 按需切换。这一步的意义在于——OpenClaw 的配置文件里只需要维护一份凭证换模型时改一个 Model ID 字段就行不用动 Key。对于「企微机器人 OpenClaw」这个组合来说消息内容的生成质量取决于模型而模型切换的灵活性取决于你的 Key 管理方式。具体操作路径第一打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并登录。登录后进入控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。第二在控制台左侧找到「API Keys」菜单点进去创建一个新 Key。创建时可以给 Key 起个名字比如openclaw-wecom方便后面区分用途。创建完成后那串sk-开头的字符串只会完整显示一次复制下来存到安全的地方。第三确认你要用的模型 ID。TaoToken 的模型对话页面在 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 你可以在那里先试一下目标模型能不能正常对话确认没问题再写进 OpenClaw 配置。常用的模型 ID 比如claude-sonnet-4-20250514、gpt-4o这类具体以控制台模型列表为准。第四如果你打算长期跑编码类 Agent 任务可以看一下 Coding Plan 页面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 它针对高频调用场景做了额度优化比按量计费更适合持续运行的推送服务。到这里你手上有三样东西一个 TaoToken Key、一个 Base URLhttps://taotoken.net/api、一个确认可用的 Model ID。这三样就是 OpenClaw 配置里「模型接入」部分要填的全部内容。接下来进入企微机器人的创建。3. 可复制配置企微 Webhook 创建 OpenClaw 参数模板3.1 企微群机器人 Webhook 创建步骤打开企业微信 PC 客户端进入你要推送消息的那个内部群。点击群右上角的「…」进入群设置找到「群机器人」这一项点「添加机器人」。弹窗里会让你填机器人名称和头像名称建议写清楚用途比如「部署通知bot」头像随意。点确定后页面会展示一个 Webhook 地址格式就是前面说的https://qyapi.weixin.qq.com/cgi-bin/webhook/send?keyxxx。点「复制」按钮把它存下来。注意这个地址只在创建时完整展示如果关掉了可以在群机器人列表里点进对应机器人重新查看但有些企业版本会限制查看次数所以第一次就存好。3.2 OpenClaw 侧参数模板OpenClaw 的渠道配置通常是一个 JSON 或 TOML 文件具体路径取决于你的安装方式。以常见的配置文件~/.openclaw/config.json为例企微渠道部分这样写{ channels: { wecom: { enabled: true, webhook_url: https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key你的KEY, msg_type: markdown, mention_list: [], rate_limit_ms: 1200 } }, model: { provider: taotoken, base_url: https://taotoken.net/api, api_key: sk-你的TaoTokenKey, model_id: claude-sonnet-4-20250514, max_tokens: 2048 } }逐项说明webhook_url填企微复制的那串完整地址注意key后面不要有多余空格。msg_type支持text、markdown、image等。群机器人对 markdown 的支持有限只认标题、加粗、链接、引用、字体颜色这几种语法表格和代码块不渲染。如果你要推代码片段建议用text类型。mention_list是要 的成员手机号列表比如[13800000000]。注意 功能只在text类型下生效markdown 类型不支持 。rate_limit_ms是发送间隔企微群机器人限制每个机器人每分钟最多发 20 条消息所以设 1200 毫秒比较安全避免触发限流。模型部分provider写taotokenbase_url写https://taotoken.net/apiapi_key填你创建的 Keymodel_id填确认可用的模型。这样 OpenClaw 生成消息内容时就走 TaoToken 通道。如果你用的是 TOML 格式等价写法[channels.wecom] enabled true webhook_url https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key你的KEY msg_type markdown rate_limit_ms 1200 [model] provider taotoken base_url https://taotoken.net/api api_key sk-你的TaoTokenKey model_id claude-sonnet-4-20250514保存文件后重启 OpenClaw 让配置生效。如果你不确定配置文件路径可以在 OpenClaw 设置界面里找「打开配置目录」的入口或者看启动日志里加载的路径。3.3 安装包获取OpenClaw 的安装包按平台区分Windows 和 macOS 各有一个整合包内置运行依赖下载后直接启动即可。下载地址在 OpenClaw 官方发布页搜索「OpenClaw 整合包」就能找到对应版本。下载完成后解压双击可执行文件启动顶部 Gateway 服务标识显示在线就说明后台跑起来了。4. 验证请求用 curl 和 OpenClaw 各发一条消息配置填完不算完得实际发一条消息验证链路通不通。分两步先用 curl 直接打企微 Webhook确认机器人本身能用再通过 OpenClaw 走 TaoToken 生成内容并推送确认整条链路通。4.1 直接验证企微 Webhook打开终端执行curl -X POST https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key你的KEY \ -H Content-Type: application/json \ -d { msgtype: text, text: { content: 测试消息Webhook 连通正常 } }如果返回{errcode:0,errmsg:ok}说明 Webhook 地址有效群里应该已经收到那条测试消息。如果返回errcode非 0对照后面的排查章节处理。4.2 验证 TaoToken 通道在终端里用 curl 打一次 TaoToken 的对话接口确认 Key 和 Base URL 可用curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoTokenKey \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-20250514, messages: [{role: user, content: 用一句话说明部署完成}], max_tokens: 100 }正常返回里会有choices数组choices[0].message.content就是模型生成的内容。如果这一步报 401说明 Key 有问题如果报模型不存在说明 Model ID 写错了。4.3 通过 OpenClaw 端到端验证在 OpenClaw 界面里找到「测试渠道」或「发送测试消息」的按钮点一下。OpenClaw 会做三件事调用 TaoToken 接口生成一段测试文本按msg_type组装成企微要求的 JSONPOST 到webhook_url。如果群里收到消息说明整条链路通了。你也可以在 OpenClaw 的日志面板里看请求记录正常的话会看到类似[wecom] sending message, typemarkdown, len156 [wecom] response: {errcode:0,errmsg:ok} [model] providertaotoken, modelclaude-sonnet-4-20250514, tokens89到这里一次完整的「模型生成 → 企微推送」就验证完了。5. 本篇常见错排查401、local proxy failed、reading choices 逐个拆配置过程中最容易卡在几个报错上下面按真实遇到的顺序拆。5.1 401 Unauthorized这个报错来自 TaoToken 接口意思是 Key 无效或没带上。检查三处api_key字段是不是完整复制了sk-开头的字符串有没有多复制了空格或换行请求头里Authorization: Bearer sk-xxx格式对不对Bearer和 Key 之间有一个空格Key 是不是被你在控制台删掉了。如果确认都没问题去控制台重新创建一个 Key 再试。5.2 local proxy failed这个报错通常出现在 OpenClaw 启动阶段意思是本地代理端口没起来。OpenClaw 有些版本会在本地起一个转发服务如果端口被占用就会报这个。解决办法在配置里换一个端口比如把local_port从默认的 8080 改成 18080或者检查是不是有别的程序占了那个端口用netstat -ano | findstr 8080Windows或lsof -i :8080macOS看一下。改完端口重启 OpenClaw。5.3 reading choices 报错这个报错一般长这样Cannot read properties of undefined (reading choices)。意思是 OpenClaw 拿到模型返回后想读choices字段但读不到。原因通常是返回结构不符合预期——比如 TaoToken 返回的是标准 OpenAI 格式但 OpenClaw 配置里provider写错了导致它按别的格式解析。检查provider是不是写的taotokenbase_url是不是https://taotoken.net/api。如果还不行把max_tokens调大一点有时候返回被截断也会导致解析失败。5.4 企微侧报错对照errcode含义处理93000Webhook key 无效重新复制地址确认 key 完整45009接口调用超过限制降低发送频率调大rate_limit_ms40001不合法的 secret检查 URL 里有没有多余字符40058参数格式错误检查 JSON body 是否符合企微文档5.5 消息发出但群里没显示先确认webhook_url对应的群是不是你正在看的那个群——有时候复制的是测试群的地址但你在正式群里等消息。再确认msg_type和内容格式匹配text类型下content是字符串markdown类型下content也是字符串但语法有限制。如果用了markdown但内容里有表格企微会静默丢弃不渲染看起来就像没发出去。6. 长期运行建议与接入文档入口跑通之后如果你打算把这个推送服务长期挂着有几个点值得注意。第一Key 的轮换。TaoToken 控制台可以创建多个 Key建议给 OpenClaw 单独用一个方便出问题时单独吊销不影响其他服务。轮换时在控制台新建一个 Key改 OpenClaw 配置重启确认新 Key 生效后再删旧的。第二限流保护。企微群机器人每分钟 20 条是硬限制如果你的推送频率可能超过这个值在 OpenClaw 侧加一个队列或者把rate_limit_ms设大一点。批量推送时建议合并成一条消息而不是拆成多条。第三消息内容控制。群机器人消息太长会被截断建议单条控制在 2000 字符以内。如果模型生成的内容可能超长在 OpenClaw 配置里限制max_tokens或者在推送前做一次截断。第四监控。OpenClaw 日志里会记录每次推送的结果建议定期看一眼有没有errcode非 0 的记录。如果连续失败可能是 Key 过期或 Webhook 被重置。接入相关的文档和入口API Keys 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite模型对话测试https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewriteCoding Plan长期编码/Agent 任务https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite如果你在配置过程中遇到reading choices或local proxy failed这类报错先去接入文档里对照错误码大部分情况是 Base URL 或 Model ID 写错了。把这两个字段核对一遍重启 OpenClaw通常就能解决。