OpenClaw 安装教程

一、教程说明

这是一份适合发布到知识库、博客或内部 Wiki 的 OpenClaw 安装指南。整体结构偏实战，尽量把“怎么装、装完做什么、报错怎么查”一次讲清楚。

建议只使用官方安装脚本或官方发布页，不要随便下载第三方安装包，避免碰到假仓库或恶意文件。

二、安装前准备

开始前，先确认你的环境满足以下条件：

支持系统：macOS、Linux、Windows
Node.js 22 或更高版本
如果需要源码构建，通常还会用到 pnpm
Windows 用户优先建议使用 WSL2

三、官方脚本安装（推荐）

这是最推荐的安装方式，适合大多数技术用户，尤其适合 macOS、Linux 和 WSL2。

1）macOS / Linux / WSL2

打开终端
执行官方安装命令

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

这条命令通常会自动完成以下操作：

检测 Node 环境
必要时自动安装 Node
安装 OpenClaw CLI
进入初始化流程

安装完成后，建议立即验证：

openclaw --version
openclaw doctor

如果没有自动进入初始化，可以手动执行：

openclaw onboard --install-daemon

最后启动服务：

openclaw gateway start

四、Windows 安装步骤

如果你不想使用 WSL2，也可以直接在 PowerShell 中安装。

1）PowerShell 安装

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

安装完成后执行：

openclaw --version
openclaw doctor
openclaw onboard
openclaw gateway start

如果安装完成后提示 openclaw 不是内部或外部命令，先关闭并重新打开 PowerShell，很多情况下只是 PATH 还没刷新。

五、已有 Node 环境时的安装方式

如果你的系统已经有 Node.js 22+，可以直接通过 npm 或 pnpm 安装。

npm 安装

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

pnpm 安装

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

六、安装后配置

安装完成后，通常还需要完成两类配置：

1）配置模型服务

OpenAI
Anthropic
Gemini
OpenRouter
Groq
Mistral
自定义 Base URL + API Key

2）配置接入平台

Telegram
Discord
WhatsApp
Slack
WeChat
Feishu
iMessage（通常仅 macOS）

七、常用命令速查

openclaw --version
openclaw doctor
openclaw onboard
openclaw gateway start
openclaw gateway stop
openclaw logs --follow

八、常见问题与解决方法

1）openclaw: command not found

通常是 PATH 没配置好。先检查：

node -v
npm -v
npm prefix -g
echo "$PATH"

如果 npm 全局 bin 不在 PATH 中，可以加入：

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

2）sharp 安装失败

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

如果提示缺少 node-gyp：

npm install -g node-gyp

3）Windows 找不到命令

先重开 PowerShell，再执行一次 openclaw --version。

4）服务启动失败

openclaw logs --follow

重点检查 API Key、网络、防火墙和平台 Token。

5）macOS 提示“未验证开发者”

打开系统设置 → 隐私与安全性 → 仍要打开，或右键应用选择“打开”。

九、图形化安装方式

如果你不想使用命令行，也可以考虑桌面安装器。

macOS

下载 DMG 安装包
打开 DMG
拖到 Applications
启动应用
执行 openclaw onboard

Windows

下载 EXE 安装包
双击安装
启动应用
执行 openclaw onboard

十、推荐安装方案

Windows 用户：优先选择 WSL2 + 官方脚本安装
macOS / Linux 用户：优先选择 官方脚本安装
不想用命令行：可选桌面安装器

如果只是想尽快跑起来，直接执行安装脚本，然后依次运行 openclaw --version、openclaw doctor、openclaw onboard、openclaw gateway start 即可。

十一、如何挂到 Cloudflare Pages

这份页面已经适合做成一个静态单页，你可以直接用 index.html 部署到 Cloudflare Pages。

把当前文件保存为 index.html
新建一个文件夹，例如 openclaw-site
把 index.html 放进去
上传到 GitHub 仓库，或者直接拖拽到 Cloudflare Pages
Cloudflare 构建设置选择“静态站点”即可，无需额外构建命令

Build command: （留空）
Build output directory: /

如果你走 GitHub 连接部署，仓库根目录放一个 index.html 就可以直接发布。