系统要求#

什么是 Node.js？ Node.js 是一个运行 JavaScript 的环境，OpenClaw 用它来运行。你不需要懂 JavaScript，安装脚本会自动帮你装好 Node.js。

方式一：Windows Hub 桌面应用（最简单）#

这是最适合小白的方式，有图形界面，点点鼠标就能完成。

第一步：下载安装包

1. 打开浏览器，访问 https://openclaw.ai
2. 找到 “Download for Windows” 按钮，点击下载
3. 等待下载完成（文件大概几十 MB）

第二步：安装

1. 打开下载文件夹，找到刚下载的安装包（.exe 文件）
2. 双击运行安装包
3. 如果弹出 Windows 安全提示 “Windows 已保护你的电脑”：
   • 点击 “更多信息”
   • 然后点击 “仍要运行”
4. 按照安装向导点 “下一步” → “安装” → “完成”

第三步：首次启动

1. 安装完成后，桌面会出现 OpenClaw 图标，双击打开
2. 或者在开始菜单搜索 “OpenClaw” 打开
3. 应用会自动引导你完成初始设置：
   • 选择 AI 模型（推荐 OpenAI 或 Anthropic）
   • 输入 API 密钥
   • 连接消息平台（微信/飞书等）

完成！ 你现在可以在桌面应用里直接跟 AI 对话了。

方式二：PowerShell 命令安装#

如果你更喜欢用命令行，或者 Windows Hub 安装失败，可以用这种方式。

第一步：打开 PowerShell

1. 按键盘上的 Win 键（就是有 Windows 图标的那个键）
2. 输入 “powershell”
3. 在搜索结果中找到 “Windows PowerShell”
4. 右键 → 选择 “以管理员身份运行”
5. 如果弹出 “是否允许此应用对你的设备进行更改？“，点 “是”

什么是 PowerShell？ PowerShell 是 Windows 自带的命令行工具，类似于一个文字版的”控制台”。你在里面输入命令，电脑就会执行。

第二步：设置执行权限（第一次需要）

PowerShell 默认不允许运行脚本，需要先解除限制。复制下面的命令，粘贴到 PowerShell 中，按 回车键 执行：

1
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned -Force

怎么粘贴？ 复制命令后，在 PowerShell 窗口里 右键 就能粘贴。

第三步：运行安装命令

复制下面的命令，粘贴到 PowerShell 中，按 回车键：

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

第四步：等待安装完成

安装脚本会自动做以下事情（你不需要操作，等着就行）：

1. ✅ 检测你的电脑系统
2. ✅ 安装 Node.js（如果还没有）
3. ✅ 安装 OpenClaw
4. ✅ 启动设置向导

整个过程大概 2-5 分钟，取决于你的网速。

第五步：跟着设置向导走

安装完成后会自动启动设置向导，它会问你几个问题：

1. 选择 AI 模型提供商 — 比如 OpenAI（ChatGPT）、Anthropic（Claude）等
2. 输入 API 密钥 — 去对应平台的网站申请一个 API Key 填进去
3. 选择连接的消息平台 — 微信、飞书、Telegram 等

第六步：验证安装

在 PowerShell 中输入：

1
openclaw --version

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

再输入：

1
openclaw doctor

这会检查你的安装是否完整，如果有问题会告诉你怎么修。

第七步：启动 OpenClaw

1
openclaw onboard --install-daemon

这个命令会：

• 完成最后的配置
• 安装后台服务（开机自动启动）
• 启动 Gateway

方式一：命令行安装#

第一步：打开终端

1. 按 Command + 空格键 打开 Spotlight 搜索
2. 输入 “终端” 或 “Terminal”
3. 按 回车键 打开终端

什么是终端？ 终端是 Mac 的命令行工具。你在里面输入文字命令，电脑就会执行。看起来有点像电影里的黑客界面，但其实很简单。

第二步：运行安装命令

复制下面的命令，粘贴到终端中（粘贴快捷键是 Command + V），按 回车键：

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

第三步：输入密码

安装过程中可能会要求输入你的 Mac 开机密码（就是你登录 Mac 时用的密码）。

为什么输密码看不见？ 这是正常的！终端输入密码时不会显示任何字符（连星号都没有）。直接输入密码，然后按回车就行。

第四步：等待安装完成

安装脚本会自动做以下事情：

1. ✅ 安装 Homebrew（Mac 的软件管理器，如果还没有的话）
2. ✅ 安装 Node.js v24（通过 Homebrew）
3. ✅ 安装 OpenClaw
4. ✅ 启动设置向导

整个过程大概 3-8 分钟，取决于你的网速和电脑速度。

Apple Silicon（M1/M2/M3/M4 芯片）用户注意： 安装脚本会自动检测你的芯片类型，安装对应版本。不需要额外操作。

第五步：跟着设置向导走

安装完成后会自动启动设置向导：

1. 选择 AI 模型提供商 — 比如 OpenAI（ChatGPT）、Anthropic（Claude）等
2. 输入 API 密钥 — 去对应平台的网站申请一个 API Key 填进去
3. 选择连接的消息平台 — 微信、飞书、Telegram 等

第六步：验证安装

在终端输入：

1
openclaw --version

如果显示版本号，安装成功！

再检查一下：

1
openclaw doctor
2
openclaw gateway status

第七步：启动 OpenClaw

1
openclaw onboard --install-daemon

这会安装一个 LaunchAgent（macOS 的后台服务），让 OpenClaw 开机自动启动。

方式二：手动安装（已有 Node.js）#

如果你的 Mac 上已经安装了 Node.js（版本 22.19+ 或 24），可以跳过自动安装脚本。

检查 Node.js 版本：

1
node --version

• 如果显示 v24.x.x 或 v22.19+，可以直接用
• 如果没有或者版本太低，先装 Node.js：

  1
  brew install node@24

直接用 npm 安装 OpenClaw：

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

Ubuntu / Debian#

1
# 1. 安装依赖
2
sudo apt update
3
sudo apt install -y git curl
4

5
# 2. 一键安装 OpenClaw
6
curl -fsSL https://openclaw.ai/install.sh | bash
7

8
# 3. 跟着设置向导走
9

10
# 4. 验证
11
openclaw --version
12
openclaw doctor

CentOS / Fedora / RHEL#

1
# Fedora / RHEL 9+
2
sudo dnf install -y git curl
3

4
# CentOS 7/8
5
sudo yum install -y git curl
6

7
# 一键安装
8
curl -fsSL https://openclaw.ai/install.sh | bash

Arch Linux#

1
sudo pacman -S git curl
2
curl -fsSL https://openclaw.ai/install.sh | bash

iOS#

1. 在 App Store 搜索 “OpenClaw” 下载
2. 打开应用，扫描电脑端的配对二维码
3. 支持语音唤醒、TTS 朗读

Android#

1. 在 Google Play 或 F-Droid 搜索 “OpenClaw” 下载
2. 打开应用，扫描电脑端的配对二维码
3. 支持持续语音对话

1. 配置 AI 模型#

OpenClaw 支持多种 AI 模型提供商：

1
openclaw model

常用提供商：

没有 API Key 怎么办？ 去对应平台的网站注册账号，在 API Keys 页面创建一个。大部分平台新用户有免费额度。

2. 配置 API 密钥#

1
# 交互式设置
2
openclaw setup
3

4
# 或直接指定
5
openclaw config set OPENAI_API_KEY ***

3. 检查状态#

1
openclaw doctor          # 检查安装和配置
2
openclaw gateway status  # 检查 Gateway 运行状态
3
openclaw --version       # 确认版本

飞书#

1
openclaw channel setup feishu

按提示输入飞书机器人的 App ID 和 App Secret。

Telegram#

1
openclaw channel setup telegram

需要先在 Telegram 找 @BotFather 创建一个 Bot，拿到 Token。

Discord#

1
openclaw channel setup discord

需要在 Discord Developer Portal 创建一个 Bot 应用。

微信#

1
openclaw channel setup wechat

Slack#

1
openclaw channel setup slack

更多平台#

1
openclaw channel list    # 查看所有支持的平台
2
openclaw channel setup   # 交互式选择

更新#

1
openclaw update

卸载#

1
openclaw uninstall

手动清理（可选）：

1
# 删除配置数据
2
rm -rf ~/.openclaw
3

4
# 删除全局命令
5
npm uninstall -g openclaw

openclaw: command not found#

Windows：

1
# 重新打开 PowerShell，再试一次
2
openclaw --version