OpenClaw 钉钉机器人配置指南(macOS)
第一步:安装 Node.js
OpenClaw 需要 Node.js 22 或更高版本。推荐使用 nvm 安装:
安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.zshrc
安装 Node.js LTS 版本
nvm install 22
node -v # 验证
第二步:安装 OpenClaw
使用 npm 全局安装:
npm install -g openclaw@latest
如果网络慢,可先配置国内镜像源:
npm config set registry https://registry.npmmirror.com
第三步:运行配置向导(onboard)
执行初始化向导,建议选择 Manual 模式,以便后续手动控制:
openclaw onboard --install-daemon
在向导中:
- 确认个人使用提示 → Yes
- 选择 Manual 模式
- 选择 Local gateway(本机)
- 接受默认工作空间路径
- 模型提供商:选择 Qwen(通义千问),并完成 OAuth 或输入 API Key
- 默认模型:保持 qwen-portal/coder-model
- 网关端口:默认 18789
- 网关绑定:Loopback (127.0.0.1)(仅本机访问)
- 网关认证:Token(自动生成)
- 配置聊天频道:选择 No(稍后手动配置钉钉)
- 配置技能:选择 No(稍后根据需要安装)
- 启用钩子:选择 Skip for now
- 网关服务已安装:选择 Restart
- 孵化机器人:选择 Do this later(稍后可通过 openclaw dashboard 或 openclaw tui 启动)
完成后,OpenClaw 核心服务已运行。
第四步:安装钉钉插件
使用官方推荐的钉钉插件包(由社区维护):
openclaw plugins install @soimy/dingtalk
如果遇到权限错误(EACCES),修复 npm 缓存所有权:
sudo chown -R 501:20 ~/.npm
如果安装过程中依赖安装失败(如 dingtalk-stream 缺失),可手动进入插件目录安装:
cd ~/.openclaw/extensions/dingtalk
npm install
第五步:将钉钉插件加入信任白名单
编辑配置文件 ~/.openclaw/openclaw.json,在 plugins 部分添加:
{


