使用 OpenClaw 官方 Docker 镜像

这是最快捷、最干净的方式,完全绕过系统库限制。

1. 安装 Docker(如果尚未安装)

curl -fsSL https://get.docker.com | bash
systemctl start docker
systemctl enable docker

2. 拉取并运行 OpenClaw 官方镜像

# 创建持久化配置目录
mkdir -p ~/openclaw

修改所有者为 UID 1000(容器内 node 用户的 UID)

sudo chown -R 1000:1000 ~/openclaw

拉取镜像

docker pull ghcr.io/openclaw/openclaw:latest

启动容器(后台运行,自动重启修改了映射端口,尽量规避攻击)

docker run -d --name openclaw --restart unless-stopped -p 8700:18789 -v ~/openclaw:/home/node/.openclaw  ghcr.io/openclaw/openclaw:latest

3. 执行初始化配置

# 进入容器交互式执行 onboard
docker exec -it openclaw openclaw onboard

按照提示完成模型、通道等配置。

4. 获取访问令牌

grep token ~/openclaw/openclaw.json

5.配置openclaw.json

"bind": "lan",#主要是这里

"gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "lan",
    "controlUi": {
      "allowedOrigins": [
        "*"
      ]
    },

docker exec -it openclaw openclaw doctor --fix
docker restart openclaw

6. 访问 Web 界面

然后浏览器访问

http://127.0.0.1:8700/#token=

输入令牌登录。


7.使用容器内的 openclaw 命令

列出待批准设备

docker exec -it openclaw openclaw devices list


Pending (1)
┌──────────────────────────────────────┬
│ Request │
├──────────────────────────────────────┼
│ d5387100-8538-49ce-b546-a860256f4977 │
└──────────────────────────────────────┴
复制这个request中的地址进行批准

docker exec -it openclaw openclaw devices approve d5387100-8538-49ce-b546-a860256f4977

刷新浏览器就可以访问了。

8.飞书

飞书配置好以后也需要批准,让openclaw去做就可以。
自己操作:

docker exec -it openclaw openclaw pairing approve feishu YDHM****

📌 常用管理命令

操作 命令
查看日志 docker logs -f openclaw
停止容器 docker stop openclaw
启动容器 docker start openclaw
进入容器 docker exec -it openclaw bash
更新镜像 docker pull ghcr.io/openclaw/openclaw:latest && docker restart openclaw

使用 Docker 后,你无需再为 Node.js 版本或系统依赖烦恼,所有环境都已封装在镜像中。如果在配置过程中遇到任何问题,欢迎随时反馈。

Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐