整个配置流程可以分为两大部分

openclaw 中文openclaw 2026-04-09 1

以下是详细的步骤指南：

整个配置流程可以分为两大部分-第1张图片-OpenClaw下载中文-AI中文智能体

第一部分：在钉钉开放平台配置机器人

在首页点击“应用开发” -> “企业内部开发” -> “机器人”。
点击“创建应用”。
填写应用信息：
- 应用名称：“公司AI助手” 或 “OpenClaw机器人”。
- 应用描述：按需填写。
- 应用图标：上传一个易于识别的图标。
创建完成后,进入应用详情页。

在应用详情页,找到“机器人”功能模块，点击“启用”。
配置机器人基本信息：
- 消息接收模式：选择“回调地址（Outgoing）”，这是最关键的一步，它允许钉钉将消息转发给你的OpenClaw服务。
- 机器人描述：可选填写。

在应用详情页的“凭证与基础信息”部分，记录以下信息，稍后需要在OpenClaw中填写：

回到“机器人”配置页面，在“消息接收地址”栏填写你的OpenClaw服务提供的钉钉回调URL。
- 格式通常为：https://你的OpenClaw域名或IP:端口/dingtalk/callback
- 例如：https://openclaw.your-company.com:8080/dingtalk/callback
重要：此地址必须能被互联网访问（钉钉服务器需要能POST消息到此地址），如果你在本地或内网，需要使用内网穿透工具（如ngrok, frp, 钉钉开发者工具自带穿透）提供一个临时公网地址。
点击“验证”或“保存”时，钉钉会向该地址发送一个带有加密签名的验证请求。此时需要OpenClaw服务已启动并正确配置，才能验证通过，如果未配置，可以先保存地址，稍后在OpenClaw中完成配置后再回来点击“验证”。

在“权限管理”中，为机器人添加必要的通讯权限，
- 聊天消息发送权限 (im:chat:asyncsend_v2)
- 群消息读取权限 (im:chatbot:read)
- 通讯录成员信息读取权限 (contact:user:read) – 如果需要@某人功能或识别用户身份。
配置完成后,在“版本管理与发布”中，将应用发布到线上，发布后，才能在企业内安装使用。

在配置页面中,填入从钉钉开放平台获取的凭证：

回调Token (token)：在钉钉机器人“消息接收”设置中，有一个“加签”或“Token”设置，你可以启用并设置一个Token，或者使用钉钉提供的默认Token（在“回调地址”设置附近）。这个Token需要和OpenClaw配置的一致。
加密密钥 (aes_key)：同上，如果你启用了加签模式，会有一个AES密钥，如果未启用，可能不需要填或填固定值。
AppKey: 填入之前记录的 AppKey。
AppSecret: 填入 AppSecret。
AgentId: 填入 AgentId。
CorpId: 填入 CorpId。
回调URL：这里通常显示的是OpenClaw服务自身监听的、用于接收钉钉回调的地址和路径，确保它与你在钉钉后台填写的完全一致。

保存配置后,OpenClaw服务可能会自动重启相关服务。
在OpenClaw后台,寻找 “测试连接” 或 “同步组织架构” 按钮，点击测试，看是否能成功与钉钉通信。
可以尝试在已添加机器人的钉钉群里发送一条消息（如“@机器人你好”），观察OpenClaw后台的“对话日志”或“消息日志”是否有收到请求，并检查机器人是否正常回复。

回调URL验证失败：
- 网络不通：确保 你的OpenClaw域名:端口 能从公网访问，使用 curl 或在线端口检测工具检查。
- 路径错误：确认OpenClaw的钉钉回调路径 (/dingtalk/callback) 是否正确，查看OpenClaw的文档或代码。
- 服务未运行：重启OpenClaw服务。
- Token/AES Key不匹配：确保钉钉后台和OpenClaw后台配置的Token、AES Key完全一致（包括启用/禁用状态）。
机器人能收到消息但不回复：
- 检查OpenClaw后台的“AI模型”配置是否正确，额度是否充足。
- 查看OpenClaw的应用日志，通常在 logs/ 目录下，看是否有错误信息。
- 检查钉钉机器人的权限是否包含发送消息。
安全问题：
- 强烈建议在正式环境中使用 HTTPS。
- 妥善保管 AppSecret、AES Key 等敏感信息。
内网开发：
- 强烈推荐使用钉钉官方提供的开发者工具进行内网穿透，它专为钉钉回调设计，非常稳定。