OpenClaw 本地部署并接入钉钉
OpenClaw 是一款开源、可本地部署的AI智能体（AI Agent）工具，由奥地利开发者 Peter Steinberger 开发。它能“寄生”在聊天工具中，用户通过聊天发送指令，它就能直接操控电脑并完成任务，实现从“思考”到“行动”的闭环。至于它比 ChatGPT、豆包之类的强在哪？简单来说，ChatGPT 是个“陪聊”，而龙虾是个“替身”。它不仅仅是吐出文字，而是真的能接管你的电脑和软件，比如执行系统命令、浏览网页、管理文件，甚至编写代码。🦀🦀🦀
准备工作
- 第1步，资源规划
| ip地址 | 硬件配置 | OS版本 | 大模型 | 聊天工具 |
|---|---|---|---|---|
| 192.168.31.101 | 4核-8G-60G | Windows 10 企业版 x64 | 千问(阿里) | 钉钉(阿里) |
- 第2步，安装 Chrome（建议最新版本），并将其设置为默认浏览器
- 第3步，以管理员身份运行 PowerShell，安装 Node.js（建议版本 ≥ 22.x），可以加快后面 OpenClaw 的安装速度
#.下载安装
$ProgressPreference = 'SilentlyContinue'
Invoke-WebRequest -Uri "http://iso.sqlfans.cn/windows/node-v22.22.1-x64.msi" -OutFile "node-v22.22.1-x64.msi"
.\node-v22.22.1-x64.msi
#.退出会话并确认版本
exit
node -v
- 第4步，以管理员身份运行 PowerShell，安装 Git（建议版本 v2.53.0），可以加快后面 OpenClaw 的安装速度
#.下载安装
$ProgressPreference = 'SilentlyContinue'
Invoke-WebRequest -Uri "http://iso.sqlfans.cn/windows/Git-2.53.0.2-64-bit.exe" -OutFile "Git-2.53.0.2-64-bit.exe"
.\Git-2.53.0.2-64-bit.exe /silent
#.退出会话并确认版本
exit
git version
配置大模型 千问
- 登录 千问 注册账号
安装 OpenClaw
- 第1步，以管理员身份运行 PowerShell，安装 OpenClaw（请逐行执行）
注：一键安装会自动检测或安装 Node.js v24.14.0、Git v2.53.0、OpenClaw latest
#.一键安装
iwr -useb https://openclaw.ai/install.ps1 | iex
#.若一键安装报错则参考如下
$ProgressPreference = 'SilentlyContinue'
Set-MpPreference -DisableRealtimeMonitoring $true
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass -Force
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
echo "iwr -useb https://openclaw.ai/install.ps1 -OutFile install.ps1" > save.ps1
.\save.ps1
.\install.ps1
- 第2步，通过 ↑ ↓ ← → 键进行选择，这里 大模型选择 千问，由于默认没有钉钉插件，配置插件的时候选择了 Skip for now（稍后设置）
T OpenClaw onboarding
|
o I understand this is ****** Continue? 询问是否知道风险，通过 ← → 键，选择 Yes
| Yes
|
o Onboarding mode 初始化配置模式，示例选择 QuickStart（快速开始）
| QuickStart
|
o Model/auth provider 配置AI模型提供商，示例选择 Qwen
| Qwen
|
o Starting Qwen OAuth…|
o Qwen OAuth -------------------------------------------------------------------------+
| |
| Open https://chat.qwen.ai/authorize?user_code=M4SZK5QW&client=qwen-code to approve | 浏览器打开并点击“确认”登录
| access. |
| If prompted, enter the code M4SZK5QW. |
| |
+--------------------------------------------------------------------------------------+
|
o Default model 配置默认模型，示例选择 Keep current (qwen-portal/coder-model)
| Keep current (qwen-portal/coder-model)
|
o Select channel (QuickStart) 配置聊天工具，默认没有钉钉插件，示例选择 Skip for now（稍后设置）
| Skip for now
|
o Search provider 配置搜索引擎，示例选择 Skip for now（稍后设置）
| Skip for now
|
o Configure skills now? (recommended) 是否现在配置skills，示例选择 No
| No
|
o Enable hooks? 是否启用 hooks，示例选择 session-memory
| session-memory
|
o How do you want to hatch your bot? 如何训练机器人，示例选择 Open the Web UI
| Open the Web UI
|
— Onboarding complete. Use the dashboard link above to control OpenClaw.
- 第3步，若选择 Open the Web UI 则会自动打开 OpenClaw 控制台（亦可执行 openclaw dashboard 打开它），可以进行对话测试
配置IM工具 钉钉
- 第1步，登录 钉钉开发者平台，创建应用
- 第2步，填写应用名称及应用描述，示例 OpenClaw
- 第3步，添加应用能力，选择 机器人
- 第4步，打开“机器人配置”，填写信息，把消息接收模式改成 Stream 模式，然后“发布”
- 第5步，创建新版本并发布，示例应用版本号 1.0.0
对接 OpenClaw 和钉钉
- 第1步，通过 npm 安装钉钉插件
# 安装钉钉插件
openclaw plugins install @soimy/dingtalk
# 确认插件已安装
openclaw plugins list | findstr dingtalk
- 第2步，登录 钉钉开发者平台，复制应用凭证的 Client ID 及 Client Secret等信息，后面与 OpenClaw 关联会用到
注：若前面关掉了机器人配置页面，可参考这里 找回钉钉应用凭证信息
- 第3步，执行 openclaw configure --section channels 配置 channel 频道（即聊天工具）
PS C:\Users\Administrator> openclaw configure --section channels
T OpenClaw configure
|
o Where will the Gateway run? 哪里运行网关服务，示例选择 Local（本机）
| Local (this machine)
|
o Channels 如何配置频道，示例选择 配置链接
| Configure/link
|
o Select a channel 配置聊天工具，示例选择 钉钉
| DingTalk (钉钉)
|
o Client ID (AppKey) 配置钉钉的 Client ID，请将 112233 替换为您的 Client ID
| 112233
|
o Client Secret (AppSecret) 配置钉钉的 Client Secret，请将 445566 替换为您的 Client Secret
| 445566
|
o Configure robot code, corp ID, and agent ID? 是否配置其他，示例选择 Yes
| Yes
|
o Robot Code 配置钉钉的 Robot Code，该值与 Client ID 一致
| 112233
|
o Corp ID 配置钉钉的 Corp ID，请将 123456 替换为您的 Corp ID
| 123456
|
o Agent ID 配置钉钉的 Agent ID，请将 654321 替换为您的 Agent ID
| 654321
|
o Enable AI interactive card mode? 是否启用AI交互卡模式，示例选择 No
| No
|
o Direct message policy 配置私聊策略，示例选择 Open（完全开放）
| Open - anyone can DM
|
o Media URL allowlist 配置允许通过mediaUrl下载的白名单，示例选择 0.0.0.0/0（全网开放）
| 0.0.0.0/0
|
o Group message policy 配置群聊策略，示例选择 Open（完全开放）
| Open - any group can use bot
|
* Configure runtime reconnect cycle limit? 是否配置最大重连间隔，示例选择 Yes
| Yes
|
o Max runtime reconnect cycles 配置最大重连间隔，示例选择 10
| 10
|
o Configure inbound media max size in MB? 配置接收文件大小上限，示例选择 No（默认5MB）
| No
|
o Select a channel 配置聊天工具，示例选择 Finished（配置完成）
| Finished
|
— Configure complete.
- 第3步，确认配置文件（openclaw.json）中
"channels": { ... }中的内容
附：完整的配置说明，可参考 https://github.com/soimy/openclaw-channel-dingtalk?tab=readme-ov-file
type .\.openclaw\openclaw.json
- 第4步，重启网关服务
#.重启网关服务
openclaw gateway restart
#.诊断问题并确认服务已运行
openclaw doctor
openclaw gateway status
- 第5步，打开钉钉客户端，搜索 OpenClaw 并进行对话。至此，OpenClaw 顺利配置完成
遇到的问题
- 问题1：若安装 OpenClaw 窗口一闪而过，则如下方式可将错误输出到当前窗口
echo "iwr -useb https://openclaw.ai/install.ps1 -OutFile install.ps1" > save.ps1
.\save.ps1
.\install.ps1
- 问题2：若安装 OpenClaw 报错 iwr：请求被中止：未能创建 SSL/TLS 安全通道，可临时指定 TLS 1.2 协议版本
# 临时指定TLS协议版本并重试
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
iwr -useb https://openclaw.ai/install.ps1 | iex
- 问题3：若安装 OpenClaw 报错 此脚本包含恶意内容，已被你的防病毒软件阻止，可设置允许当前用户运行自定义的 PowerShell 脚本
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass -Force
- 问题4：若安装 OpenClaw 报错 无法成功完成操作，因为文件包含病毒或潜在的垃圾软件，则建议临时关闭 Windows Defender 的实时监控，重启后自动恢复
Set-MpPreference -DisableRealtimeMonitoring $true
- 问题5：若安装 OpenClaw 报错 npm error code 128，更换好一点的网络或者重试几遍，或者配置 git 将 ssh 协议替换为 https
# 替换git协议并重试
git config --global url."https://".insteadOf ssh://
iwr -useb https://openclaw.ai/install.ps1 | iex
- 问题6：若 PowerShell 下载文件速度特别慢，则把显示进度的功能关掉就能提升几十倍效率
$ProgressPreference = 'SilentlyContinue'
Invoke-WebRequest -Uri "http://iso.sqlfans.cn/github/Git-2.53.0.2-64-bit.exe" -OutFile "Git-2.53.0.2-64-bit.exe"