部署 OpenClaw 中文汉化版完整指南

项目简介

OpenClaw（中文社区常称 "龙虾"）是一款开源的自托管 AI 助手，支持连接多种大模型、消息应用和工具，可用于自动化任务、智能对话和工作流管理。OpenClaw 中文汉化版（openclaw-zh）是社区维护的中文适配版本，提供更友好的中文界面和本地化文档，适合国内用户快速上手。

部署准备

环境要求

操作系统：Windows 10/11（64 位）、Linux 或 macOS
内存：最低 2GB，推荐 4GB 及以上
存储空间：至少 10GB 可用空间
网络：稳定的互联网连接（用于拉取镜像和访问 API）
必备工具：Docker Desktop（Windows）或 Docker Engine（Linux/macOS）、Docker Compose

账号与密钥准备

注册并获取至少一个大模型 API 密钥（如 OpenAI、DeepSeek、智谱 AI 等）
可选：注册消息平台账号（如 Telegram、Discord）用于接收 AI 助手消息
生成 OPENCLAW_SECRET_KEY（系统加密密钥）：可使用openssl rand -hex 32命令生成 32 位随机字符串
- #推荐硅基流动免费赠送Token

Windows 系统部署教程

步骤 1：安装 Docker Desktop

访问 Docker 官网下载 Windows 版 Docker Desktop 安装包
双击安装，勾选 "Install required Windows components for WSL 2" 选项
安装完成后重启电脑，启动 Docker Desktop 并接受服务条款
在设置中启用 WSL 2 后端，等待 Docker 完全启动

步骤 2：拉取 OpenClaw 中文汉化版镜像

打开 Windows Terminal 或 PowerShell
执行以下命令拉取最新镜像：

docker pull 1186258278/openclaw-chinese:latest

步骤 3：创建持久化配置目录

在 D 盘创建 OpenClaw 配置目录：

mkdir D:\openclaw

该目录将用于存储配置文件、密钥和数据，确保容器重启后数据不丢失

步骤 4：启动容器

运行以下命令启动 OpenClaw 中文汉化版容器：

docker run -d `
  --name openclaw-zh `
  --restart unless-stopped `
  -p 18789:18789 `
  -v D:\openclaw:/root/.openclaw `
  -e TZ=Asia/Shanghai `
  1186258278/openclaw-chinese:latest

命令说明：
- --name：指定容器名称为 openclaw-zh
- --restart：设置容器开机自启
- -p：端口映射，将宿主机 18789 端口映射到容器内部端口
- -v：挂载卷，将本地 C:\openclaw 目录挂载到容器内配置目录
- -e TZ：设置时区为上海

步骤 5：初始化配置

进入容器执行初始化命令：

docker exec -it openclaw-zh openclaw onboard

按照提示完成工作区创建和基本配置

Linux/macOS 部署教程（Docker 方式）

步骤 1：安装 Docker 和 Docker Compose

Linux 系统执行官方一键安装脚本：

curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
newgrp docker
sudo apt install docker-compose-plugin

macOS 系统可通过 Homebrew 安装：

brew install docker docker-compose

步骤 2：创建项目目录并拉取镜像

mkdir -p /opt/openclaw && cd /opt/openclaw
docker pull 1186258278/openclaw-chinese:latest

步骤 3：使用 Docker Compose 启动（推荐）

创建 docker-compose.yml 文件：

vim docker-compose.yml

写入以下内容：

version: '3.9'
services:
  openclaw-zh:
    image: 1186258278/openclaw-chinese:latest
    container_name: openclaw-zh
    restart: unless-stopped
    ports:
      - "18789:18789"
    volumes:
      - /opt/openclaw:/root/.openclaw
    environment:
      - TZ=Asia/Shanghai

启动服务：

docker-compose up -d

密钥配置详解

核心密钥类型

OPENCLAW_SECRET_KEY：系统加密密钥，用于加密存储的敏感信息
OPENCLAW_ADMIN_PASSWORD：后台管理密码，用于访问 Web 管理界面
大模型 API 密钥：如 OPENAI_API_KEY、DEEPSEEK_API_KEY 等，用于调用 AI 服务
消息平台令牌：如 TELEGRAM_BOT_TOKEN、DISCORD_BOT_TOKEN 等，用于连接消息应用

安全配置方法（推荐使用.env 文件）

在配置目录（C:\openclaw 或 /opt/openclaw）创建.env 文件：

# Windows使用记事本创建C:\openclaw\.env
# Linux/macOS使用vim /opt/openclaw/.env

写入以下配置模板，替换为实际密钥：

# 系统安全设置（必须修改）
OPENCLAW_SECRET_KEY=这里替换成你生成的32位随机字符串
OPENCLAW_ADMIN_PASSWORD=MyStrongPass2026!

# 大模型配置（选择一个或多个）
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# 消息平台配置（可选）
TELEGRAM_BOT_TOKEN=123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

配置应用生效

重启容器使配置生效：

# Windows
docker restart openclaw-zh

# Linux/macOS
docker-compose restart

验证密钥配置：

docker exec -it openclaw-zh openclaw config get secrets.providers.default

密钥安全最佳实践

不要将密钥硬编码在配置文件中，避免泄露
设置.env 文件权限为 600，仅当前用户可读写：

chmod 600 /opt/openclaw/.env

定期轮换 API 密钥，特别是在怀疑泄露时
生产环境建议使用密钥管理服务（如 HashiCorp Vault）存储敏感信息

服务访问与初始化

打开浏览器访问：http://localhost:18789
使用配置的 OPENCLAW_ADMIN_PASSWORD 登录管理后台
完成以下初始化步骤：
- 配置默认大模型
- 连接消息应用（如 Telegram）
- 安装所需工具和插件
- 创建第一个 AI 代理

常用管理命令

# 查看容器运行状态
docker ps | grep openclaw-zh

# 查看容器日志
docker logs -f openclaw-zh

# 进入容器终端
docker exec -it openclaw-zh bash

# 停止容器
docker stop openclaw-zh

# 启动容器
docker start openclaw-zh

# 更新镜像并重启
docker pull 1186258278/openclaw-chinese:latest && docker restart openclaw-zh