# OpenClaw Docker 部署 + 钉钉集成完整指南

一、环境准备

1.1 服务器要求

操作系统：Linux (CentOS/RHEL/Ubuntu)
Docker 和 Docker Compose 已安装
服务器 IP：192.168.1.186

1.2 检查 Docker 版本

docker --versiondocker compose version

二、部署 OpenClaw

2.1 创建项目目录

mkdir -p ~/openclawcd ~/openclaw

2.2 创建 .env 配置文件

nano .env

内容：

# ============ 镜像配置 ============OPENCLAW_IMAGE=ghcr.io/openclaw/openclaw:latest# ============ 端口配置 ============OPENCLAW_GATEWAY_PORT=18789OPENCLAW_GATEWAY_BIND=lanOPENCLAW_BRIDGE_PORT=18790# ============ 安全配置 ============OPENCLAW_GATEWAY_TOKEN=2046bd7b76888fbfc4cec46c4a36af4bf22f5ecf3f51a5d5013d2806ac83a785# ============ 时区 ============OPENCLAW_TZ=Asia/Shanghai# ============ 数据目录 ============OPENCLAW_CONFIG_DIR=./configOPENCLAW_WORKSPACE_DIR=./workspace# ============ 网络配置 ============OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=true

2.3 创建 docker-compose.yml

nano docker-compose.yml

内容：

version: ”3.8”services: openclaw: image: ${OPENCLAW_IMAGE} container_name: openclaw user: ”1000:1000” restart: unless-stopped ports: - ”${OPENCLAW_GATEWAY_PORT}:${OPENCLAW_GATEWAY_PORT}” - ”${OPENCLAW_BRIDGE_PORT}:${OPENCLAW_BRIDGE_PORT}” volumes: - ${OPENCLAW_CONFIG_DIR}:/home/node/.openclaw - ${OPENCLAW_WORKSPACE_DIR}:/workspace environment: TZ: ${OPENCLAW_TZ} NODE_ENV: production OPENCLAW_GATEWAY_PORT: ${OPENCLAW_GATEWAY_PORT} OPENCLAW_GATEWAY_BIND: ${OPENCLAW_GATEWAY_BIND} OPENCLAW_GATEWAY_TOKEN: ${OPENCLAW_GATEWAY_TOKEN} OPENCLAW_GATEWAY_CONTROL_UI_ALLOWINSECUREAUTH: ”true” OPENCLAW_GATEWAY_CONTROL_UI_ALLOWED_ORIGINS: ”http://192.168.1.186:${OPENCLAW_GATEWAY_PORT},http://localhost:${OPENCLAW_GATEWAY_PORT},http://127.0.0.1:${OPENCLAW_GATEWAY_PORT}” OPENCLAW_PUBLIC_GATEWAY_URL: ”ws://192.168.1.186:${OPENCLAW_GATEWAY_PORT}” OPENCLAW_ALLOW_INSECURE_PRIVATE_WS: ${OPENCLAW_ALLOW_INSECURE_PRIVATE_WS} command: > openclaw gateway --port ${OPENCLAW_GATEWAY_PORT} --bind ${OPENCLAW_GATEWAY_BIND} --allow-unconfigured --auth token --token ${OPENCLAW_GATEWAY_TOKEN} healthcheck: test: [”CMD”, ”curl”, ”-s”, ”http://127.0.0.1:${OPENCLAW_GATEWAY_PORT}/health”] interval: 30s timeout: 10s retries: 3 logging: driver: json-file options: max-size: 100m max-file: ”3” openclaw-cli: image: ${OPENCLAW_IMAGE} container_name: openclaw-cli user: ”1000:1000” restart: unless-stopped volumes: - ${OPENCLAW_CONFIG_DIR}:/home/node/.openclaw - ${OPENCLAW_WORKSPACE_DIR}:/workspace environment: TZ: ${OPENCLAW_TZ} NODE_ENV: production OPENCLAW_GATEWAY_PORT: ${OPENCLAW_GATEWAY_PORT} OPENCLAW_GATEWAY_TOKEN: ${OPENCLAW_GATEWAY_TOKEN} command: [”sh”, ”-c”, ”tail -f /dev/null”] logging: driver: json-file options: max-size: 100m max-file: ”3”

2.4 创建数据目录并设置权限

mkdir -p config workspacesudo chown -R 1000:1000 config workspacesudo chmod -R 755 config workspace

2.5 开放防火墙端口

# CentOS/RHELsudo firewall-cmd --permanent --add-port=18789/tcpsudo firewall-cmd --reload# Ubuntusudo ufw allow 18789/tcp

2.6 启动服务

docker compose up -d

2.7 验证服务

docker compose pscurl http://127.0.0.1:18789/health

2.8 访问 Web 界面

浏览器访问：http://192.168.1.186:18789/?token=2046bd7b76888fbfc4cec46c4a36af4bf22f5ecf3f51a5d5013d2806ac83a785

三、配置钉钉机器人

3.1 钉钉开发者平台准备

3.2 进入容器

docker exec -it openclaw /bin/bash

3.3 搜索并安装钉钉插件

# 搜索钉钉插件openclaw plugins search dingtalk# 安装官方钉钉插件openclaw plugins install clawhub:@dingtalk-real-ai/dingtalk-connector

3.4 一键配置钉钉（扫码授权）

npx -y @dingtalk-real-ai/dingtalk-connector install

执行后会显示二维码，用钉钉手机 App扫码授权。

看到 ✔ Success! Bot configured. 表示配置成功。

3.5 退出容器并重启

exitdocker compose restart openclaw

3.6 验证钉钉连接

docker compose logs openclaw | grep -i dingtalk

应该看到 connected":true 表示连接成功。

四、验证与测试

4.1 在钉钉中测试

4.2 查看消息日志

docker compose logs openclaw | grep -i ”dingtalk\|message”

五、常用管理命令

# 进入项目目录cd ~/openclaw# 查看服务状态docker compose ps# 查看日志docker compose logs -f openclaw# 重启服务docker compose restart openclaw# 停止服务docker compose down# 启动服务docker compose up -d# 进入容器docker exec -it openclaw /bin/bash# 查看钉钉插件状态docker exec -it openclaw openclaw plugins list | grep -i ding# 查看频道列表docker exec -it openclaw openclaw channels list

六、常见问题排查

七、访问地址

以上就是完整的安装和配置流程！如有问题，随时告诉我。