第2讲：OpenClaw安装与初始化，5分钟搭建你的AI网关

大家好，我是正在实战各种AI项目的程序员晚枫。

今天正式开始OpenClaw的动手环节。整个过程我实测只需要5分钟，我手把手带你来。

---

🚀 开篇：安装前先搞懂这些

在开始安装之前，我想先回答几个新手常见的问题：

Q：需要编程基础吗？

不需要！OpenClaw的安装和配置都是点点点，或者复制粘贴命令。课程里我会提供完整的命令，你只需要跟着做就行。

Q：需要花钱吗？

OpenClaw本身是免费的。但你要接入AI模型（Claude、GPT等），那些API是收费的。不过很多国内模型有免费额度，新手完全可以0成本体验。

Q：我的电脑能跑吗？

基本上任何电脑都行。Mac/Linux/Windows都可以，要求很低。

---

第一步：检查环境要求

硬件要求

配置项	最低要求	推荐配置
CPU	1核	2核+
内存	2GB	4GB+
硬盘	1GB可用空间	5GB+
网络	能访问互联网	稳定连接

系统支持

• ✅ macOS 11+ (Intel/Apple Silicon) - 推荐用这个，坑最少
• ✅ Linux (Ubuntu 20.04+, CentOS 8+, Debian 11+)
• ✅ Windows 10/11 (通过WSL2)
• ✅ Docker容器环境

软件依赖

• **Node.js 22+**（必须）
• npm 或 pnpm（包管理器）

---

第二步：安装Node.js ⭐这一步很关键

OpenClaw是用Node.js写的，所以必须先装Node.js。很多安装失败都是因为这一步没做好。

macOS用户（推荐用Homebrew安装）

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

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

# 验证安装
node --version
# 应该显示 v22.x.x

npm --version
# 应该显示 10.x.x

Linux用户（Ubuntu/Debian）

# 安装NodeSource仓库
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

# 安装Node.js
sudo apt-get install -y nodejs

# 验证
node --version

Linux用户（CentOS/RHEL）

# 安装NodeSource仓库
curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -

# 安装Node.js
sudo yum install -y nodejs

# 验证
node --version

Windows用户（WSL2）

在WSL2 Ubuntu中执行Linux安装命令即可（参考上面）。

或者直接下载安装包（最简单）：

1. 访问 https://nodejs.org/
2. 下载 LTS 版本（v22.x.x）
3. 双击安装，一路下一步

升级Node.js（如果已安装旧版本）

# 使用Homebrew升级（macOS）
brew upgrade node

# 或使用nvm（推荐）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 22
nvm use 22
nvm alias default 22

# 验证
node --version

---

第三步：安装OpenClaw 🚀

Node.js装好了，接下来安装OpenClaw。官方给了一键安装脚本，两行命令搞定。

macOS/Linux一键安装（官方推荐）

# 下载并运行安装脚本
curl -fsSL https://openclaw.ai/install.sh | bash

安装过程会自动：

• ✅ 下载最新版OpenClaw
• ✅ 安装到系统PATH
• ✅ 创建必要的目录结构

安装完成后，验证：

openclaw --version
# 输出类似：openclaw version 0.25.0

Windows PowerShell安装

# 以管理员身份运行PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex

npm手动安装（备选方案）

如果一键脚本遇到问题，可以用npm：

npm install -g openclaw@latest

# 或使用pnpm
pnpm add -g openclaw@latest

Docker安装（适合有Docker经验的同学）

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

# 运行容器
docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw:latest

---

第四步：运行初始化向导 🎯

安装完成后，运行初始化向导。它会引导你完成基础配置：

openclaw onboard --install-daemon

向导会问这些问题，我帮你翻译成大白话：

问题1：选择安装模式

? Select installation mode:
  ▸ Standard (recommended)  - 标准模式，适合大多数用户 ✅ 选这个
    Minimal                 - 最小化安装，仅核心功能
    Custom                  - 自定义安装

💡 建议选 Standard，包含完整功能，不容易出问题。

问题2：配置AI模型

? Configure AI provider now? (Y/n)

💡 选 Y 会让你输入API Key。如果现在没有，可以选 n，后面再配置。

问题3：安装系统服务（daemon）

? Install as system service? (Y/n)

💡 选 Y，这样电脑重启后OpenClaw会自动启动，不需要手动运行。

完整初始化流程演示

$ openclaw onboard --install-daemon

? Select installation mode: Standard (recommended)
? Configure AI provider now? Yes
? Select provider: Anthropic (Claude)
? Enter your API key: sk-ant-api03-xxxxxxxx
? Install as system service? Yes

✓ Downloading OpenClaw packages...
✓ Setting up configuration files...
✓ Installing system service...
✓ Starting OpenClaw Gateway...

✓ OpenClaw initialized successfully!
✓ Gateway service installed
✓ Config saved to ~/.openclaw/openclaw.json

Next steps:
  1. Run 'openclaw gateway status' to check status
  2. Run 'openclaw dashboard' to open Control UI

🎉 看到 "initialized successfully" 就说明成功了！

---

第五步：检查Gateway状态

初始化完成后，检查服务是否正常运行：

openclaw gateway status

正常输出示例：

Gateway Status: running
PID: 12345
Port: 18789
Uptime: 0h 2m 15s
Channels: 0 connected
Sessions: 0 active

如果显示 stopped，手动启动：

# 前台启动（调试用，能看到日志）
openclaw gateway --port 18789

# 后台启动
openclaw daemon start

# 查看启动日志
tail -f ~/.openclaw/state/logs/gateway.log

---

第六步：打开Control UI 🎉

激动人心的时刻！ 让我们打开Web界面，看看你的AI网关长什么样。

# 自动打开浏览器
openclaw dashboard

# 如果自动打开没反应，手动访问：
# http://127.0.0.1:18789/

首次打开会看到：

• Chat界面 ✅ - 直接与AI对话
• Sessions ✅ - 会话管理
• Config ✅ - 配置查看
• Status ✅ - 运行状态

测试对话 🎯

在Chat界面输入：

你好，请介绍一下你自己

如果能收到AI回复，说明基础部署成功！🎉

💡 如果提示没有配置API Key，先跳到第5讲配置模型提供商，或者直接去 https://platform.moonshot.cn/ 注册一个 Kimi 的免费API。

---

目录结构说明

安装完成后，OpenClaw会在用户目录创建以下结构：

~/.openclaw/
├── openclaw.json          # 主配置文件（所有配置都在这里）
├── state/                 # 运行时状态
│   ├── sessions/          # 会话数据
│   ├── memory/            # 记忆文件
│   └── logs/              # 日志文件（排查问题先看这里）
├── skills/                # 技能插件目录
└── cache/                 # 缓存数据

重要文件说明

文件/目录	作用	重要程度
openclaw.json	主配置文件	⭐⭐⭐⭐⭐
state/logs/	运行日志	⭐⭐⭐⭐
state/sessions/	会话数据	⭐⭐⭐
skills/	插件目录	⭐⭐⭐

---

常用命令速查表

命令	作用	使用频率
openclaw --version	查看版本	⭐
openclaw gateway status	查看Gateway状态	⭐⭐⭐⭐⭐
openclaw gateway --port 18789	前台启动Gateway	⭐⭐⭐
openclaw daemon start/stop/restart	服务管理	⭐⭐⭐
openclaw dashboard	打开Web界面	⭐⭐⭐⭐⭐
openclaw doctor	诊断问题	⭐⭐⭐
openclaw config show	查看当前配置	⭐⭐⭐
openclaw config edit	编辑配置文件	⭐⭐⭐

---

常见问题解决 🔧

Q1：安装时报权限错误 ❌

错误信息：EACCES: permission denied

macOS/Linux解决：

# 方法1：修改权限
sudo chown -R $(whoami) /usr/local/lib/node_modules

# 方法2：使用npx免安装
npx openclaw@latest

Q2：Gateway启动失败，端口被占用 ❌

错误信息：Error: listen EADDRINUSE :::18789

解决步骤：

# 1. 查找占用18789端口的进程
lsof -i :18789

# 2. 杀死进程（替换PID为实际进程ID）
kill -9 <PID>

# 3. 或更换端口启动
openclaw gateway --port 18888

# 4. 或直接用kill命令
pkill -f openclaw
openclaw gateway --port 18789

Q3：提示Node版本过低 ❌

错误信息：Node.js version 18.x is too low, required 22+

解决：

# 使用nvm升级（推荐）
nvm install 22
nvm use 22
nvm alias default 22

# 验证
node --version  # 应该显示 v22.x.x

Q4：Control UI打不开 ❌

排查步骤：

# 1. 确认Gateway真的在运行
openclaw gateway status

# 2. 查看日志找错误
tail -f ~/.openclaw/state/logs/gateway.log

# 3. 尝试重启
openclaw daemon restart

# 4. 检查防火墙
# macOS
sudo firewallctl allow 18789
# Linux
sudo ufw allow 18789

Q5：一键安装脚本下载失败 ❌

原因：网络问题（国内访问可能慢）

解决：

# 使用npm安装（国内可能更快）
npm install -g openclaw@latest

# 或设置npm镜像
npm config set registry https://registry.npmmirror.com
npm install -g openclaw@latest

---

性能对比：安装方式哪种快？

安装方式	难度	速度	适合人群
一键安装脚本	⭐	5分钟	大多数用户 ✅
npm安装	⭐⭐	3分钟	国内用户
Docker安装	⭐⭐⭐	10分钟	有Docker经验
源码编译	⭐⭐⭐⭐⭐	30分钟+	开发者

---

下节预告

下一讲我们将深入学习Control UI的使用，包括：

• Web界面各功能模块详解
• 对话测试与参数调整
• 基础配置修改
• 第一个工具调用实验

👉 继续阅读：第3讲-Control UI详解与基础操作

---

💬 加入学习交流群

安装遇到问题？扫码加入交流群求助：

👉 点击加入交流群

---

推荐：AI Python编程实战营

🎁 限时福利：送《利用Python进行数据分析》实体书

👉 点击了解详情

---

---## 📚 完整学习路线这是OpenClaw入门课程的第X讲。查看完整课程大纲：👉 **OpenClaw入门课程大纲**课程包含30讲，从安装部署到实战项目，带你全面掌握OpenClaw。

课程导航

上一篇： 第1讲-OpenClaw入门课程大纲

下一篇： 第3讲-Control UI详解与基础操作

---

PS：安装是第一步，也是最可能卡住的地方。如果遇到问题，不要气馁，加群求助或者多看官方文档。

---

💬 联系我

平台	账号/链接
微信	扫码加好友
微博	@程序员晚枫
知乎	@程序员晚枫
抖音	@程序员晚枫
小红书	@程序员晚枫
B 站	Python 自动化办公社区

主营业务：AI 编程培训、企业内训、技术咨询

🎓 AI 编程实战课程

想系统学习 AI 编程？程序员晚枫的 AI 编程实战课 帮你从零上手！

• 👉 课程报名：点击这里报名，前3讲免费试听
• 👉 免费试看：B站免费试看前3讲，先看看适不适合自己