OpenClaw部署记录

kamisamak 发布于 2026-01-22 13 次阅读


使用 Docker Compose 部署 OpenClaw 及 三方频道服务

本文为使用 Docker Compose 部署 OpenClaw 的记录。

1. 下载配置文件

首先从 GitHub 拉取最新的 docker-compose.yml 和环境变量示例文件:

# 下载配置文件
wget https://raw.githubusercontent.com/justlovemaki/OpenClaw-Docker-CN-IM/main/docker-compose.yml
wget https://raw.githubusercontent.com/justlovemaki/OpenClaw-Docker-CN-IM/main/.env.example

2. 配置环境变量

复制一份 .env 文件,按里面的注释修改需要的配置参数:

cp .env.example .env
vim .env

3. 修改安全协议配置

新版修改了安全协议,为了防止每次登录都需要做反向代理,可以直接修改本地配置。

找到数据目录下的 openclaw.json 文件,在 gateway/controlUi 节点下添加以下配置:

"dangerouslyDisableDeviceAuth": true

修改完成后,使用 docker-compose up -d 启动容器。

4. 设备配对与基础设置

容器启动后,首次访问时会提示:“此设备需要网关主机的配对批准。”
这时候需要进入 Docker 容器内部通过认证,并顺便关闭沙箱模式。

# 进入容器内部(假设容器名为 openclaw)
docker exec -it openclaw bash

# 列出当前的设备请求列表
openclaw devices list

# 批准对应的设备请求(将 <requestId> 替换为 list 命令输出的实际 ID)
openclaw devices approve <requestId>

# 关闭沙箱模式
openclaw config set agents.defaults.sandbox.mode off

5. 接入 QQ 机器人 / Telegram / Matrix

继续在容器内部执行以下命令,安装社区的 QQBot 插件并绑定机器人:

# 1. 安装 OpenClaw 开源社区 QQBot 插件
openclaw plugins install @sliverp/qqbot@latest

# 2. 配置绑定当前 QQ 机器人
openclaw channels add --channel qqbot --token "1903189625:Q9tePBxkXL9yoeVME6zsmgbXTQNLJIHH"

# 3. 重启本地 OpenClaw 服务使配置生效
openclaw gateway restart

归档

## 使用 Docker 部署 OpenClaw

### 1. 交互式初始化配置
```bash
docker run --rm -it -v /mnt/tool/docker-container/openclaw/data:/root/.openclaw 1186258278/openclaw-zh:latest openclaw onboard
```
*按向导完成:选择模型 → 配置 API 密钥 → 设置聊天通道*

### 2. 配置网关模式
```bash
docker run --rm -v /mnt/tool/docker-container/openclaw/data:/root/.openclaw 1186258278/openclaw-zh:latest openclaw config set gateway.mode local
docker run --rm -v /mnt/tool/docker-container/openclaw/data:/root/.openclaw 1186258278/openclaw-zh:latest openclaw config set gateway.bind lan
docker run --rm -v /mnt/tool/docker-container/openclaw/data:/root/.openclaw 1186258278/openclaw-zh:latest openclaw config set gateway.auth.token SWKB5EvvCCFb7MCrwkwDS8X
```

### 3. 启动(守护进程模式)
```bash
docker run -d --name openclaw -p 18789:18789 -v /mnt/tool/docker-container/openclaw/data:/root/.openclaw --restart unless-stopped 1186258278/openclaw-zh:latest openclaw gateway run
```

### 4. 设备配对与认证审批
进入 Docker 容器审批设备:
```bash
root@16b1ab51e12d:/app# openclaw devices list
root@16b1ab51e12d:/app# openclaw devices approve 53cfca91-5439-4e86-82e5-10ccea04b993
```

### 5. 本地端口转发 (SSH Tunnel)
```bash
ssh -N -f -L 18789:127.0.0.1:18789 root@192.168.100.1
```

此作者没有提供个人介绍。
最后更新于 2026-03-22