OpenClaw和钉钉机器人打通

2026-05-06阅读 0热度 0

钉钉

钉钉插件安装与配置指南

钉钉插件安装步骤

先来搞定安装。打开你的终端或命令行工具，直接执行下面这条命令：

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

命令敲下回车后，系统就会自动处理所有的事情：从官方源拉取最新的插件包，解析并安装所有必需的依赖项，最后一步是在你的OpenClaw系统中完成插件的注册。整个过程一气呵成，通常很快就能完成。

钉钉配置设置

方式一：通过配置文件修改

配置插件有多种方式，最常用的就是直接修改配置文件。用你顺手的编辑器（比如vim）打开它：

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：这是插件的“身份证”和“钥匙”，必须从钉钉官方开发者后台获取。具体路径是：登录钉钉开放平台，进入「应用开发」>「企业内部应用」，选择你对应的应用，就能找到这两个关键凭证。

gatewayToken：这个令牌至关重要，必须与上面配置中 gateway.auth.token 字段的值完全保持一致，否则无法建立连接。

sessionTimeout：会话超时时间，默认是30分钟（即1800000毫秒）。如果你有长会话需求，可以根据实际情况适当调大这个值。

重启Gateway服务

配置保存好之后，要让改动生效，必须重启Gateway服务。执行这条重启命令：

openclaw gateway restart

稍等片刻，直到你在终端里看到类似下图的成功启动输出，就表示服务重启完成了。

验证安装

最后一步，我们来验收一下成果。运行插件列表检查命令：

openclaw plugins list

如果一切顺利，你会在输出列表中清晰地看到：

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

看到这个状态，就恭喜你了，钉钉插件的安装和基础配置已经全部完成，可以开始后续的对接和使用了。