养虾指南
OpenClaw System Guide
推荐方式

Docker 安装 OpenClaw

跨平台通用方案，适合大多数用户。一行命令拉取镜像，docker-compose 管理服务，10 分钟搞定部署。

Docker 是部署 OpenClaw（小龙虾）最简单、最推荐的方式。无需手动安装 Node.js 和各种依赖，一条命令即可启动。支持 Mac、Windows、Linux 全平台——只要你的电脑能跑 Docker，就能跑 OpenClaw。环境完全隔离，升级和备份也极其方便。对于新手来说，Docker 安装比直接源码安装少踩很多坑。

前置要求

  • 安装 Docker Desktop（Mac/Windows）或 Docker Engine（Linux）
  • 至少 2GB 可用内存
  • 至少一个大模型 API 密钥（OpenAI / Anthropic / DeepSeek / 通义千问 等）
还没有 Docker？访问 docker.com/get-started 下载 Docker Desktop，安装后确保 Docker 正在运行（系统托盘有鲸鱼图标）。Docker Desktop 对个人使用免费，Linux 用户推荐 Docker Engine + Docker Compose 插件。
1

拉取 OpenClaw 镜像

打开终端（Mac/Linux）或 PowerShell（Windows），运行以下命令拉取最新的 OpenClaw Docker 镜像：

Terminal
docker pull openclaw/openclaw:latest
国内用户如果拉取速度慢，可以配置 Docker 镜像加速器（阿里云、腾讯云等均提供免费加速服务）。打开 Docker Desktop → Settings → Docker Engine，添加 registry-mirrors 配置。
2

创建项目目录和 docker-compose.yml

在你喜欢的位置新建一个文件夹用于存放 OpenClaw 的配置文件：

Terminal
mkdir openclaw && cd openclaw

在该目录下创建 docker-compose.yml 文件，内容如下：

docker-compose.yml
version: "3.8"

services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "3210:3210"
    volumes:
      - openclaw_data:/app/data
    env_file:
      - .env
    environment:
      - NODE_ENV=production

volumes:
  openclaw_data:
docker-compose.yml 定义了 OpenClaw 的服务配置：端口映射（3210）、数据持久化（volumes）、自动重启策略等。数据通过 Docker volume 持久化，升级时不会丢失。
3

配置环境变量（.env 文件）

在同一目录下创建 .env 文件，填入你的 API 密钥和运行配置。这是 OpenClaw 最关键的配置步骤：

.env
# OpenClaw 环境变量配置
# 大模型 API 密钥（必填，至少配置一个）

# Option 1: OpenAI / GPT
OPENAI_API_KEY=sk-your-openai-api-key
OPENAI_MODEL=gpt-4o

# Option 2: Claude
# ANTHROPIC_API_KEY=sk-ant-your-key
# ANTHROPIC_MODEL=claude-sonnet-4-20250514

# Option 3: DeepSeek（国产，性价比高）
# DEEPSEEK_API_KEY=your-deepseek-key
# DEEPSEEK_MODEL=deepseek-chat

# 访问密码（强烈建议设置）
ACCESS_CODE=your-secure-password

# 端口（默认 3210）
PORT=3210
请务必设置 ACCESS_CODE 访问密码！如果不设置，任何知道你 IP 地址的人都可以访问你的 OpenClaw 实例，消耗你的 API 额度。这不是可选项，是必选项。
不确定选哪个模型？DeepSeek 性价比最高（国产，月均 30-80 元），Claude 综合能力最强，GPT-4o 最通用。可以同时配置多个模型的 API Key，在 OpenClaw 界面中随时切换。
4

启动 OpenClaw

一行命令启动 OpenClaw（-d 表示后台运行）：

Terminal
docker compose up -d

首次运行会自动拉取镜像（如果之前没拉取的话），可能需要几分钟。启动后查看运行状态和日志：

Terminal
# 查看容器状态
docker compose ps

# 查看实时日志
docker compose logs -f openclaw
5

访问 Web 界面

打开浏览器，访问以下地址即可开始使用 OpenClaw：

Browser
http://localhost:3210
如果能看到 OpenClaw 的登录/主界面，恭喜你，安装成功！输入你在 .env 中设置的 ACCESS_CODE 即可登录。现在你可以开始配置你的第一个 AI Agent 了。

常用运维命令

常用命令
# 停止 OpenClaw
docker compose stop

# 重新启动
docker compose restart

# 更新到最新版本
docker compose pull && docker compose up -d

# 查看日志
docker compose logs -f openclaw

# 完全删除（数据保留在 volume 中）
docker compose down

常见问题排查

端口 3210 被占用

修改 docker-compose.yml 中的端口映射，将 "3210:3210" 改为 "3211:3210"，然后通过 http://localhost:3211 访问。

容器启动后立即退出

运行 docker compose logs openclaw 查看错误日志。常见原因：.env 文件格式错误（等号前后不要有空格）、API 密钥无效、系统内存不足（至少需要 2GB）。

拉取镜像超时或速度很慢

国内网络问题，配置 Docker 镜像加速器。打开 Docker Desktop → Settings → Docker Engine，在 JSON 配置中添加："registry-mirrors": ["https://mirror.ccs.tencentyun.com"]

如何更新到最新版本

运行 docker compose pull && docker compose up -d 即可。数据通过 Docker volume 持久化，更新不会丢失任何数据。

如何备份数据

OpenClaw 的数据存储在 Docker volume openclaw_data 中。可以用以下命令导出备份：docker run --rm -v openclaw_data:/data -v $(pwd):/backup busybox tar czf /backup/openclaw-backup.tar.gz /data

装好了！下一步：喂虾

龙虾装好了但还不会说话——你需要配置大模型 API Key（大脑）和通信工具（嘴巴），让它能思考和对话。

去喂虾（大模型 + 通信工具）

其他安装方式

Mac 本地安装Windows WSL2 安装
返回安装总览