OpenClaw 安装与配置指南

在准备好您的服务器（VPS）之后，现在我们将进入的核心环境——安装与配置 OpenClaw。当前最主流、最不易踩坑的安装方式是使用 Docker 进行容器化部署。

1. 安装前的确认

请登录您的 VPS，并确保 Docker 和 Docker Compose 已就绪。执行以下命令确认：

docker --version
docker compose version

如果未安装，请执行 curl -fsSL https://get.docker.com | bash -s docker。

2. 使用 Docker Compose 部署 OpenClaw

创建项目目录

我们需要为 OpenClaw 创建一个专有的工作目录，以便于数据持久化和后期配置管理。
Terminal window
```
mkdir -p /opt/openclaw
cd /opt/openclaw
```

编写 docker-compose.yml

使用 nano 或者 vim 编辑器，创建一个 docker-compose.yml 文件：

nano docker-compose.yml

将以下内容粘贴进去：

version: '3.8'

services:
  openclaw:
    image: openclaw/core:latest
    container_name: openclaw
    restart: always
    ports:
      - '8080:8080'
    environment:
      - TZ=Asia/Shanghai
      - CLAW_ENV=production
      # - OPENAI_API_KEY=sk-xxxxxx
    volumes:
      - ./data:/app/data
      - ./config:/app/config

保存并退出编辑器（Ctrl + O, Enter, Ctrl + X）。

启动服务

在 /opt/openclaw 目录下，运行以下命令启动服务：
Terminal window
```
docker compose up -d
```
等待镜像拉取完毕。可以通过 docker ps 查看容器是否运行，如果报错可通过 docker logs openclaw 查看日志。

3. 基础后台初配置

如果一切正常运行，OpenClaw 默认会在本机的 8080 端口开放其 Web 面板。打开您的浏览器，访问 http://您的VPS_IP:8080。

根据向导，您可能需要：

设置初始管理员账号密码：请一定牢记。
连接所需的数据源或 API 端点：进入设置中心，填写对应 Keys。

4. 防火墙端口设置提醒

如果您无法访问网页配置界面，请检查您的服务器防火墙。以 Ubuntu UFW 为例：

ufw allow 8080/tcp

5. 继续阅读

完成基础安装后，您可以继续探索更多功能：

进阶使用技巧：绑定独立域名反代、设置并发限制。
环境监控与性能优化：如何解决抓取慢、服务卡顿等性能瓶颈。
常见报错与排查：Docker重启、API限流常见答疑。