OpenClaw和钉钉机器人打通

钉钉插件安装与配置完整指南

钉钉插件安装详细步骤

首先，我们来完成钉钉插件的安装。打开终端或命令行窗口，输入以下安装命令：

openclaw plugins install @dingtalk-real-ai/dingtalk-connector

执行此命令后，系统将自动完成以下操作：从官方仓库下载最新版钉钉连接器插件，解析并安装所有必要的依赖包，最终在您的OpenClaw系统中注册该插件。整个过程自动化执行，通常只需数十秒即可完成安装。

钉钉插件配置方法详解

方法一：编辑配置文件进行设置

配置钉钉插件最常用的方式是直接修改系统配置文件。使用您熟悉的文本编辑器打开配置文件：

vim ~/.openclaw/openclaw.json

在配置文件中，定位或添加钉钉连接器的配置区块。请注意，下方的示例代码展示的是飞书配置的结构，您需要将其中的飞书参数替换为从钉钉开放平台获取的实际配置信息，特别是`appId`和`appSecret`：

"channels": {
    "feishu": {
        "enabled": true,
        "appId": "你的ID",
        "appSecret": "你的密钥",
        "domain": "feishu",
        "groupPolicy": "open",
        "chunkMode": "length",
        "allowFrom": ["a","*"],
        "connectionMode": "websocket",
        "dmHistoryLimit": 2,
        "dmPolicy": "open",
        "groupCommandMentionBypass": "always",
        "renderMode": "auto",
        "topicSessionMode": "enabled"
    }
},
"gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "lan",
    "controlUi": {
        "enabled": true,
        "allowedOrigins": ["http://localhost:18789", "http://127.0.0.1:18789", "http://192.168××××18789"],
        "dangerouslyAllowHostHeaderOriginFallback": true,
        "allowInsecureAuth": true,
        "dangerouslyDisableDeviceAuth": true
    },
    "auth": {
        "mode": "token",
        "token": "你的token"
    },
    "tailscale": {
        "mode": "off",
        "resetOnExit": false
    },
    "nodes": {
        "denyCommands": ["camera.snap", "camera.clip", "screen.record", "calendar.add", "contacts.add", "reminders.add"]
    }
},

核心配置参数详细说明

以下关键配置项需要您特别注意和正确填写：

clientId / clientSecret：这两个参数相当于钉钉插件的身份凭证和访问密钥，必须从钉钉官方开放平台获取。具体获取路径为：访问钉钉开放平台官网，登录后进入「应用开发」>「企业内部开发」>「小程序或H5微应用」，在应用详情页即可找到对应的AppKey和AppSecret。

gatewayToken：此令牌是网关连接鉴权的关键，其值必须与上方配置中 gateway.auth.token 字段的值完全一致，任何差异都会导致连接失败。

sessionTimeout：该参数定义了会话的有效时长，默认设置为30分钟（即1800000毫秒）。如果您的业务场景需要更长的持续对话，可以根据实际需求适当延长此数值。

重启网关服务使配置生效

完成所有配置的修改并保存文件后，必须重启OpenClaw网关服务才能使新的钉钉设置生效。执行以下重启命令：

openclaw gateway restart

命令执行后请耐心等待，当您在终端中观察到服务成功启动、端口正常监听的输出日志时，即表示网关服务已重启完成。

验证钉钉插件安装结果

最后，我们需要确认钉钉插件是否已成功安装并启用。运行插件列表查询命令：

openclaw plugins list

如果安装和配置均正确无误，您将在输出的插件列表中找到如下条目：

@dingtalk-real-ai/dingtalk-connector (已加载)

当您看到插件状态显示为“已加载”时，恭喜您！钉钉连接器插件的安装与基础配置工作已全部顺利完成，您现在可以开始进行与企业微信或钉钉机器人的对接与集成测试了。