🦞 OpenClaw 完全指南

🍎

macOS 安装指南

ℹ️ 系统要求

macOS 10.15+ | 需要管理员密码 | 稳定的网络连接

📋 安装前准备

确保 Mac 已连接互联网
知道 Mac 的管理员密码（安装时需要）
关闭 VPN 或代理（安装完成后再开启）

💿 方法 1：直接下载安装包（最简单）推荐

▼

适合不熟悉命令行的用户，双击安装即可

📥 下载安装包

版本：OpenClaw 2026.3.2 (macOS)

文件大小：约 180 MB

⬇️ 下载 OpenClaw-2026.3.2.dmg

📋 安装步骤

点击上方按钮下载 .dmg 文件
双击打开下载的 DMG 文件
将 OpenClaw 图标拖拽到 Applications 文件夹
首次运行请在「系统设置」→「隐私与安全性」中允许打开

⚠️ 注意

macOS 可能会提示「无法验证开发者」，这是正常的。

解决方法：打开「系统设置」→「隐私与安全性」→ 找到「OpenClaw」→ 点击「仍要打开」

🚀 方法 2：安装脚本（最兼容）

▼

适合大多数用户，自动安装所有依赖

⚠️ 注意

安装过程中会提示输入 Mac 密码，这是正常的

Terminal

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

❌ 如果遇到网络连接错误

如果看到 Failed to connect 或下载失败错误，说明网络连接有问题。

解决方法：切换到方法 3（手动下载安装）

等待安装完成，然后运行引导向导：

Terminal

openclaw onboard --install-daemon

📦 方法 3：手动下载安装（如果脚本失败）

▼

当自动脚本无法使用时使用

📥 步骤 1：下载 Node.js

访问 nodejs.org 下载 LTS 版本（左侧大按钮）

双击下载的 pkg 文件，按提示安装（需要管理员密码）

📥 步骤 2：安装 OpenClaw

Terminal

npm install -g openclaw@latest

Terminal

openclaw onboard --install-daemon

✅ 验证安装

Terminal

# 检查 Gateway 状态
openclaw gateway status

# 运行健康检查
openclaw doctor

# 打开管理界面
openclaw dashboard

🎉 安装完成

如果看到状态显示 "running"，说明安装成功！

✨

macOS 特有功能

🎙️ 语音唤醒 (Voice Wake)

💬 Talk Mode 连续对话

🎨 Live Canvas 可视化

📷 相机/屏幕录制

🔔 系统通知集成

🖱️ Peekaboo UI 自动化

🐧

Linux 安装指南

ℹ️ 系统要求

Ubuntu 20.04+ / Debian 11+ / CentOS 8+ | 需要 sudo 权限

📋 安装前准备

确保系统已连接互联网
拥有 sudo 权限（知道管理员密码）
已安装 curl 命令（大多数系统已预装）

🚀 方法 1：安装脚本（推荐）

最简单快捷的安装方式

⚠️ 注意

安装过程中会提示输入 sudo 密码

Terminal

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

❌ 如果遇到网络连接错误

如果看到 Failed to connect to deb.nodesource.com 错误，说明无法连接到 Node.js 官方源。

解决方法：切换到方法 2（手动安装），使用系统自带的软件源安装 Node.js

Terminal

openclaw onboard --install-daemon

📦 方法 2：手动安装（如果脚本失败或网络受限）

📥 步骤 1：安装 Node.js

Ubuntu / Debian（使用系统源）：

Terminal

# 更新软件源
sudo apt update

# 安装 Node.js（使用系统自带源）
sudo apt install -y nodejs npm

# 检查版本
node --version

CentOS / RHEL / Fedora：

Terminal

# 安装 Node.js（使用系统自带源）
sudo dnf install -y nodejs npm

# 检查版本
node --version

⚠️ Node.js 版本检查

运行 node --version 查看版本，要求 v22 或更高。

如果版本低于 v22，请使用以下命令升级：

Terminal

# 安装 n 版本管理器
sudo npm install -g n

# 安装 Node.js 22
sudo n 22

# 验证版本
node --version

📥 步骤 2：安装 OpenClaw

Terminal

# 安装 OpenClaw
sudo npm install -g openclaw@latest

# 初始化配置
openclaw onboard --install-daemon

🪟

Windows 安装指南

ℹ️ 系统要求

Windows 10/11 (64位) | 需要管理员权限 | 稳定的网络连接

📋 安装前准备

确保 Windows 已连接互联网
拥有管理员权限（安装时需要）
关闭杀毒软件或添加排除项（部分杀毒软件可能误报）

🚀 方法 1：安装脚本（推荐）

最简单快捷的安装方式

⚠️ 注意

安装过程中会提示 UAC（用户账户控制），请点击「是」允许

步骤 1：打开 PowerShell（以管理员身份）

右键点击开始菜单 → Windows PowerShell（管理员）

步骤 2：运行安装命令

PowerShell

irm https://openclaw.ai/install.ps1 | iex

❌ 如果遇到执行策略错误

如果看到 无法加载脚本，因为在此系统上禁止运行脚本 错误：

PowerShell

# 临时更改执行策略（仅当前会话）
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process -Force
irm https://openclaw.ai/install.ps1 | iex

步骤 3：初始化配置

PowerShell

openclaw onboard --install-daemon

📦 方法 2：手动安装（如果脚本失败）

📥 步骤 1：下载 Node.js

访问 nodejs.org 下载 LTS 版本（左侧大按钮）

双击下载的 msi 文件，按提示安装（需要管理员权限）

📥 步骤 2：安装 OpenClaw

打开 PowerShell（以管理员身份），运行以下命令：

PowerShell

npm install -g openclaw@latest

PowerShell

openclaw onboard --install-daemon

✅ 验证安装

PowerShell

# 检查 Gateway 状态
openclaw gateway status

# 运行健康检查
openclaw doctor

❓ Windows 常见问题

问题：命令无法识别

如果提示 openclaw 不是内部或外部命令：

关闭 PowerShell，重新以管理员身份打开
或者重启电脑后再试

问题：杀毒软件拦截

部分杀毒软件可能误报 OpenClaw：

将 OpenClaw 安装目录添加到杀毒软件排除项
或暂时关闭杀毒软件后重新安装