OpenClaw 接入钉钉完整指南

OpenClaw是一款开源的 AI 自动化执行框架支持多渠道接入钉钉是其中最为实用的国内办公渠道之一。通过配置 Gateway 与钉钉机器人 API你可以在钉钉群聊或私聊中直接与 OpenClaw 交互将 AI 能力无缝融入日常办公流程实现智能助理、任务自动化等功能。一、准备工作在正式开始配置之前请确认以下事项Node.js 环境已安装 Node.js ≥ 22。钉钉账号拥有一个具有企业管理员权限的钉钉账号用于创建和发布企业内部应用。部署环境可以选择本地部署Windows/MacOS/Linux或云服务器部署推荐阿里云 ECS/轻量应用服务器、UCloud 等。云部署可实现 7×24 小时稳定运行更适合企业场景。阿里云计算巢提供一键部署模板5 分钟即可完成云端部署。网络环境确保服务器可以正常访问钉钉开放平台 API。若使用代理环境建议将钉钉相关域名加入NO_PROXY白名单避免代理干扰。二、安装与启动 OpenClaw2.1 全局安装bashnpm install -g openclaw-cnlatest2.2 初始化配置bashopenclaw-cn onboard --install-daemon在初始化向导中可以暂时跳过渠道绑定后续单独配置钉钉渠道。完成上述步骤后OpenClaw Gateway 将以守护进程模式运行负责管理所有会话、协调 Agent 执行、在各渠道间路由消息。2.3 安装钉钉插件OpenClaw 本身不自带钉钉通道需要额外安装插件。有两种方式方式一推荐通过 Git URL 安装bashopenclaw-cn plugins install githttp://gitlab.alibaba-inc.com/trip/openclaw-channel-dingtalk.git方式二通过 npm 安装bashopenclaw-cn plugins install moltybob/dingtalk安装后运行以下命令确认插件已成功加载bashopenclaw-cn plugins list如果列表中显示dingtalk说明安装成功。⚠️ 重要安全提示从 OpenClaw 新版本开始需要在配置文件中显式声明信任的插件白名单。在 ~/.openclaw/openclaw.json中添加以下配置json{ plugins: { allow: [dingtalk] } }否则插件可能不会被加载。三、在钉钉开放平台创建应用有两种创建机器人应用的方式可根据实际需求选择3.1 方式一企业内部应用Stream 模式—— 推荐这种方式采用 WebSocket 长连接模式无需公网 IP部署最简便是绝大多数场景的首选。操作步骤登录钉钉开发者后台使用企业管理员账号登录。点击“应用开发” → “企业内部应用” → “创建应用”填写应用名称和描述点击保存。进入应用详情页点击“添加应用能力” → 选择“机器人”。配置机器人信息机器人名称默认使用应用名称机器人图标上传 JPG/PNG 格式、240×240px 以上、1:1 比例、2MB 以内的图片机器人简介最多 10 个字符机器人描述最多 200 字符消息接收模式选择 Stream 模式WebSocket 长连接配置完成后点击“发布”然后进入“版本管理与发布”填写版本号和版本描述确认发布。在“权限管理”中添加必要的权限成员读取权限通讯录权限发送应用消息权限发送群消息权限群会话权限在“凭证与基础信息”中获取以下关键参数Client ID对应 AppKeyClient Secret对应 AppSecretAgent ID可选但推荐填写用于发送消息在企业管理后台的“企业信息”页面获取Corp ID企业 ID。3.2 方式二自定义机器人Webhook 模式这种方式适合简单的群内消息推送场景配置相对简单但功能受限。操作步骤在 PC 端钉钉打开目标群聊 → 群设置 → 智能群助手 → 添加机器人。选择“自定义机器人”填写机器人名称。安全设置三选一推荐加签加签生成签名密钥安全性最高自定义关键词设置触发机器人的关键词IP 白名单限制请求来源 IP勾选同意相关条款点击完成。记录生成的Webhook URL和加签密钥如选择加签方式。安全建议生产环境强烈推荐使用企业内部应用Stream 模式相比自定义机器人具有更完善的权限控制和安全性。四、配置 OpenClaw 钉钉渠道4.1 企业内部应用配置推荐使用交互式配置最简单bashopenclaw-cn onboard在向导中选择 DingTalk 渠道依次输入 Client ID、Client Secret、Corp ID、Robot Code 等信息即可完成配置。或手动编辑~/.openclaw/openclaw.jsonjson{ channels: { dingtalk: { enabled: true, clientId: your-app-key, clientSecret: your-app-secret, corpId: your-corp-id, robotCode: your-robot-code, agentId: your-agent-id, dmPolicy: open, groupPolicy: open, messageType: markdown } } }配置项说明clientId/clientSecret从钉钉开发者后台获取的 AppKey 和 AppSecretcorpId企业 ID在管理后台的“企业信息”页面查看robotCode机器人的唯一标识在机器人配置页面获取agentId应用的 Agent ID可选但推荐填写dmPolicy私聊策略open表示允许所有人私聊也可设为allowlist限制白名单groupPolicy群聊策略同上messageType消息格式建议使用markdownenabled是否启用该渠道4.2 自定义机器人配置Webhook 模式json{ channels: { dingtalk: { enabled: true, webhook: https://oapi.dingtalk.com/robot/send?access_tokenxxxx, secret: your-custom-bot-secret } } }4.3 配置代理如适用若部署环境需通过代理访问外网可在配置中添加代理设置json{ channels: { dingtalk: { enabled: true, clientId: your-app-key, clientSecret: your-app-secret, proxy: http://proxy.local:8080 } } }同时建议设置环境变量避免钉钉相关域名走代理bashexport NO_PROXYdingtalk.com,.dingtalk.com,api.dingtalk.com,wss-open-connection.dingtalk.com4.4 配置大模型 API可选但推荐OpenClaw 本身不自带大模型能力需要配置外部模型 API 来实现智能回复。推荐配置阿里云千问大模型或免费 Coding Plan APIbashopenclaw-cn config set models.default.provider qwen openclaw-cn config set models.default.apiKey your-qwen-api-key4.5 保存并重启 Gateway完成配置后重启 Gateway 使配置生效bashopenclaw-cn gateway restart五、验证接入5.1 检查渠道状态bashopenclaw-cn channels list若配置正确钉钉渠道应显示为已连接状态。5.2 查看连接日志bashopenclaw-cn logs看到类似如下日志说明钉钉已成功连接text[dingtalk] Connected to DingTalk server5.3 钉钉端测试私聊测试在钉钉中搜索你创建的机器人发送消息如“你好”验证是否收到回复。群聊测试将机器人添加到群聊中机器人发送消息。5.4 频率限制说明钉钉自定义机器人有调用频率限制每个机器人每分钟最多发送 20 条消息到群里。如果超过限制会限流 10 分钟。建议对于大量消息发送的场景如系统监控告警将信息整合后以 Markdown 摘要形式发送。六、深度集成与技能扩展6.1 Skills 技能系统OpenClaw 的 Skills 技能系统是其核心扩展机制可以让 AI 从“能说会道”变为“能说会做”。通过安装不同的 Skill你可以让钉钉助理执行以下任务日常办公生成日报、整理会议纪要、处理 PDF 文件数据查询查询天气、获取新闻、分析 Excel 表格自动化操作定时任务推送、文件处理、代码生成团队协作多群消息同步、知识库问答安装 Skill 示例bashopenclaw-cn skills install email # 安装邮件处理技能 openclaw-cn skills install pdf # 安装 PDF 处理技能你也可以通过对话直接告诉 OpenClaw“从技能商店安装天气查询技能”OpenClaw 会自动完成搜索、下载与安装。Skills 的加载遵循优先级顺序工作区技能 本地技能 内置技能同名技能按优先级覆盖。每个 Skill 需包含SKILL.md说明文件方可被正确加载。6.2 钉钉 MCP 集成进阶如果你希望 OpenClaw 获得钉钉的操作能力如日程预约、AI 表格操作等可以接入钉钉 MCP 服务。钉钉 MCP 广场提供 100 精选 MCP 能力覆盖从基础办公到垂直行业全场景。接入步骤访问钉钉 MCP 广场使用企业管理员账号登录搜索并选择需要的 MCP 服务如“钉钉日历”“钉钉通讯录”等点击“获取 MCP Server 服务配置”复制 MCP Server URL在 OpenClaw 对话中直接粘贴 URLOpenClaw 会自动安装使用示例配置完成后在钉钉中直接对话“帮我查一下张三的 user_id”“帮我创建一个明天上午 10 点的会议邀请张三和李四”“预订一间明天下午 3 点的会议室”6.3 高级配置多群接入若需要将 OpenClaw 接入多个钉钉群可以为每个群创建独立的机器人在channels中配置多个实例json{ channels: { dingtalk: { enabled: true, instances: { sales-group: { clientId: xxx, clientSecret: yyy }, support-group: { clientId: aaa, clientSecret: bbb } } } } }6.4 支持的消息类型钉钉渠道支持以下消息类型文本消息基础文字交互Markdown 消息支持富文本格式回复互动卡片支持流式更新适用于 AI 实时输出图片/文件支持图片、语音自带识别、视频、文件等多种媒体类型七、常见问题排查7.1 插件未加载问题现象配置完成后钉钉渠道显示未连接或插件列表中找不到dingtalk。解决方案检查plugins.allow白名单是否包含dingtalk运行openclaw-cn plugins list确认插件已安装若通过向导安装的插件不完整建议手动安装源码目录的插件7.2 能私聊但不能在群里回复解决方案确认groupPolicy设置为open检查机器人是否已被添加到目标群聊中7.3 一直重连解决方案检查网络能否正常访问钉钉服务器确认 Client ID、Client Secret、Corp ID 等参数填写正确若使用代理环境设置 NO_PROXY 环境变量开启 debug 模式查看详细日志7.4 配置完成后无响应解决方案确认钉钉应用已发布仅在开发者后台发布机器人无效需同步发布应用版本检查 Gateway 是否正常运行openclaw-cn gateway status确认大模型 API 配置正确若未配置大模型OpenClaw 无法生成回复在钉钉中创建新群仅添加自己和机器人进行测试默认测试群可能屏蔽第三方机器人消息7.5 HTTP 401 或 403 错误解决方案检查 AppKey 或 AppSecret 是否填写错误确认应用权限配置完整成员读取权限、发送消息权限等检查消息接收地址 URL 格式是否正确7.6 自定义机器人无回复解决方案确认 Webhook URL 中的 access_token 正确无误若选择加签方式确认 secret 已正确配置检查安全设置关键词触发/IP 白名单是否限制了消息接收7.7 配置文件语法错误OpenClaw 使用 JSON5 格式的配置文件支持注释和更宽松的语法但仍需确保 JSON 格式正确。建议使用 JSON 校验工具检查配置文件。八、安全最佳实践使用企业内部应用Stream 模式相比自定义机器人企业内部应用具有更完善的权限控制和安全性。谨慎保管凭证Client Secret、加签密钥等敏感信息切勿暴露或提交到公开代码仓库。配置访问控制生产环境中建议将dmPolicy和groupPolicy设为allowlist仅允许指定成员或群聊触发指令。环境隔离避免在具有根权限的环境下运行 OpenClaw建议使用普通用户权限运行。定期更新定期更新 OpenClaw 和插件版本获取最新的安全修复和功能改进。使用插件白名单通过plugins.allow显式声明信任的插件防止加载未经授权的插件。九、总结通过以上步骤你可以将 OpenClaw 成功接入钉钉实现以下核心价值全场景办公联动在钉钉群聊/私聊中 机器人远程控制 OpenClaw随时随地执行办公任务自然语言交互发送自然语言指令AI 自动理解并执行双向消息互通OpenClaw 可通过钉钉发送通知、结果、文件权限可控支持企业级权限配置保障办公安全无论是个人日常办公还是团队协作场景OpenClaw 钉钉的集成方案都能有效提升办公效率让 AI 真正成为你的专属智能助理。如果在配置过程中遇到任何问题建议开启 debug 模式查看详细日志或在 OpenClaw 社区中寻求帮助。