OpenClaw 安装配置及钉钉接入完整教程
一、前置准备
1. 环境要求（推荐配置）
- 操作系统：Rocky Linux/CentOS 7+/Ubuntu 20.04+（云服务器/本地服务器均可）
- 基础依赖：Docker + Docker Compose（推荐容器化部署，避免环境冲突）
- 网络：服务器需有公网IP，开放 80/443/3000 端口（或自定义端口）
- 账号：
- 阿里云/腾讯云等云服务器账号（可选，本地部署需内网穿透）
- 钉钉企业管理员账号（用于创建内部应用）
- Anthropic Claude API Key（或 OpenAI API Key，OpenClaw 支持多模型）
2. 依赖安装（以 CentOS/Rocky Linux 为例）
# 1. 安装Docker（一键脚本）
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun# 2. 启动Docker并设置开机自启
systemctl start docker
systemctl enable docker# 3. 安装Docker Compose
curl -L "https://github.com/docker/compose/releases/download/v2.24.6/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose# 4. 验证安装
docker --version
docker-compose --version## 二、OpenClaw 安装部署（容器化方式，新手首选）
### 1. 克隆代码仓库
创建工作目录
mkdir -p /opt/openclaw && cd /opt/openclaw
克隆官方仓库（以最新地址为准）
git clone https://github.com/openclaw/openclaw.git .
可选：切换到稳定版本
git checkout v1.0.0
### 2. 配置核心参数
复制示例配置文件并修改关键参数（API Key、端口等）：
复制配置模板
cp config.example.yaml config.yaml
编辑配置文件
vim config.yaml
修改以下核心配置项（其余保持默认即可）：
基础配置
server:
port: 3000 # OpenClaw 服务端口，后续钉钉要对接这个端口
host: 0.0.0.0 # 允许所有IP访问
AI 模型配置（二选一即可，Claude 推荐）
llm:
type: "claude" # 可选：claude/gpt/qwen
apiKey: "你的Claude API Key" # 替换为实际API Key
baseUrl: "https://api.anthropic.com" # Claude 官方地址
model: "claude-3-5-sonnet-20240620" # 模型版本
钉钉对接预配置（先留空，后续填钉钉应用信息）
connectors:
dingtalk:
enabled: false # 先设为false，配置完钉钉后改为true
appKey: "" # 后续从钉钉开放平台获取
appSecret: "" # 后续从钉钉开放平台获取
agentId: "" # 后续从钉钉开放平台获取
token: "" # 自定义随机字符串（比如生成32位随机数）
aesKey: "" # 钉钉应用的加密密钥（可选，非必填）
webhookPath: "/dingtalk/webhook" # 钉钉回调路径
### 3. 启动 OpenClaw 服务
启动容器（后台运行）
docker-compose up -d
查看服务状态（确保没有报错）
docker-compose logs -f
验证服务是否启动成功（返回JSON即正常）
curl http://localhost:3000/health
## 三、钉钉应用配置（关键步骤）
### 1. 登录钉钉开放平台
访问 钉钉开放平台 → 登录企业管理员账号 → 进入「应用开发」→「企业内部应用」→「创建应用」。
### 2. 创建钉钉机器人应用
应用类型：选择「机器人」
应用名称：OpenClaw AI 助手（自定义）
应用描述：基于 OpenClaw 的智能执行机器人
开发方式：选择「自定义开发」→ 点击「创建」
### 3. 获取钉钉应用核心参数
创建成功后，在「应用详情」→「开发配置」中记录以下参数（后续填到 OpenClaw 配置里）：
AppKey：应用唯一标识
AppSecret：应用密钥（点击查看需验证）
AgentId：应用代理 ID（在「基础信息」→「应用功能」→「机器人」中查看）
### 4. 配置钉钉应用权限与回调
权限管理：在「权限管理」中添加以下必要权限（避免功能受限）：
消息通知权限：chat:bot:send（机器人发送消息）
群会话权限：chat:read（读取群消息）
个人会话权限：user:message:read（读取私聊消息）
事件订阅：在「开发配置」→「事件订阅」中配置：
消息接收地址：http://你的服务器公网IP:3000/dingtalk/webhook（OpenClaw 的钉钉回调地址）
加解密配置：
Token：自定义随机字符串（和 OpenClaw 配置中的 token 一致）
数据加密密钥：随机生成（可选，填到 OpenClaw 的 aesKey 中）
订阅事件：勾选「机器人接收到的消息」（bot_message）
### 5. 发布钉钉应用
在「版本管理与发布」中，点击「发布上线」→ 选择「企业内发布」→ 确认发布（仅企业内成员可使用）。
## 四、OpenClaw 对接钉钉（完成最后配置）
### 1. 更新 OpenClaw 配置文件
重新编辑 /opt/openclaw/config.yaml，完善钉钉对接参数：
```yaml
connectors:dingtalk:enabled: true # 改为true，启用钉钉对接appKey: "钉钉应用的AppKey" # 替换为实际值appSecret: "钉钉应用的AppSecret" # 替换为实际值agentId: "钉钉应用的AgentId" # 替换为实际值（数字字符串）token: "你在钉钉事件订阅中设置的Token" # 保持一致aesKey: "钉钉应用的加密密钥" # 可选，无则留空webhookPath: "/dingtalk/webhook"
2. 重启 OpenClaw 服务
运行
# 重启容器使配置生效
docker-compose restart# 查看日志，确认钉钉对接成功（无报错即正常）
docker-compose logs -f
五、测试验证
1. 添加钉钉机器人
打开钉钉客户端 → 进入任意群聊 / 私聊 → 点击「设置」→「添加机器人」→ 找到你发布的「OpenClaw AI 助手」→ 添加。
2. 发送测试指令
在钉钉聊天框中发送以下指令，验证 OpenClaw 响应：
# 基础文本测试
你好，介绍一下自己# 任务执行测试
帮我生成一份本周工作周报模板# 工具调用测试
查询今天的天气（需确保OpenClaw配置了天气插件）
3. 验证结果
若钉钉能收到 OpenClaw 的回复，说明对接成功；
若无响应，检查：
服务器端口是否开放（3000 端口需在防火墙 / 安全组中放行）；
钉钉回调地址是否正确（公网 IP + 端口 + 路径）；
OpenClaw 配置的钉钉参数是否和开放平台一致；
Docker 容器日志是否有报错（docker-compose logs -f）。
六、常见问题排查
1.钉钉回调验证失败：
检查 token/aesKey 是否和钉钉开放平台一致；
确保服务器公网可访问，3000 端口放行；
回调地址路径是否和 OpenClaw 配置的 webhookPath 一致。
2.OpenClaw 启动失败：
检查 API Key 是否有效；
确保 Docker 服务正常运行；
查看日志中的具体错误信息（如端口被占用，修改 config.yaml 中的 port）。
3.机器人无回复：
确认钉钉应用已发布上线；
检查 OpenClaw 的 llm 配置（API Key 是否正确，模型是否可用）；
验证钉钉应用权限是否已添加。
总结
1.OpenClaw 推荐用 Docker 容器化部署，避免环境依赖问题，核心配置需填写 AI 模型 API Key 和端口；
2.钉钉对接的关键是获取 AppKey/AppSecret/AgentId，并配置正确的回调地址和权限；
3.验证步骤优先检查「端口开放 → 配置参数一致性 → 服务日志」，90% 的问题都出在这三点。
