安装部署：从零完成 OpenClaw 环境配置 - 🦞 小龙虾

📖 本章目标：完成 OpenClaw 的环境配置与本地安装，成功启动并对话

3.1 官方支持的操作系统

系统	支持版本	推荐版本
Linux	Ubuntu 20.04+ LTS、Debian 11+	Ubuntu 22.04 LTS ⭐
macOS	macOS 12+（Monterey）	macOS 14+（Sonoma）⭐
Windows	Windows 10 21H2+ / 11	WSL2（Ubuntu 22.04）⭐
云容器	九章智算云云容器实例	—

💡 Windows 用户强烈推荐使用 WSL2，兼容性最佳。

3.2 核心软件依赖

必选依赖

软件	版本要求	说明
Node.js	≥ v22.x	运行核心必须
Git	2.30+	代码管理
模型后端	—	云端 API 或本地 Ollama ≥0.15.4

3.3 网络与端口要求

要求	说明
云端模型	需稳定联网
本地模型	可完全离线
默认端口	18789（WebSocket 网关）

3.4 安全与权限要求

本地部署需管理员/root 权限
容器化遵循最小权限原则
启用九层权限过滤

3.5 快速部署方案选择

我是谁？
  ↓
  ├── 非技术用户 → 九章智算云在线产品（首月45元，免部署）
  │
  ├── 新手技术用户 → 国内云厂商一键脚本（阿里云/腾讯云）
  │
  └── 有经验开发者 → 本地安装 或 Docker 部署
                      ↓
                      本地模型？→ 搭配 Ollama
                      Windows？ → 优先使用 WSL2

3.6 本地安装步骤（推荐）

Step 1：检查 Node.js 版本

node --version
# 输出必须 ≥ v22

若未安装，前往 nodejs.org 下载 v22.x 版本。

Step 2：全局安装 OpenClaw

npm install -g openclaw@latest

Step 3：运行安装向导

openclaw onboard --install-daemon

Step 4：向导配置步骤

按提示依次完成：

步骤	操作
1	同意风险声明
2	选择 QuickStart
3	选择模型提供商
4	输入 API Key
5	跳过渠道（稍后配置）
6	配置 Skills
7	配置 Hooks
8	选择 Web UI
9	记录地址与 Token（重要！）

Step 5：开始对话

安装完成后，发送第一条指令：

请爬取 10 条关于今天关于 A 股的新闻。
请告诉我北京今天的天气，并给出穿衣建议。

3.7 Docker 部署

适合有 Docker 经验的用户，隔离性更好。

# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 启动服务
docker-compose up -d

必须挂载的目录

volumes:
  - ~/.openclaw:/root/.openclaw        # 配置与数据
  - ~/openclaw/workspace:/workspace    # 工作区

端口映射

端口	用途
18789	Gateway WebSocket
3000	Web UI

3.8 国内云厂商一键部署

云厂商	特点	适合人群
阿里云	稳定、文档完善	企业用户
腾讯云	活动多、价格低	个人用户
九章智算云	OpenClaw 官方合作	新手首选

💡 免部署方案：九章智算云在线产品，首月 45 元，适合不想折腾的用户。

3.9 常用命令速查

# ===== 安装 =====
npm install -g openclaw@latest          # 安装/更新
openclaw onboard --install-daemon       # 初始化向导

# ===== 网关管理 =====
openclaw gateway start                  # 启动网关
openclaw gateway restart                # 重启网关
openclaw status                         # 查看运行状态

# ===== 诊断 =====
openclaw doctor                         # 环境诊断
openclaw logs                           # 查看日志

# ===== 更新 =====
openclaw update                         # 更新到最新版本

3.10 故障处理

问题	解决方案
Gateway 启动失败	检查端口 18789 是否被占用，尝试换端口
发送指令无回复	检查 API Key、网络连接；运行 `openclaw doctor`
Web UI 打不开	检查网关状态；确认访问地址和 Token 正确
Node 版本不符	使用 nvm 切换到 v22.x

← 上一章：技术原理 | 返回目录 | 下一章：渠道接入 →