openClaw 接入钉钉教程

简介

openClaw（曾用名ClawdBot，Moltbot）是一个 AI 网关工具，可以将大模型接入各种即时通讯软件，实现类似 ChatGPT 的对话体验。

github地址：https://github.com/openclaw/openclaw

前置准备

一台电脑（Mac/Windows/Linux）
钉钉账号

一、安装 openClaw

Mac/Linux


bash
#安装很简单，具体可以参考https://github.com/openclaw/openclaw
npm install -g openclaw@latest
# or: pnpm add -g openclaw@latest
openclaw onboard --install-daemon

安装过程中的选项

接受风险提示：选 Yes
初始化配置模式：选 Quick Start
选择大模型：选 Qwen（免费且量大，如果有glm，minimax,或者cc都可以配置）
登录 Qwen：浏览器自动打开，确认登录
Channel 配置：选 Skip for Now（后续手动配置钉钉）
Skill 配置：选 No（后续可添加）
Hooks 配置：选 Skip for Now
运行方式：选 TUI (recommended)

安装完成

浏览器会自动打开 Web UI：http://127.0.0.1:18789

这一步其实我们可以把github地址丢给claude code或者其他ai cli工具直接让ai帮你安装

二、安装钉钉插件


bash
openclaw plugins install https://github.com/soimy/clawdbot-channel-dingtalk.git
cd ~/.clawdbot/extensions/dingtalk/
npm install zod

三、创建钉钉应用

1. 登录钉钉开发者后台

访问：https://open-dev.dingtalk.com/

2. 创建应用

点击"应用开发" → 创建应用 → 填写应用名称和描述

3. 配置机器人（重要！）

点击左侧"机器人" → "机器人配置"
填写基本信息
将消息接收模式改成 Stream 模式（关键步骤）
点击发布

4. 获取凭证信息

点击"凭证与基础信息"，复制以下信息：

字段	说明	格式
Client ID (AppKey)	应用客户端ID	`dingxyzxxx...`
Client Secret (AppSecret)	应用密钥	点击"查看"获取
Robot Code	机器人编码	与 Client ID 相同
Corp ID	企业ID	`dingabcdefg...`
Agent ID	应用ID	纯数字，如 `1234567`

Corp ID 查找位置

如果应用页面没有显示 Corp ID：

开发者后台首页 → 右上角点企业名称 → 企业信息

四、配置 openclaw

编辑配置文件：


bash
vim ~/.openclaw/openclaw.json

在最后一个 } 之前加入：


json
"channels": {
  "dingtalk": {
    "enabled": true,
    "clientId": "改成你的Client ID",
    "clientSecret": "改成你的Client Secret",
    "robotCode": "改成你的Robot Code（与clientId相同）",
    "corpId": "改成你的Corp ID（企业ID）",
    "agentId": "改成你的Agent ID",
    "dmPolicy": "open",
    "groupPolicy": "open",
    "debug": false
  }
}

参数说明：

dmPolicy: 私聊策略，open 表示所有人都可以私聊
groupPolicy: 群聊策略，open 表示所有群都可以使用
debug: 是否开启调试模式

五、重启服务


bash
openclaw gateway restart

检查状态：


bash
# 查看状态
openclaw gateway status

# 查看日志
openclaw gateway logs

六、使用机器人

私聊方式

打开钉钉（手机或电脑端）
搜索框搜索机器人名称
进入对话，直接发送消息

群聊方式

打开群聊设置
智能群助手 → 添加机器人
找到你的应用并添加
在群里 @机器人名称 发送消息

修改配置

1、修改~/.openclaw/openclaw.json文件 2、也可以直接在浏览器的channels里修改

七、远程访问（内网穿透）

如果需要在外网访问本地 Clawdbot（大部分时候其实通过钉钉，微信，飞书机器人下达命令即可），可以使用以下方案：

方案1: cpolar

优势：cpolar 国内速度快，配置简单。

1. 安装 cpolar


bash
# macOS
brew tap cpolar/cpolar && brew install cpolar

# Linux
curl -L https://www.cpolar.com/static/downloads/release-release/cpolar-stable-linux-amd64.zip -o cpolar.zip
unzip cpolar.zip
sudo mv cpolar /usr/local/bin/

2. 注册并登录

访问 https://dashboard.cpolar.com/ 注册账号，获取 Authtoken。


bash
cpolar authtoken <你的token>

3. 启动 cpolar 隧道


bash
cpolar http 18789

会显示外部访问 URL，如：https://abc123.cpolar.cn

方案 2：frp（需要云服务器）

服务器端（云服务器）：


bash
wget https://github.com/fatedier/frp/releases/download/v0.52.3/frp_0.52.3_linux_amd64.tar.gz
tar -xzf frp_0.52.3_linux_amd64.tar.gz
cd frp_0.52.3_linux_amd64

cat > frps.ini << 'EOF'
[common]
bind_port = 7000
token = 你的密码
EOF

./frps -c frps.ini

本地客户端：


bash
wget https://github.com/fatedier/frp/releases/download/v0.52.3/frp_0.52.3_darwin_amd64.tar.gz
tar -xzf frp_0.52.3_darwin_amd64.tar.gz
cd frp_0.52.3_darwin_amd64

cat > frpc.ini << 'EOF'
[common]
server_addr = 你的云服务器IP
server_port = 7000
token = 你的密码

[clawdbot]
type = tcp
local_ip = 127.0.0.1
local_port = 18789
remote_port = 18789
EOF

./frpc -c frpc.ini

方案 3：Tailscale（免费，最简单）


bash
brew install tailscale
sudo tailscale up

Mac 和服务器都安装后，通过 Tailscale IP 访问。

方案 4：Cloudflare Tunnel（免费，需要域名，具体可以参考企微接入教程里有详细步骤）


bash
brew install cloudflared
cloudflared tunnel login
cloudflared tunnel create clawdbot

注意事项

⚠️ 安全风险

Clawdbot 需要完全的文件访问权限 - 可以执行命令、读写文件
远程访问会暴露本机服务 - 存在被攻击的风险
建议：
- 不要在有敏感数据的电脑上运行
- 使用 Docker 隔离运行
- 设置强密码/token
- 限制访问来源 IP

常见问题

1. 找不到机器人

确认应用已发布
确认机器人配置已启用（Stream 模式）
检查 openclaw 运行状态：openclaw gateway status
查看日志排查：openclaw gateway logs

2. 消息发送无响应

检查配置文件中各 ID 是否正确
确认 enabled 为 true
重启服务：openclaw gateway restart

3. Corp ID 和 Agent ID 混淆

Corp ID 是企业ID，格式如 dingabcdefg...
Agent ID 是应用ID，纯数字如 1234567
两者不是同一个值

参考文档

Clawdbot 官方文档：https://docs.molt.bot/
钉钉开放平台：https://open-dev.dingtalk.com/
钉钉插件 GitHub：https://github.com/soimy/clawdbot-channel-dingtalk

openClaw 接入钉钉教程

简介

openClaw（曾用名ClawdBot，Moltbot）是一个 AI 网关工具，可以将大模型接入各种即时通讯软件，实现类似 ChatGPT 的对话体验。

github地址：https://github.com/openclaw/openclaw

前置准备

一台电脑（Mac/Windows/Linux）
钉钉账号

一、安装 openClaw

Mac/Linux


bash
#安装很简单，具体可以参考https://github.com/openclaw/openclaw
npm install -g openclaw@latest
# or: pnpm add -g openclaw@latest
openclaw onboard --install-daemon

安装过程中的选项

接受风险提示：选 Yes
初始化配置模式：选 Quick Start
选择大模型：选 Qwen（免费且量大，如果有glm，minimax,或者cc都可以配置）
登录 Qwen：浏览器自动打开，确认登录
Channel 配置：选 Skip for Now（后续手动配置钉钉）
Skill 配置：选 No（后续可添加）
Hooks 配置：选 Skip for Now
运行方式：选 TUI (recommended)

安装完成

浏览器会自动打开 Web UI：http://127.0.0.1:18789

这一步其实我们可以把github地址丢给claude code或者其他ai cli工具直接让ai帮你安装

二、安装钉钉插件


bash
openclaw plugins install https://github.com/soimy/clawdbot-channel-dingtalk.git
cd ~/.clawdbot/extensions/dingtalk/
npm install zod

三、创建钉钉应用

1. 登录钉钉开发者后台

访问：https://open-dev.dingtalk.com/

2. 创建应用

点击"应用开发" → 创建应用 → 填写应用名称和描述

3. 配置机器人（重要！）

点击左侧"机器人" → "机器人配置"
填写基本信息
将消息接收模式改成 Stream 模式（关键步骤）
点击发布

4. 获取凭证信息

点击"凭证与基础信息"，复制以下信息：

字段	说明	格式
Client ID (AppKey)	应用客户端ID	`dingxyzxxx...`
Client Secret (AppSecret)	应用密钥	点击"查看"获取
Robot Code	机器人编码	与 Client ID 相同
Corp ID	企业ID	`dingabcdefg...`
Agent ID	应用ID	纯数字，如 `1234567`

Corp ID 查找位置

如果应用页面没有显示 Corp ID：

开发者后台首页 → 右上角点企业名称 → 企业信息

四、配置 openclaw

编辑配置文件：


bash
vim ~/.openclaw/openclaw.json

在最后一个 } 之前加入：


json
"channels": {
  "dingtalk": {
    "enabled": true,
    "clientId": "改成你的Client ID",
    "clientSecret": "改成你的Client Secret",
    "robotCode": "改成你的Robot Code（与clientId相同）",
    "corpId": "改成你的Corp ID（企业ID）",
    "agentId": "改成你的Agent ID",
    "dmPolicy": "open",
    "groupPolicy": "open",
    "debug": false
  }
}

参数说明：

dmPolicy: 私聊策略，open 表示所有人都可以私聊
groupPolicy: 群聊策略，open 表示所有群都可以使用
debug: 是否开启调试模式

五、重启服务


bash
openclaw gateway restart

检查状态：


bash
# 查看状态
openclaw gateway status

# 查看日志
openclaw gateway logs

六、使用机器人

私聊方式

打开钉钉（手机或电脑端）
搜索框搜索机器人名称
进入对话，直接发送消息

群聊方式

打开群聊设置
智能群助手 → 添加机器人
找到你的应用并添加
在群里 @机器人名称 发送消息

修改配置

1、修改~/.openclaw/openclaw.json文件 2、也可以直接在浏览器的channels里修改

七、远程访问（内网穿透）

如果需要在外网访问本地 Clawdbot（大部分时候其实通过钉钉，微信，飞书机器人下达命令即可），可以使用以下方案：

方案1: cpolar

优势：cpolar 国内速度快，配置简单。

1. 安装 cpolar


bash
# macOS
brew tap cpolar/cpolar && brew install cpolar

# Linux
curl -L https://www.cpolar.com/static/downloads/release-release/cpolar-stable-linux-amd64.zip -o cpolar.zip
unzip cpolar.zip
sudo mv cpolar /usr/local/bin/

2. 注册并登录

访问 https://dashboard.cpolar.com/ 注册账号，获取 Authtoken。


bash
cpolar authtoken <你的token>

3. 启动 cpolar 隧道


bash
cpolar http 18789

会显示外部访问 URL，如：https://abc123.cpolar.cn

方案 2：frp（需要云服务器）

服务器端（云服务器）：


bash
wget https://github.com/fatedier/frp/releases/download/v0.52.3/frp_0.52.3_linux_amd64.tar.gz
tar -xzf frp_0.52.3_linux_amd64.tar.gz
cd frp_0.52.3_linux_amd64

cat > frps.ini << 'EOF'
[common]
bind_port = 7000
token = 你的密码
EOF

./frps -c frps.ini

本地客户端：


bash
wget https://github.com/fatedier/frp/releases/download/v0.52.3/frp_0.52.3_darwin_amd64.tar.gz
tar -xzf frp_0.52.3_darwin_amd64.tar.gz
cd frp_0.52.3_darwin_amd64

cat > frpc.ini << 'EOF'
[common]
server_addr = 你的云服务器IP
server_port = 7000
token = 你的密码

[clawdbot]
type = tcp
local_ip = 127.0.0.1
local_port = 18789
remote_port = 18789
EOF

./frpc -c frpc.ini

方案 3：Tailscale（免费，最简单）


bash
brew install tailscale
sudo tailscale up

Mac 和服务器都安装后，通过 Tailscale IP 访问。

方案 4：Cloudflare Tunnel（免费，需要域名，具体可以参考企微接入教程里有详细步骤）


bash
brew install cloudflared
cloudflared tunnel login
cloudflared tunnel create clawdbot

注意事项

⚠️ 安全风险

Clawdbot 需要完全的文件访问权限 - 可以执行命令、读写文件
远程访问会暴露本机服务 - 存在被攻击的风险
建议：
- 不要在有敏感数据的电脑上运行
- 使用 Docker 隔离运行
- 设置强密码/token
- 限制访问来源 IP

常见问题

1. 找不到机器人

确认应用已发布
确认机器人配置已启用（Stream 模式）
检查 openclaw 运行状态：openclaw gateway status
查看日志排查：openclaw gateway logs

2. 消息发送无响应

检查配置文件中各 ID 是否正确
确认 enabled 为 true
重启服务：openclaw gateway restart

3. Corp ID 和 Agent ID 混淆

Corp ID 是企业ID，格式如 dingabcdefg...
Agent ID 是应用ID，纯数字如 1234567
两者不是同一个值

参考文档

Clawdbot 官方文档：https://docs.molt.bot/
钉钉开放平台：https://open-dev.dingtalk.com/
钉钉插件 GitHub：https://github.com/soimy/clawdbot-channel-dingtalk

OpenClaw钉钉接入教程

openClaw 接入钉钉教程

简介

前置准备

一、安装 openClaw

Mac/Linux

安装过程中的选项

安装完成

二、安装钉钉插件

三、创建钉钉应用

1. 登录钉钉开发者后台

2. 创建应用

3. 配置机器人（重要！）

4. 获取凭证信息

Corp ID 查找位置

四、配置 openclaw

五、重启服务

六、使用机器人

私聊方式

群聊方式

修改配置

七、远程访问（内网穿透）

方案1: cpolar

1. 安装 cpolar

2. 注册并登录

3. 启动 cpolar 隧道

方案 2：frp（需要云服务器）

方案 3：Tailscale（免费，最简单）

方案 4：Cloudflare Tunnel（免费，需要域名，具体可以参考企微接入教程里有详细步骤）

注意事项

⚠️ 安全风险

常见问题

1. 找不到机器人

2. 消息发送无响应

3. Corp ID 和 Agent ID 混淆

参考文档

评论

OpenClaw钉钉接入教程

openClaw 接入钉钉教程

简介

前置准备

一、安装 openClaw

Mac/Linux

安装过程中的选项

安装完成

二、安装钉钉插件

三、创建钉钉应用

1. 登录钉钉开发者后台

2. 创建应用

3. 配置机器人（重要！）

4. 获取凭证信息

Corp ID 查找位置

四、配置 openclaw

五、重启服务

六、使用机器人

私聊方式

群聊方式

修改配置

七、远程访问（内网穿透）

方案1: cpolar

1. 安装 cpolar

2. 注册并登录

3. 启动 cpolar 隧道

方案 2：frp（需要云服务器）

方案 3：Tailscale（免费，最简单）

方案 4：Cloudflare Tunnel（免费，需要域名，具体可以参考企微接入教程里有详细步骤）

注意事项

⚠️ 安全风险

常见问题

1. 找不到机器人

2. 消息发送无响应

3. Corp ID 和 Agent ID 混淆

参考文档

评论