第3章 - 安装 OpenClaw

嗨，朋友！环境准备好了，现在我们来安装 OpenClaw。这是最激动人心的一步——马上你就拥有自己的 AI 助手了！

🚀 方法一：一键安装（推荐）

OpenClaw 官方提供了一键安装脚本，这是最简单的方式：

curl -fsSL https://openclaw.ai/install.sh | bash

这个脚本会自动完成以下操作：

检测你的系统环境
安装 OpenClaw CLI 工具
配置必要的路径

提示

如果你的 Linux 系统没有预装 curl，先运行 sudo apt install -y curl 安装它。

🔧 方法二：通过 npm 全局安装

如果你更喜欢手动控制，可以通过 npm 安装：

# 使用 npm 全局安装
npm install -g openclaw@latest

或者使用 pnpm：

# 使用 pnpm 全局安装
pnpm add -g openclaw@latest

🏗️ 方法三：从源码安装（开发者）

如果你想参与开发或需要最新的代码：

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

# 进入目录
cd openclaw

# 安装依赖（推荐使用 pnpm）
pnpm install

# 构建 UI
pnpm ui:build

# 构建项目
pnpm build

# 运行引导向导
pnpm openclaw onboard --install-daemon

注意

从源码安装推荐使用 pnpm 作为包管理器。如果没有安装 pnpm，可以运行：

npm install -g pnpm

✅ 验证安装

安装完成后，验证 OpenClaw 是否安装成功：

# 查看 OpenClaw 版本
openclaw --version

# 运行健康检查
openclaw doctor

openclaw doctor 会检查你的环境，告诉你是否一切正常。如果有问题，它会给出修复建议。

预期输出

$ openclaw --version
openclaw vYYYY.M.D

$ openclaw doctor
✓ Node.js version: v22.x.x
✓ OpenClaw installed
✓ Configuration found
...

📁 安装后的目录结构

安装完成后，OpenClaw 的文件主要在以下位置：

~/.openclaw/                    # OpenClaw 主目录
├── openclaw.json               # 主配置文件
├── workspace/                  # 工作空间
│   ├── AGENTS.md               # Agent 提示词
│   ├── SOUL.md                 # 个性化配置
│   ├── TOOLS.md                # 工具说明
│   └── skills/                 # 技能目录
│       └── <skill>/
│           └── SKILL.md
└── state/                      # 状态数据

点击了解各文件用途

openclaw.json: 核心配置，包括模型选择、渠道配置等
AGENTS.md: 定义 Agent 的行为和规则
SOUL.md: 定义 AI 的个性，让它更像"你的"助手
TOOLS.md: 列出可用工具的说明
skills/: 存放各种技能插件

🔄 更新 OpenClaw

以后要更新 OpenClaw 到最新版本：

# 通过 npm 更新
npm install -g openclaw@latest

# 或者使用 OpenClaw 自带的更新命令
openclaw update --channel stable

更新后运行 openclaw doctor 检查是否一切正常。

⚠️ 常见安装问题

问题1：权限错误

# 如果遇到 EACCES 权限错误
sudo npm install -g openclaw@latest

# 或者更好的方式：修改 npm 全局目录
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

问题2：Node.js 版本太低

# 检查版本
node --version

# 如果低于 22，使用 nvm 升级
nvm install 22
nvm use 22

问题3：网络超时

# 如果下载超时，可以设置 npm 镜像
npm config set registry https://registry.npmmirror.com

# 安装完成后可以改回来
npm config set registry https://registry.npmjs.org

💪 练习题

你选择了哪种安装方式？为什么？
openclaw doctor 的输出结果是什么？有没有报错？
~/.openclaw/ 目录下有哪些文件？

答案提示

推荐使用一键安装脚本，最简单方便
如果有报错，按照提示信息修复即可
运行 ls -la ~/.openclaw/ 查看

下一步: 第4章 - 引导向导配置 →