OpenClaw 源码安装教程

📋 系统要求

要求	说明
Node.js	22.16+ 或 24.x（推荐）
pnpm	构建源码必需
操作系统	macOS / Linux / Windows (推荐 WSL2)
Git	克隆仓库必需

🚀 源码安装步骤

1. 安装 Node.js

macOS (Homebrew)

brew install node

Ubuntu / Debian

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs

Windows (PowerShell)

winget install OpenJS.NodeJS.LTS

验证安装

node -v   # 应输出 v24.x.x 或 v22.16+
npm -v

2. 安装 pnpm

npm install -g pnpm

3. 克隆仓库

git clone https://github.com/openclaw/openclaw.git
cd openclaw

4. 安装依赖

pnpm install

5. 构建 UI

pnpm ui:build

6. 构建项目

pnpm build

7. 链接 CLI（全局可用）

pnpm link --global

或直接运行

# 在仓库目录内
pnpm openclaw <command>

8. 运行初始化

openclaw onboard --install-daemon

✅ 验证安装

# 检查配置问题
openclaw doctor
# 查看网关状态
openclaw status
# 打开浏览器 UI
openclaw dashboard

🔧 其他安装方式

安装脚本（推荐新手）

macOS / Linux / WSL2

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

Windows PowerShell

iwr -useb https://openclaw.ai/install.ps1 | iex

npm 全局安装

npm install -g openclaw@latest
openclaw onboard --install-daemon

pnpm 全局安装

pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon

安装最新开发版（GitHub main 分支）

npm install -g github:openclaw/openclaw#main

pnpm add -g github:openclaw/openclaw#main

🛠️ 常见问题排查

`openclaw: command not found`

原因：npm 全局 bin 目录不在 PATH 中

解决步骤：

查找 npm 全局前缀

npm prefix -g

检查 PATH

echo "$PATH"

添加到 shell 启动文件

macOS / Linux（添加到 ~/.zshrc 或 ~/.bashrc）

export PATH="$(npm prefix -g)/bin:$PATH"

Windows

•

设置 → 系统 → 环境变量

•

添加 npm prefix -g 的输出到 PATH

重启终端或执行

# zsh
rehash
# bash
hash -r

Linux 下 npm 全局安装权限错误

mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"
export PATH="$HOME/.npm-global/bin:$PATH"

将 export PATH=... 添加到 ~/.bashrc 或 ~/.zshrc

sharp 构建错误（macOS）

如果已安装 libvips（Homebrew）导致 sharp 失败：

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

📚 常用命令速查

命令	说明
`openclaw --help`	查看帮助
`openclaw onboard`	初始化配置
`openclaw status`	网关状态
`openclaw doctor`	诊断问题
`openclaw config`	配置管理
`openclaw models`	模型管理
`openclaw channels`	通道管理
`openclaw skills`	技能管理
`openclaw plugins`	插件管理
`openclaw logs --follow`	实时日志
`openclaw dashboard`	打开 Web UI

📦 项目结构

openclaw/├── src/              # 源代码├── packages/         # 子包├── skills/           # 内置技能├── docs/             # 文档├── package.json      # 项目配置├── pnpm-workspace.yaml└── tsconfig.json

🔗 相关链接

资源	链接
GitHub 仓库	https://github.com/openclaw/openclaw
官方文档	https://docs.openclaw.ai
安装指南	https://docs.openclaw.ai/install
Node.js 安装	https://nodejs.org
pnpm 文档	https://pnpm.io

🎯 开发工作流

从源码运行开发版本

cd openclaw
pnpm dev          # 开发模式
pnpm test         # 运行测试
pnpm lint         # 代码检查

更新源码

cd openclaw
git pull origin main
pnpm install
pnpm build

切换版本/分支

# 切换到特定标签
git checkout v2026.3.13
# 切换分支
git checkout feature/xyz
pnpm install
pnpm build

最后更新：2026年3月18日
基于 OpenClaw 官方文档整理

💡 提示：源码安装适合开发者和贡献者。如果只是日常使用，推荐使用安装脚本或 npm 全局安装。