安装OpenClaw,官方教程指引

点击蓝字关注我们

安装准备、须知

OpenClaw 安装指南（本地部署）

📌 什么是 OpenClaw？OpenClaw 是一个自托管的 AI 助手网关，可以让你通过 WhatsApp、Telegram、Discord 等聊天软件，随时随地与你的 AI 助手对话。

安装前准备

你需要什么？

项目	要求
操作系统	macOS、Windows 或 Linux
Node.js	版本 22.16 或更高（推荐 24）
API Key	需要一个 AI 服务商的密钥（如 Anthropic、OpenAI）

💡 别担心 Node.js！ 官方安装脚本会自动帮你安装 Node.js，不需要手动操作。

安装操作步骤

MacOS 安装步骤（推荐方式）

第一步：打开终端

点击屏幕右上角的 放大镜图标（Spotlight 搜索）
输入 终端 或 Terminal
点击打开

第二步：运行安装命令

把下面这行命令复制粘贴到终端，然后按回车：

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

第三步：等待安装完成

你会看到类似这样的输出：

Installing Node.js...Installing OpenClaw...Running onboarding...

安装过程大约需要 2-3 分钟，请耐心等待。

第四步：运行配置向导

安装完成后，运行：

openclaw onboard --install-daemon

这个向导会：

让你选择 AI 服务商（如 Anthropic、OpenAI）
输入你的 API Key（从服务商网站获取）
配置网关服务

第五步：验证安装

在终端输入：

openclaw --version

如果显示版本号（如 1.x.x），说明安装成功！

第六步：打开控制面板

openclaw dashboard

浏览器会自动打开 OpenClaw 的控制面板，地址是 http://127.0.0.1:18789/

Windows 安装步骤

方式一：WSL2 安装（推荐，更稳定）

什么是 WSL2？WSL2 是 Windows 的 Linux 子系统，让 Windows 可以运行 Linux 程序，OpenClaw 在里面运行更稳定。

步骤 1：安装 WSL2

右键点击 开始菜单，选择 Windows PowerShell (管理员)
粘贴以下命令，按回车：
```
wsl --install
```
重启电脑（如果提示）
重启后，Ubuntu 会自动启动，设置用户名和密码

步骤 2：启用 systemd（重要）

在 Ubuntu 终端中输入：

sudotee /etc/wsl.conf >/dev/null <<'EOF'[boot]systemd=trueEOF

然后在 PowerShell 中输入：

wsl --shutdown

重新打开 Ubuntu。

步骤 3：安装 OpenClaw

在 Ubuntu 终端中输入：

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

步骤 4：运行配置向导

openclaw onboard --install-daemon

步骤 5：打开控制面板

openclaw dashboard

方式二：Windows 原生安装（简单但功能有限）

如果你不想用 WSL2，可以直接在 Windows 上安装：

右键点击 开始菜单，选择 Windows PowerShell (管理员)

粘贴以下命令，按回车：

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

等待安装完成
运行配置向导：
```
openclaw onboard --install-daemon
```

⚠️ 注意：原生 Windows 安装功能有限，建议使用 WSL2 方式。

FAQ常见问题解决

常见问题解决

问题 1：提示 “openclaw: command not found”

原因：系统找不到 OpenClaw 命令

解决方法：

macOS / Linux：

找到 npm 的全局安装路径：
```
npm prefix -g
```
会输出类似 /usr/local 的路径

把这个路径加到系统 PATH：

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

永久生效（添加到配置文件）：
```
echo'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc
```
（如果用 bash，把 .zshrc 换成 .bashrc）
重新打开终端

Windows：

打开 设置 → 系统 → 关于 → 高级系统设置
点击 环境变量
在 系统变量 中找到 Path，点击编辑
点击新建，添加 npm prefix -g 输出的路径
点击确定，重新打开 PowerShell

问题 2：安装时提示权限错误（Linux/macOS）

原因：没有权限写入全局目录

解决方法：

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

然后把 export PATH="$HOME/.npm-global/bin:$PATH" 添加到 ~/.zshrc 或 ~/.bashrc

问题 3：如何获取 API Key？

Anthropic (Claude)
：访问 https://console.anthropic.com/ → 注册账号 → 创建 API Key
OpenAI (GPT)
：访问 https://platform.openai.com/ → 注册账号 → 创建 API Key
Google (Gemini)
：访问 https://ai.google.dev/ → 获取 API Key

问题 4：如何检查 Node.js 版本？

node -v

如果显示 v24.x.x 或 v22.16.x 以上，就符合要求。

如果 Node 没有安装，安装脚本会自动安装，不需要手动操作。

安装完成后

常用命令

命令	作用
`openclaw --version`	查看版本
`openclaw doctor`	检查配置问题
`openclaw gateway status`	查看网关状态
`openclaw dashboard`	打开控制面板
`openclaw onboard`	重新运行配置向导