前言

OpenClaw 是一个开源的个人 AI 网关，可以将你喜爱的聊天应用（WhatsApp、Telegram、Discord、iMessage 等）连接到 AI 模型（如 Claude、GPT 等），让你通过熟悉的聊天工具与 AI 交互。

本文将详细介绍 OpenClaw 的安装步骤，帮助你快速搭建属于自己的 AI 助手网关。

系统要求

在开始安装之前，请确保你的系统满足以下要求：

要求	详情
Node.js	Node 24（推荐）或 Node 22.14+
操作系统	macOS、Linux 或 Windows（原生支持 + WSL2）
WSL2（Windows）	Windows 上更推荐使用 WSL2
其他	pnpm 仅在从源码构建时需要

推荐安装方式：安装脚本

官方提供了自动安装脚本，可以自动检测操作系统、安装 Node（如果需要）和 OpenClaw，并启动新手引导。

macOS / Linux / WSL2

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

Windows (PowerShell)

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

安装时不运行新手引导

如果你只想安装而不想立即运行引导程序，可以使用以下命令：

# macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

# Windows (PowerShell)
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

其他安装方式

1. npm 安装

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

2. pnpm 安装

pnpm add -g openclaw@latest
pnpm approve-builds -g  # 首次安装后需要运行
openclaw onboard --install-daemon

3. Bun 安装（实验性）

bun add -g openclaw@latest
openclaw onboard --install-daemon

⚠️ Bun 支持用于全局 CLI 安装路径。对于 Gateway 网关运行时，Node 仍然是推荐的守护进程运行时。

4. 解决 sharp 构建错误

如果 sharp 因全局安装的 libvips 而失败，可以尝试：

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

5. 从源码安装（适用于贡献者）

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm ui:build && pnpm build
pnpm link --global
openclaw onboard --install-daemon

验证安装

安装完成后，可以使用以下命令验证安装是否成功：

# 确认 CLI 可用
openclaw --version

# 检查配置问题
openclaw doctor

# 验证 Gateway 网关正在运行
openclaw gateway status

安装后配置

设置系统托管启动

为了让 OpenClaw 在系统启动时自动运行，需要安装守护进程：

系统	命令
macOS	openclaw onboard --install-daemon 或 openclaw gateway install
Linux/WSL2	相同命令，会安装 systemd 用户服务
Windows	优先使用 Scheduled Task；回退到按用户的 Startup 文件夹登录项

故障排除

找不到 openclaw 命令

如果安装成功但终端中找不到 openclaw，可以按以下步骤排查：

node -v           # 检查 Node 是否已安装
npm prefix -g     # 查看全局软件包安装位置
echo "$PATH"      # 检查全局 bin 目录是否在 PATH 中

解决方案：将 npm 全局 bin 目录添加到 PATH：

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

将以上内容添加到 shell 启动文件（~/.zshrc 或 ~/.bashrc），然后打开新终端。

Docker 部署（可选）

对于喜欢使用容器的用户，OpenClaw 也支持 Docker 部署：

docker run -d \
  --name openclaw \
    -p 3000:3000 \
      openclaw/openclaw
      ```
## 总结

OpenClaw 提供多种安装方式，最简单的是使用官方安装脚本。安装完成后，通过 `openclaw onboard` 完成初始配置，即可开始使用你的个人 AI 网关。

如果遇到问题，可以查看官方文档或运行 `openclaw doctor` 进行诊断。

---
*标签：OpenClaw、AI、网关、安装教程、自托管*