Centos7 使用 OpenClaw 官方 Docker 镜像

使用 OpenClaw 官方 Docker 镜像

想要体验最稳定、最便捷的 OpenClaw 部署环境吗？官方 Docker 镜像能让你轻松避 Python环境、系统依赖等繁琐配置，实现快速开箱即用。

1. 安装 Docker（如果尚未安装）

首先确保您的系统已经安装了 Docker 运行环境。在 Linux 系统上可执行以下命令一键安装与启用：

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

拉取镜像

从 GitHub Container Registry 拉取最新的 OpenClaw 官方 Docker 镜像：

docker pull ghcr.io/openclaw/openclaw:latest

启动容器（后台运行，自动重启修改了映射端口，尽量规避攻击）

使用以下命令启动一个在后台运行的 OpenClaw 容器。我们设置端口映射、目录挂载并启用自动重启策略：

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

3. 执行初始化配置

容器启动后，需要通过交互式命令完成初始设定，包括选择AI基础模型、添加服务通道等：

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

跟随终端提示，按步骤输入所需信息即可顺利完成服务初始化。配置数据将自动保存到挂载的持久化目录。

4. 获取访问令牌

配置完成后，获取用于 Web 界面登录的访问令牌（Token）：

grep token ~/openclaw/openclaw.json

5.配置openclaw.json

为了实现局域网访问，通常需要修改网关的绑定地址。请使用编辑器打开 `~/openclaw/openclaw.json` 文件，找到 `gateway.bind` 字段，将其值由默认的 `"localhost"` 修改为 `"lan"`。

"gateway": {
 "port": 18789,
 "mode": "local",
 "bind": "lan", # 主要是这里
 "controlUi": {
 "allowedOrigins": ["*"]
 },

修改保存后，执行以下命令应用新配置并重启服务使之生效：

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

6. 访问 Web 界面

现在，您可以通过浏览器访问 OpenClaw 的网页控制台了。默认地址为：

http://127.0.0.1:8700/#token=

请将上一步获取到的令牌密钥完整填写在 URL 末尾 '=' 号之后，按回车即可成功登录管理面板。

7.使用容器内的 openclaw 命令

日常运营中，常常需要通过命令行来管理设备。例如，查看所有正在等待授权的设备列表：

docker exec -it openclaw openclaw devices list

命令将输出类似如下的信息，其中包含“待处理”的请求ID：

Pending (1)
┌──────────────────────────────────────┬
│ Request│
├──────────────────────────────────────┼
│ d5387100-8538-49ce-b546-a860256f4977 │
└──────────────────────────────────────┴

复制显示在“Request”后的UUID字符串，然后用它来批准该设备的接入请求：

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

批准后，刷新Web管理界面，新设备便会出现在已授权列表中。

8.飞书

配置飞书机器人等第三方集成后，同样需要批准其配对请求。在容器内执行如下命令即可完成授权：

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