第6章 完整安装指南 - 各种操作系统

详细的跨平台安装指南，包括 macOS、Windows、Linux 和 Docker 部署方式。

🎯 本章目标

• 目标 1

• 目标 2

• 目标 3

• 目标 4

---

主要内容

macOS 安装详解

Homebrew 方式（推荐）

# 1. 安装 Homebrew（如果还没有）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 2. 安装 Node.js 22
brew install node@22
brew link node@22

# 3. 验证安装
node -v  # 应该显示 v22.x.x
npm -v

# 4. 安装 OpenClaw
npm install -g openclaw@latest

# 5. 验证
openclaw --version

nvm 方式（灵活）

# 1. 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 2. 重新加载 shell 配置
source ~/.zshrc  # 或 source ~/.bashrc

# 3. 安装 Node.js 22
nvm install 22
nvm use 22
nvm alias default 22

# 4. 安装 OpenClaw
npm install -g openclaw@latest

常见问题

问题：权限错误

# 解决方案：修改 npm 全局目录
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

问题：Xcode Command Line Tools 缺失

xcode-select --install

Windows 安装（WSL2）

启用 WSL2

# 1. 以管理员身份运行 PowerShell
wsl --install

# 2. 重启电脑

# 3. 安装 Ubuntu
wsl --install -d Ubuntu-22.04

# 4. 设置用户名和密码

在 WSL2 中安装

# 1. 更新包管理器
sudo apt update && sudo apt upgrade -y

# 2. 安装 Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# 3. 验证
node -v
npm -v

# 4. 安装 OpenClaw
npm install -g openclaw@latest

# 5. 验证
openclaw --version

Windows 原生安装（不推荐）

# 1. 下载 Node.js 安装包
# 访问 https://nodejs.org/

# 2. 安装 Node.js 22

# 3. 打开 PowerShell
npm install -g openclaw@latest

Linux 安装

Ubuntu/Debian

# 1. 更新系统
sudo apt update && sudo apt upgrade -y

# 2. 安装 Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# 3. 安装构建工具
sudo apt-get install -y build-essential

# 4. 安装 OpenClaw
npm install -g openclaw@latest

CentOS/RHEL

# 1. 安装 Node.js 22
curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -
sudo yum install -y nodejs

# 2. 安装开发工具
sudo yum groupinstall -y "Development Tools"

# 3. 安装 OpenClaw
npm install -g openclaw@latest

Arch Linux

# 1. 安装 Node.js
sudo pacman -S nodejs npm

# 2. 安装 OpenClaw
npm install -g openclaw@latest

Docker 容器化部署

使用官方镜像

# 1. 拉取镜像
docker pull openclaw/openclaw:latest

# 2. 运行容器
docker run -d \
  --name openclaw \
  -p 3000:3000 \
  -v ~/.openclaw:/root/.openclaw \
  -e OPENAI_API_KEY=your_key \
  openclaw/openclaw:latest

# 3. 查看日志
docker logs -f openclaw

自定义 Dockerfile

FROM node:22-alpine

WORKDIR /app

# 安装 OpenClaw
RUN npm install -g openclaw@latest

# 复制配置文件
COPY config.json /root/.openclaw/config.json

# 暴露端口
EXPOSE 3000

# 启动命令
CMD ["openclaw", "server"]

Docker Compose

version: '3.8'

services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    ports:
      - "3000:3000"
    volumes:
      - ./config:/root/.openclaw
      - ./data:/app/data
    environment:
      - OPENAI_API_KEY=${OPENAI_API_KEY}
      - NODE_ENV=production
    restart: unless-stopped

最佳实践

1. 实践 1 - 说明

2. 实践 2 - 说明

3. 实践 3 - 说明

常见问题

问题 1

症状：错误描述

解决方案：

# 解决命令

下一步

• 第7章

• 返回目录

---

📚 本章小结

✅ 完成了主要学习目标
✅ 掌握了核心概念
✅ 实践了示例代码
✅ 了解了最佳实践

---

返回目录 | 上一章 | 下一章