OpenClaw 中文教程站

1. 环境要求

在安装之前，请确保你的 Linux 系统满足以下条件：

操作系统：Ubuntu 20.04+、Debian 11+、CentOS 8+、RHEL 8+
Node.js：版本 18.0 或更高（推荐 LTS）
npm：版本 8.0 或更高
内存：至少 2GB RAM（推荐 4GB+）
磁盘空间：至少 1GB 可用空间
网络：能够访问 npm registry 和 AI API

💡 推荐方案：对于服务器部署，强烈建议使用 Docker 方式，隔离性更好，维护更简单。

2. Ubuntu / Debian 安装

适用于 Ubuntu 20.04/22.04/24.04 和 Debian 11/12。

步骤 2.1：更新系统

sudo apt update && sudo apt upgrade -y

步骤 2.2：安装 Node.js

# 安装 NodeSource 仓库 curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - # 安装 Node.js sudo apt install -y nodejs # 验证安装 node --version npm --version

步骤 2.3：安装 OpenClaw

sudo npm install -g openclaw

如果 npm 安装较慢，可以切换国内镜像：

# 使用淘宝镜像 npm config set registry https://registry.npmmirror.com sudo npm install -g openclaw

步骤 2.4：验证安装

openclaw --version

3. CentOS / RHEL 安装

适用于 CentOS 8/9、RHEL 8/9、Rocky Linux、AlmaLinux。

步骤 3.1：更新系统

sudo dnf update -y

步骤 3.2：安装 Node.js

# 安装 NodeSource 仓库 curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash - # 安装 Node.js sudo dnf install -y nodejs # 验证安装 node --version npm --version

步骤 3.3：安装 OpenClaw

sudo npm install -g openclaw

⚠️ 注意：在 CentOS/RHEL 上，如果 npm 命令找不到，可能需要先安装 npm 包：sudo dnf install -y npm

4. Docker 部署（推荐）

Docker 方式部署更加简单，且便于管理和迁移。

步骤 4.1：安装 Docker

Ubuntu / Debian：

# 安装 Docker curl -fsSL https://get.docker.com | sh # 启动 Docker 服务 sudo systemctl start docker sudo systemctl enable docker # 将当前用户加入 docker 组 sudo usermod -aG docker $USER# 重新登录使权限生效 newgrp docker

CentOS / RHEL：

# 安装 Docker sudo dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo sudo dnf install -y docker-ce docker-ce-cli containerd.io # 启动 Docker 服务 sudo systemctl start docker sudo systemctl enable docker # 将当前用户加入 docker 组 sudo usermod -aG docker $USER newgrp docker

步骤 4.2：创建项目目录

mkdir -p ~/openclaw cd ~/openclaw

步骤 4.3：创建 Docker Compose 配置

cat > docker-compose.yml << 'EOF' version: '3.8' services: openclaw: image: openclaw/openclaw:latest container_name: openclaw restart: unless-stopped ports: - "3000:3000" volumes: - ./config:/app/config - ./memory:/app/memory - ./skills:/app/skills environment: - NODE_ENV=production env_file: - .env EOF

步骤 4.4：创建配置文件

# 创建配置目录 mkdir -p config memory skills # 创建环境变量文件 cat > .env << 'EOF' # AI 模型 API 密钥 KIMI_API_KEY=your_kimi_api_key_here OPENAI_API_KEY=your_openai_api_key_here # 网关密钥 GATEWAY_SECRET=your_random_secret_string EOF # 创建基础配置 cat > config/openclaw.json << 'EOF'{"version": "1.0", "gateway": {"host": "0.0.0.0", "port": 3000}, "models": {"default": "kimi", "providers": {"kimi": {"type": "openai-compatible", "baseUrl": "https://api.moonshot.cn/v1", "apiKey": "${KIMI_API_KEY}", "model": "kimi-k2-latest"}}}}EOF

步骤 4.5：启动容器

docker-compose up -d # 查看日志 docker-compose logs -f

✅ Docker 优势：一键启动、环境隔离、易于备份和迁移、支持自动重启。

5. 首次配置

步骤 5.1：初始化工作目录

mkdir -p ~/openclaw-workspace cd ~/openclaw-workspace openclaw init

步骤 5.2：配置 API 密钥

# 编辑环境变量文件 nano .env # 添加你的 API 密钥 KIMI_API_KEY=sk-your-kimi-key OPENAI_API_KEY=sk-your-openai-key

6. 配置系统服务

为了让 OpenClaw 在后台运行并在开机时自动启动，可以配置 systemd 服务。

步骤 6.1：创建服务文件

sudo nano /etc/systemd/system/openclaw.service

添加以下内容：

[Unit] Description=OpenClaw Gateway After=network.target [Service] Type=simple User=your-username WorkingDirectory=/home/your-username/openclaw-workspace ExecStart=/usr/bin/openclaw gateway start Restart=on-failure RestartSec=10 Environment=NODE_ENV=production [Install] WantedBy=multi-user.target

步骤 6.2：启动并启用服务

# 重新加载 systemd sudo systemctl daemon-reload # 启动服务 sudo systemctl start openclaw # 设置开机自启 sudo systemctl enable openclaw # 查看状态 sudo systemctl status openclaw

常用命令

# 启动 sudo systemctl start openclaw # 停止 sudo systemctl stop openclaw # 重启 sudo systemctl restart openclaw # 查看日志 sudo journalctl -u openclaw -f

7. 常见问题

问题 1：npm 权限错误

症状：EACCES: permission denied

解决：使用 npx 或修改 npm 目录权限

# 方案 1：使用 npx npx openclaw # 方案 2：修改 npm 目录 mkdir ~/.npm-global npm config set prefix '~/.npm-global' echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc source ~/.bashrc npm install -g openclaw

问题 2：端口被占用

# 查找占用 3000 端口的进程 sudo lsof -i :3000 sudo ss -tulpn | grep 3000 # 终止进程 sudo kill -9 $(sudo lsof -t -i:3000) # 或使用其他端口 openclaw gateway start --port 3001

问题 3：防火墙阻止访问

如果无法从外部访问，可能需要配置防火墙：

# Ubuntu / Debian (UFW) sudo ufw allow 3000/tcp sudo ufw reload # CentOS / RHEL (firewalld) sudo firewall-cmd --permanent --add-port=3000/tcp sudo firewall-cmd --reload

问题 4：Docker 容器无法启动

# 查看详细错误 docker-compose logs # 常见问题：配置文件格式错误 # 检查 JSON 格式 cat config/openclaw.json | jq . # 检查权限 ls -la ~/openclaw

下一步

Linux 安装完成！接下来可以：

🎉 三平台安装教程全部完成！现在 Windows、macOS、Linux 用户都有完整的安装指南了。