1. 为什么要在本地跑 OpenClaw 钉钉机器人钉钉机器人这个词很多人第一反应是「群里的自定义 Webhook 推送」只能单向发消息没法做多轮对话更没法调用本地模型。而 OpenClaw 这类本地智能体框架核心价值在于把「消息入口」和「模型推理」拆开钉钉负责触达本地负责思考。你可以在自己电脑上跑一个常驻进程钉钉里 一下机器人请求就落到本地模型回复再原路返回。这套组合适合谁三类人最合适。第一类是公司内部想搭一个「不外传数据」的问答助手聊天记录和知识库都留在本地第二类是开发者想拿钉钉当调试入口测试自己接的模型通道稳不稳定第三类是做自动化办公的比如让机器人读工单、查表格、回固定话术。这三种场景的共同点是消息必须能双向流动而钉钉的「机器人应用」正好提供了这个能力。我实测下来整个链路可以拆成四段钉钉开发者后台创建机器人应用 → 拿到 Client ID / Client Secret → OpenClaw 本地装钉钉渠道插件 → 填入凭证并保存。听起来简单但中间有几个坑特别容易卡住比如插件没装完就填参数、密钥复制带了空格、Gateway 没在线就保存配置。这篇就按「能跟做」的标准把每一步的命令、配置、验证动作都写清楚顺带把模型调用通道用 TaoToken 统一起来省得你到处找 Key。先说清楚一个前提OpenClaw 的钉钉渠道是「连接器插件」模式整合包里不会预装全部 IM 依赖。所以你第一次进渠道配置页看到「安装插件」按钮是正常的不是软件坏了。点它等进度条走完Gateway 会自动重启一次这一步千万别中途关程序。另外模型调用这块我建议用 TaoToken 做统一入口。原因很直接本地智能体经常要切换模型今天用这个、明天试那个如果每个模型都单独配 Key配置会散得到处都是。TaoToken 提供统一的 API 通道Base URL 和 Key 一套就够模型 ID 按需换。官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end API 地址是 https://taotoken.net/api 后面配置里会用到。2. TaoToken 前置准备统一 Key 与 API 通道在动钉钉之前先把模型通道理顺不然后面联调时你分不清是钉钉的问题还是模型的问题。TaoToken 的作用是给你一个统一的 API 入口兼容常见的对话补全格式本地智能体只要按标准协议发请求就行。第一步去控制台拿 Key。打开 https://taotoken.net/console 登录后进 API Keys 页面新建一个 Key。这里有个细节Key 只在创建时完整显示一次复制后存到本地一个临时文件里别直接截图发群里。我一般会建两个 Key一个专门给本地智能体用一个留着测试方便出问题时快速替换排查。第二步确认你要用的模型 ID。TaoToken 的模型列表在文档里有进 https://taotoken.net/doc 能看到当前支持的模型名。记下你要用的那个 ID比如做日常对话和代码辅助选一个综合能力够的就行。模型 ID 是后面配置里的必填项写错了会直接报「model not found」。第三步把 Base URL 记牢。TaoToken 的 API 根地址是 https://taotoken.net/api 注意这里不带任何多余路径。有些框架要求填完整的 chat completions 地址有些只要根地址OpenClaw 的模型配置里通常填根地址即可具体看它那一栏的提示。如果你打算长期跑编码类或 Agent 类任务可以顺手看一下 Coding Plan地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。它的定位是给持续性的编码和智能体任务用的比单次调用更适合常驻场景。不过这篇的重点是钉钉渠道模型通道先配通就行。这里插一句踩过的坑很多人把 Key 填进配置后忘了保存或者保存了但没重启 Gateway结果钉钉发消息一直没反应回头查半天以为是钉钉的问题。记住一个顺序——先配模型通道确认能单独跑通再配钉钉渠道。这样出问题时你能快速定位是哪一段断了。模型通道验证很简单用 curl 发一条测试请求就行命令在下一节给。只要返回里有正常的回复内容说明 Key、Base URL、模型 ID 三件套没问题可以进钉钉环节了。3. 可复制配置钉钉渠道 模型通道三件套这一节是核心所有能直接复制的东西都放这里。先给模型通道的配置片段再给钉钉渠道的填写对照最后给一个完整的 settings 结构参考。模型通道这块OpenClaw 的配置文件通常是 JSON 或 TOML 格式路径一般在软件安装目录下的 config 文件夹或者用户目录的 .openclaw 里。具体以你本地实际路径为准下面给的是结构示例字段名对照你软件里的实际输入框来填。{ model_provider: { base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model_id: 你的模型ID, timeout: 60 } }如果你用的是 TOML 格式等价写法是这样[model_provider] base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model_id 你的模型ID timeout 60三件套记牢Base URL 填 https://taotoken.net/api Key 填你控制台新建的那串Model ID 填文档里查到的模型名。这三个缺一不可而且顺序别搞混。接下来是钉钉渠道。在 OpenClaw 客户端右上角「设置」→ 左侧「聊天配置」→ 找到钉钉DingTalk卡片。如果卡片显示「安装插件」先点安装等进度到 100% 并提示安装完成Gateway 自动重启后再继续。插件装好后卡片里会出现两个输入框配置项填写内容来源Client ID (AppKey)钉钉后台复制的 Client ID钉钉开发者后台机器人页面Client Secret钉钉后台复制的 Client Secret钉钉开发者后台机器人页面渠道总开关开启OpenClaw 渠道卡片模型通道上一节配的 TaoToken 三件套OpenClaw 模型配置钉钉后台的入口是 https://open-dev.dingtalk.com 登录后进「应用开发」左侧有「钉钉应用」和「机器人」分类。创建机器人时快捷入口会自动匹配 OpenClaw 所需的能力省去手动勾选。创建完页面会展示 Client ID 和 Client Secret点复制按钮存下来。注意 Client Secret 是私密密钥别外传。如果你用的是 Claude Code 这类工具做辅助开发接入配置也是同样的三件套逻辑Base URL、Key、Model ID 一个都不能少。Claude Code 的接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_codeutm_campaignrewrite 需要的话可以对照看。配置保存前再核对一遍Client ID 和 Secret 有没有多余空格渠道开关是不是开着模型通道的 Key 是不是完整。确认无误后点「保存渠道配置」。保存后如果没立即生效点 OpenClaw 顶部的重启按钮等 Gateway 显示在线再发测试消息。4. 验证请求从 curl 到钉钉消息全链路跑通配置填完不等于通了必须做两步验证先验模型通道再验钉钉链路。分开验的好处是哪一步报错一目了然。先验模型通道。打开终端用 curl 发一条标准请求curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -H Content-Type: application/json \ -d { model: 你的模型ID, messages: [{role: user, content: 你好测试一下}] }返回里如果有 choices 字段并且 content 里有正常回复说明模型通道没问题。如果返回 401说明 Key 不对或没带 Bearer 前缀如果返回 model not found说明模型 ID 写错了如果连接超时检查网络和 Base URL 是不是 https://taotoken.net/api 。模型通道通了之后验钉钉链路。打开钉钉客户端搜索你刚创建的机器人名称进对话窗口发一条测试消息比如「你好」。正常情况下几秒内会收到回复。如果没回复先看 OpenClaw 的 Gateway 是不是在线再看渠道卡片是不是显示「已配置」。我实测下来第一次联调最容易卡在两个地方一是插件没装完就填参数导致保存后不生效二是 Gateway 重启期间发了消息请求丢了。所以建议插件装完、Gateway 稳定在线后再发测试消息。如果你想更直观地看请求过程可以在 OpenClaw 的日志面板里看实时输出。发消息时日志里会先出现收到钉钉事件的记录然后是调用模型的请求最后是回复发送的记录。三段都有说明全链路通了。缺哪段就查哪段。验证通过后你可以试着发一条稍微复杂点的消息比如让它总结一段文字或者回答一个需要多轮的问题确认多轮对话也正常。钉钉机器人的消息是流式还是整段返回取决于 OpenClaw 的配置一般默认整段返回够用。5. 常见报错排查401、插件安装失败、无回复这一节按真实报错来遇到哪个查哪个。报错一401 Unauthorized。这个基本是模型通道的 Key 问题。检查三处Key 是不是复制完整有没有带 Bearer 前缀curl 里要带配置文件里通常不用Key 是不是已经失效或被删。如果 Key 没问题检查 Base URL 是不是写成了 https://taotoken.net/api 而不是别的路径。还有一种情况是 Key 前后带了空格肉眼看不出来重新复制一遍。报错二local proxy failed 或连接被拒绝。这个通常出现在本地有代理设置的情况下。检查系统代理有没有开OpenClaw 的网络设置里有没有配代理。如果开了代理又没配好请求会走不通。关掉代理或者确保代理规则里放行了 taotoken.net 和钉钉的域名。报错三reading choices 失败或返回结构异常。这说明请求发出去了但返回的内容解析不了。常见原因是模型 ID 填错或者请求格式不对。用第 4 节的 curl 命令单独测一下如果 curl 正常但 OpenClaw 里报错检查 OpenClaw 的模型配置字段名有没有填对比如 base_url 和 api_key 的拼写。报错四钉钉渠道显示「安装插件」但点了没反应。先看网络插件是从远端下载的网络波动会导致进度卡住。别中途关程序等它走完。如果一直卡在某个百分比重启 OpenClaw 再试。装完后 Gateway 会自动重启等它稳定。报错五保存配置后机器人不回复。按顺序查Gateway 是否在线插件是否完整安装Client ID 和 Secret 有没有空格机器人应用是不是创建在当前登录账号所属组织下渠道开关是否开启是否点了保存。全部核对后重启客户端再发消息。报错六OAuth 相关错误。如果钉钉后台提示 OAuth 或授权失败检查机器人应用的权限配置确认它具备接收和发送消息的能力。快捷创建的机器人一般默认带这些权限如果你是手动创建的需要逐项勾选。排查的核心思路是分段隔离模型通道用 curl 单独验钉钉链路用测试消息单独验。哪段报错查哪段别混在一起猜。6. 长期使用建议与接入入口跑通之后有几个长期使用的点值得注意。第一Key 要定期轮换尤其是多人共用的情况下建议每人一个 Key方便追踪和回收。第二模型 ID 可以按场景切换日常对话用一个代码任务用另一个TaoToken 的统一通道让切换成本很低。第三OpenClaw 和插件都保持更新钉钉的接口偶尔会调整插件更新通常会跟进。如果你后面要接更多渠道比如飞书、企业微信逻辑是一样的先在对应平台创建应用拿凭证再在 OpenClaw 里装渠道插件填参数。模型通道始终用 TaoToken 这一套不用每个渠道单独配。需要拿 Key 或看接入文档的直接走这两个入口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_contentchatutm_campaignrewrite 直接聊两句确认通道正常再往本地配。最后提醒一句钉钉机器人的 Client Secret 和 TaoToken 的 Key 都属于敏感信息别写进公开的代码仓库也别发到群里。本地配置文件如果放在共享目录记得加访问权限。跑通之后你可以把常用的问答逻辑做成固定指令让机器人在群里直接响应省去每次手动输入的麻烦。