7、接入对接钉钉

对接钉钉

钉钉是国内使用最广泛的企业办公平台之一,OpenClaw 支持通过钉钉机器人进行交互。本节将介绍如何配置钉钉机器人对接 OpenClaw。

安装钉钉插件

首先安装钉钉插件,输入以下命令直接运行 openclaw 插件安装命令,openclaw 会自动处理下载、安装依赖和注册。时间有可能比较久,等待即可

openclaw plugins install https://github.com/soimy/clawdbot-channel-dingtalk.git

创建钉钉应用

登录钉钉开放平台,点击「创建应用」

注意:创建钉钉应用需要你的钉钉账号有开发者权限。如果没有,可以联系组织管理员获取,或参考获取开发者权限

在应用开发的左侧导航栏中,点击「钉钉应用」,然后点击右上角「创建应用」。

填写应用名称和应用描述,上传应用图标后保存。

添加机器人

在应用开发的左侧导航栏中,点击「添加应用能力」,然后点击添加「机器人」。

添加完机器人之后,就是配置一些基本信息之后,点击发布。

最后得消息接受模式一定要是 stream 模式

发布版本

在发布完机器人之后,一定要发布版本。在应用开发的左侧导航栏中,点击「版本管理与发布」,然后点击右上角「创建新版本」。

获取凭证信息

发布版本成功之后,点击左侧菜单的「凭证与基础信息」,获取以下凭证信息

  • Client ID (AppKey)

  • Client Secret (AppSecret)

  • Robot Code (与 Client ID 相同)

  • Agent ID (应用 ID)

Corp ID (企业 ID)

添加钉钉配置

找到 openclaw.json 配置文件。使用下面的命令找到配置文件

find / | grep openclaw.json

# 本人服务器的输出如下,每个人都不一样,按实际情况找
#/root/.openclaw/openclaw.json.bak
#/root/.openclaw/openclaw.json.bak.1
#/root/.openclaw/openclaw.json // 这个就是配置文件
#/root/.openclaw/openclaw.json.bak.2

然后找到对应的 channels 配置

然后找到对应的 channels 配置

{
   
  "channels": {
   
    "dingtalk": {
   
      "enabled": true,
      "clientId": "dingxxxxxx",
      "clientSecret": "your-app-secret",
      "robotCode": "dingxxxxxx",
      "corpId": "dingxxxxxx",
      "agentId": "123456789",
      "dmPolicy": "open",
      "groupPolicy": "open",      
      "messageType": "markdown",       
      "debug": false
    }
  }
}

如果你找不到对应的配置,也不用担心,使用下面的命令配置也是可以的

openclaw config set channels.dingtalk.enabled true

openclaw config set channels.dingtalk.clientId 你的 Client ID

openclaw config set channels.dingtalk.clientSecret 你的 Client Secret

openclaw config set channels.dingtalk.robotCode Robot Code (与 Client ID 相同)

openclaw config set channels.dingtalk.corpId 你的corpId

openclaw config set channels.dingtalk.agentId Agent ID

openclaw config set channels.dingtalk.dmPolicy open

openclaw config set channels.dingtalk.groupPolicy open

openclaw config set channels.dingtalk.messageType markdown

openclaw config set channels.dingtalk.debug false

配置完成之后,重启服务

openclaw gateway restart

测试机器人

回到钉钉客户端软件,在顶部搜索栏目搜索机器人名称 openclaw

点击机器人就可以直接跟机器人聊天了。可以输入 Hello

常见问题 FAQ

OpenClaw 和 Clawdbot、Moltbot 是什么关系?

OpenClaw 是该项目的最新正式名称。项目最初叫 Clawdbot,后因商标问题更名为 Moltbot,最终在 2025 年 1 月正式定名为 OpenClaw。三者是同一个项目的不同阶段命名。

OpenClaw 支持哪些 AI 模型?

OpenClaw 支持多种 AI 模型服务商,包括 Anthropic Claude、OpenAI GPT、通义千问(Qwen)、KIMI、小米 MiMo 等。本教程使用通义千问是因为其免费额度充足,适合入门学习。

为什么安装时提示 npm install failed?

这通常是服务器内存不足导致的。新版本脚本对内存要求较高,2G 内存可能会出现 OOM(内存溢出)。建议配置 swap 交换空间,将硬盘空间作为虚拟内存使用。

OpenClaw 可以在 Windows 或 macOS 上运行吗?

可以。OpenClaw 支持 Mac、Windows 和 Linux 系统。本教程以 Linux 为例,其他系统的安装方式可参考官方文档

钉钉机器人配置后无法收到消息怎么办?

请检查以下几点:

  1. 确认钉钉插件已正确安装(clawdbot plugins install @openclaw-china/channels

  2. 检查 Client ID 和 Client Secret 配置是否正确

  3. 确认已申请 Card.Streaming.WriteCard.Instance.Write 权限

  4. 检查机器人消息接收地址是否正确配置

  5. 确保服务器 18789 端口对外开放

  6. 确保应用版本已发布

OpenClaw 数据安全吗?

OpenClaw 运行在你自己的服务器上,所有数据都在本地存储,不会上传到第三方云端。但由于它具有系统级权限,建议在独立的服务器上部署,避免在生产环境或重要数据的机器上运行。

除了钉钉,OpenClaw 还支持哪些平台?

OpenClaw 支持多个聊天平台,包括飞书、企业微信、QQ、WhatsApp、Telegram、Discord、Slack、Microsoft Teams、Signal、iMessage、Google Chat、Twitch 等。每个平台需要安装对应的插件。国内平台推荐使用 @openclaw-china/channels 插件。

OpenClaw 可以做什么?

OpenClaw 可以执行多种任务:

  • 邮件管理和自动回复

  • 日程安排和提醒

  • 浏览网页和数据提取

  • 文件读写和管理

  • 执行 Shell 命令

  • 编写和运行代码

  • 数据查询和分析

如何更新 OpenClaw 到最新版本?

使用以下命令更新:

openclaw update

OpenClaw 命令和 clawdbot 命令有什么区别?

OpenClaw 更名后,官方推荐使用 openclaw 命令,但为了兼容性,clawdbot 命令仍然可用。两者功能完全相同,建议新用户直接使用 openclaw 命令。

评论交流

文档目录