一、官方手册
https://docs.openclaw.ai/zh-CN/install/docker
二、下载源码并添加.env 文件
去github上下载openclaw源码包,并上传服务器家目录下
https://github.com/openclaw/openclaw/releases/tag/v2026.4.11
在家目录下执行以下命令:
bash
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)
bash
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文件,需要重启容器
bash
# 方式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、配置企业微信
bash
# 确保在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技能
bash
# 方式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配置项
bash
# CLI配对的作用:保证进入容器后能执行openclaw命令,例如openclaw logs
# 去除plugins.allow作用:保证 openclaw device list能执行
openclaw device list
openclaw devices approve 配对请求id