OpenClaw 安装教程

本教程将带你从零开始完成 OpenClaw 的安装。整个过程大约需要 15 分钟。

什么是 OpenClaw？

OpenClaw 是一个自托管的 AI Gateway，让你可以从终端或任意聊天应用（Discord、Telegram、WhatsApp 等）访问 AI 代理。它支持 OpenAI、Anthropic、Gemini 等多种模型提供商，是一个功能强大的 AI 工具中枢。

前置要求

要求	说明
操作系统	macOS、Linux、Windows（WSL2 或原生）
Node.js	版本 24（推荐）或 22.19+
Git	任意较新版本
网络	能够访问 openclaw.ai

第一步：安装 Node.js

OpenClaw 推荐 Node.js 24 版本。

推荐使用 Homebrew 安装：

bash

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

# 安装 Node.js（推荐 v24）
brew install node@24

# 验证安装
node --version  # 应显示 v24.x.x
npm --version

Node.js 版本要求

OpenClaw 推荐 Node.js 24，最低支持 22.19+。请使用 node --version 确认版本。

第二步：安装 OpenClaw

使用官方安装脚本，一键完成安装：

bash

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

Windows 用户使用 PowerShell：

powershell

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

安装脚本会自动检测系统环境，安装所需依赖，并启动引导向导。

第三步：验证安装

bash

openclaw --version      # 确认 CLI 已安装
openclaw doctor         # 检查配置问题
openclaw gateway status # 查看 Gateway 状态

如果看到版本号输出，说明安装成功。

安装完成！

OpenClaw 已成功安装。安装脚本会自动启动引导向导，引导你完成后续配置。也可以手动运行 openclaw onboard 进入引导流程。

常见问题

openclaw 命令找不到

bash

# 检查 Node.js 是否安装
node -v

# 查看全局包路径
npm prefix -g

# 将全局 bin 目录加入 PATH
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

如何更新 OpenClaw？

bash

openclaw update