Docker安装OpenClaw

一、官方手册

https://docs.openclaw.ai/zh-CN/install/docker

二、下载源码并添加.env 文件

去github上下载openclaw源码包，并上传服务器家目录下

https://github.com/openclaw/openclaw/releases/tag/v2026.4.11

在家目录下执行以下命令：

tar -zxvf openclaw-2026.4.9.tar.gz
mv openclaw-2026.4.9 openclaw
cd ~/openclaw
touch .env
vim .env
# 在.env文件中添加以下环境变量
# 换成自己的端口，以1234为例
OPENCLAW_GATEWAY_PORT=1234   
OPENCLAW_DOCKER_APT_PACKAGES="vim"
OPENCLAW_TZ=Asia/Shanghai

三、执行构建(先加载 .env)

cd  ~/openclaw
set -a
source .env
set +a
./scripts/docker/setup.sh

这个setup.sh脚本主要干了三件事：

    检查并获取环境变量

    根据源码生成Dockerfile文件并根据这个文件生成docker镜像openclaw-gateway

    根据源码中的docker-compose.yml构建openclaw-gateway容器

四、运维

1、如果修改.openclaw/openclaw.json文件，需要重启容器

# 方式1:
docker restart xxx 
# 方式2，进入源码安装目录
cd ~/openclaw  
docker compose restart openclaw-gateway

2、如果需要通过web ui访问openclaw，按以下步骤执行

    ssh -L 1234:localhost:1234用户名@服务器ip

    在浏览器中访问http://localhost:1234，填入openclaw.json中的token，即可。

3、配置企业微信

# 确保在openclaw源码目录下
cd ~/openclaw  
docker compose run --rm -it  --entrypoint bash openclaw-cli
# npx多试几次，手动创建机器人，手动输入bot id和secret，不要扫码
npx -y @wecom/wecom-openclaw-cli install 

4、安装skill-vetter技能

# 方式1 官网下载
docker compose run --rm -it openclaw-cli skills install skill-vetter

# 方式2 指定镜像站点
docker compose run --rm -it -e CLAWHUB_REGISTRY="https://cn.clawhub-mirror.com"  openclaw-cli skills install skill-vetter

# 方式3 遇到限速限频，手动下载压缩包
# 1.去clawhub.ai网站下载zip包
# 2.上传服务器并解压：unzip skill-vetter-1.0.0.zip -d skill-vetter-1.0.0
# 3.进入容器openclaw-openclaw-gateway-1在main Agent工作区创建skills目录
# 4.复制到容器内部：
docker cp skill-vetter-1.0.0 openclaw-openclaw-gateway-1:/home/node/.openclaw/workspace/skills
# 5.和企业微信智能机器人新建会话聊天：/new

5、CLI配对，去除openclaw.json文件中的plugins.allow配置项

# CLI配对的作用：保证进入容器后能执行openclaw命令，例如openclaw logs 
# 去除plugins.allow作用：保证 openclaw device list能执行
openclaw device list
openclaw devices approve 配对请求id