1. 为什么要在钉钉里跑本地 AI 智能体钉钉是很多团队每天待得最久的工具消息、审批、日程都在里面。如果能把本地跑的 AI 智能体接进钉钉等于给整个组织配了一个随时在线的助手查资料、写文案、解释代码、整理会议纪要直接在聊天窗口里完成不用再切浏览器、切终端。OpenClaw 是一个可以在本地 Windows 上运行的智能体框架它通过 Gateway 管理各种聊天渠道钉钉就是其中一个渠道。把钉钉和 OpenClaw 打通之后你在钉钉里 一下机器人消息会经由钉钉开放平台推送到你本地的 OpenClaw智能体处理完再把回复发回钉钉。整条链路里模型调用这一层可以统一走 TaoToken 的 Key这样你换模型、换渠道都不用改一堆配置。这篇面向的是想在企业 IM 内跑通本地 AI 助手的开发者。我会把钉钉开发者后台创建应用、配置机器人、OpenClaw 安装钉钉渠道插件、填凭证、保存配置、发消息验证这一整条链路拆开讲每一步都给到可复制的配置项和验证动作。跟着做完你应该能从后台一路跑到消息互通。适合谁有钉钉组织管理权限、能在本机装 OpenClaw、想用统一 Key 调模型的开发者。不需要你懂钉钉的底层协议但需要你愿意动手点几下后台、改一个 config.toml。2. 前置准备TaoToken Key 与 OpenClaw 环境在碰钉钉后台之前先把本地和 Key 这两件事弄利索不然后面排查问题会分不清是钉钉的锅还是模型的锅。2.1 拿到 TaoToken 的统一 KeyTaoToken 是一个模型调用入口你在这里生成一个 Key就能在 OpenClaw 里调用多种模型不用为每个模型单独配一套凭证。入口在这里官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 地址https://taotoken.net/api登录之后进控制台创建 API Key路径是 console 里的 api-keys 页面控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleAPI Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keys创建完把 Key 复制出来形如sk-xxxx先存到本地一个临时文件里。注意这个 Key 等同于你的调用凭证别贴到公开仓库或者截图发群里。2.2 确认 OpenClaw 和 Gateway 状态打开 OpenClaw Windows 客户端看顶部 Gateway 状态。正常应该是「在线」或者绿色标识。如果显示离线点一下重启等它回到在线再继续。Gateway 是 OpenClaw 的消息中枢钉钉渠道插件装完之后它可能会自动重启一次这是正常现象。顺手确认一下你的钉钉账号在目标组织里并且你有创建应用的权限。没有权限的话后台的「立即创建」按钮可能是灰的或者创建完看不到凭证。2.3 钉钉侧要准备的东西你需要一个钉钉组织企业并且以管理员或有应用创建权限的账号登录开发者后台。个人版钉钉有时候权限受限建议用企业组织来测。开发者后台地址钉钉开发者后台https://open-dev.dingtalk.com钉钉开放平台https://open.dingtalk.com这两个入口都行开发者后台更偏向应用管理开放平台更偏向文档和 API 说明。后面创建机器人走开发者后台。3. 钉钉开发者后台创建 OpenClaw 机器人应用这一章是整条链路里最容易卡住的地方因为后台的入口和字段名称偶尔会调整。我按当前能走通的路径写你对照着找。3.1 进入应用开发并创建机器人登录 https://open-dev.dingtalk.com 之后看顶部菜单找到「应用开发」。进去之后左侧一般会有「钉钉应用」「机器人」这些入口看到它们说明你进对地方了。在「钉钉应用」页面里通常会有一个一键创建 OpenClaw 机器人应用的提示栏右侧有「立即创建」。点它。这个入口的好处是帮你预置好机器人所需的能力省得你手动去勾选应用类型和机器人权限。如果没看到这个提示栏也可以走手动路径新建应用 → 选择「机器人」类型 → 在应用能力里开启机器人。手动路径要自己确认消息接收模式建议选 Stream 模式长连接这样本地 OpenClaw 不需要公网 IP 也能收消息。3.2 填写机器人基本信息弹窗里会让你填几项字段说明建议机器人名称显示在钉钉聊天里的名字例如「小钉」「OpenClaw 助手」机器人简介一句话描述例如「本地 AI 协作助手」机器人图标默认或自定义先用默认跑通再换填完点「确定」机器人就创建好了。这一步不会消耗什么额度放心点。3.3 复制 Client ID 和 Client Secret创建完成后页面会展示两项凭证Client ID也就是以前的 AppKeyClient Secret也就是以前的 AppSecret点右侧复制按钮把两个值都存下来。Client Secret 是敏感信息别截图公开也别提交到 Git。后面 OpenClaw 里要填的就是这两个值。注意钉钉官方文档里明确说过Client ID 可理解为原来的 AppKeyClient Secret 可理解为原来的 AppSecret。如果你看到旧教程写 AppKey/AppSecret对应关系就是这两个。3.4 确认机器人消息接收模式在机器人配置页里找到消息接收方式。如果你打算让本地 OpenClaw 直接收消息选 Stream 模式。这个模式下钉钉会通过长连接把消息推给你本地的客户端不需要你暴露公网地址也不需要配回调 URL。对本地智能体来说这是最省事的方案。如果你选了 HTTP 回调模式那就得自己准备一个公网可访问的地址还要处理签名校验复杂度高不少。本地跑 OpenClaw 的场景优先 Stream。4. OpenClaw 侧安装钉钉渠道并写入 config.toml钉钉后台那边凭证拿到了接下来回到 OpenClaw 把渠道接上。4.1 安装钉钉渠道插件打开 OpenClaw Windows进「设置」→「聊天配置」找到钉钉DingTalk卡片。如果卡片上出现「安装插件」按钮说明当前安装包没有内置钉钉渠道需要先装连接器插件。点「安装插件」等进度到 100%出现「安装完成」提示。安装过程中 Gateway 可能会自动重启等几秒弹窗提示可以关闭了再点「关闭」。如果网络慢别中途退出等日志不再滚动再操作。4.2 config.toml 骨架把 TaoToken Key 和钉钉凭证放进去OpenClaw 的配置可以写在 config.toml 里。下面是一个骨架你按自己的实际值替换。重点是模型这一层统一走 TaoToken钉钉渠道填后台拿到的 Client ID 和 Client Secret。# OpenClaw 配置骨架 # 模型层统一走 TaoToken [model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoTokenKey model gpt-4o-mini # 按需换成你账号可用的模型 # 钉钉渠道 [channels.dingtalk] enabled true client_id 你的ClientID # 对应钉钉后台的 AppKey client_secret 你的ClientSecret # 对应钉钉后台的 AppSecret receive_mode stream # 本地场景建议 stream # Gateway [gateway] auto_restart true几个要点base_url填https://taotoken.net/api不要带多余路径。api_key就是你在 api-keys 页面创建的那个。model字段填你账号下可用的模型名不确定就先填一个通用的跑通再换。钉钉的client_id/client_secret一定不要有多余空格复制的时候容易带上换行。如果你更习惯在图形界面里填也可以在钉钉渠道卡片里直接粘贴 Client ID 和 Client Secret效果一样。config.toml 的好处是方便版本管理和批量改。4.3 保存渠道配置并确认开关不管你是改 config.toml 还是在界面里填最后都要让钉钉渠道处于启用状态。界面里确认右上角开关是打开的状态显示「已配置」。然后点「保存渠道配置」。保存后如果没立即生效点 OpenClaw 顶部的「重启」等 Gateway 回到在线状态再测。5. 验证请求从钉钉发一条消息看回复配置写完不算完得真发一条消息验证整条链路。5.1 在钉钉里找到机器人并发消息回到钉钉客户端搜索你刚创建的机器人名称打开会话发一句简单的比如「你好帮我列三条今天的工作建议」。如果一切正常几秒内你会收到 OpenClaw 的回复。5.2 用 curl 单独验证 TaoToken 这一层如果钉钉没回复先别急着怀疑钉钉单独测一下模型层通不通。用 curl 直接打 TaoToken 的接口curl https://taotoken.net/api/chat/completions \ -H Authorization: Bearer sk-你的TaoTokenKey \ -H Content-Type: application/json \ -d { model: gpt-4o-mini, messages: [{role: user, content: ping}] }如果这个能返回内容说明 Key 和模型层没问题问题在钉钉渠道或 OpenClaw 配置。如果这个报 401那就是 Key 错了或者没生效回 api-keys 页面重新确认。5.3 看 Gateway 日志确认消息流向OpenClaw 的 Gateway 日志会记录消息进来和出去的过程。发消息的时候盯着日志看有没有收到钉钉推送的消息事件有没有发起模型调用有没有把回复发回钉钉哪一步断了问题就在哪。比如日志里完全没有钉钉事件那就是渠道没连上有事件但没有模型调用那是模型配置的问题。6. 本篇常见错排查下面这些是我在配置过程中遇到过的、以及社区里问得比较多的坑按可能性从高到低排。6.1 保存后机器人不回复优先查这几项OpenClaw 顶部 Gateway 是否在线。钉钉渠道开关是否打开。Client ID 和 Client Secret 是否复制完整前后有没有空格。插件安装后是否等 Gateway 重启完成。是否点了「保存渠道配置」。当前钉钉账号是否在创建机器人的那个组织里。6.2 提示凭证无效或 401多半是 Client Secret 复制错了或者复制的时候带上了空格、换行。重新回钉钉后台复制一次粘贴到 OpenClaw 里注意别多带字符。如果确认凭证没问题检查一下机器人应用是否已经发布或启用有些组织需要走一下发布流程。6.3 模型调用报错但钉钉渠道正常这种就是 TaoToken 这一层的问题。先确认base_url是https://taotoken.net/api没有多余斜杠。再确认api_key是有效的、没被删除。模型名如果填错也会报错换一个你账号下确定可用的模型名试试。6.4 插件安装卡住或失败网络慢的时候插件下载会卡。别中途退出等日志不再滚动。如果一直失败检查本机网络是否能正常访问插件源必要时重启 OpenClaw 再装一次。6.5 消息能收到但回复很慢可能是模型本身响应慢也可能是 Gateway 在处理队列。先换一个更轻量的模型试试如果快了那就是模型选择的问题。如果还是慢看 Gateway 日志里模型调用的耗时。7. 接下来怎么用模型对话、Coding Plan 与文档链路跑通之后你可以按用途分流想直接在网页里试模型效果用模型对话https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite长期写代码、跑 Agent 任务看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite接入细节和参数说明查接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite管理 Key 和额度回 API Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite如果你用的是 Claude Code 这类工具Anthropic 兼容入口在这里https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude-code-anthropicutm_campaignrewrite钉钉这边跑通之后你其实可以把同一套 OpenClaw 配置复用到其他渠道模型层不用动只换渠道凭证就行。这也是统一 Key 的好处渠道换来换去模型调用这一层始终是一个入口。