OpenClaw 在各系统安装教程：Windows(WSL2)/Mac/Linux/服务器一键部署

摘要：本文是 2026 年最新的 OpenClaw 完整安装指南，覆盖 Windows(WSL2)、Mac、Linux、云服务器四大主流平台。无论你是技术新手还是资深开发者，都能找到适合自己的安装方案。文章详细演示了一键部署脚本、环境配置、渠道接入等全流程，并提供常见问题排查方案，帮助你 10 分钟内完成 AI 私人助手的搭建。

适用版本：OpenClaw 2026.3.x
阅读时间：约 15 分钟
难度等级：新手友好

一、安装前准备

1.1 系统要求

平台	系统要求	Node.js	内存	硬盘
Windows	Windows 10/11 64 位	v22+	8GB+	10GB+
Mac	macOS 12+	v22+	8GB+	10GB+
Linux	Ubuntu 22.04+	v22+	4GB+	5GB+
WSL2	Windows 10/11 + WSL2	v22+	8GB+	10GB+
服务器	主流 Linux 发行版	v22+	2GB+	5GB+

1.2 准备工作

必须准备的资料：

AI 模型 API Key（任选其一）：
- OpenAI API Key：platform.openai.com
- 阿里云百炼 API Key：bailian.console.aliyun.com
- 月之暗面 Kimi API Key：platform.moonshot.cn
推荐使用aliyun、腾讯云、火山方舟或者各大模型大厂的coding plan套餐，新手选择几十块钱的入门套餐就够用了。
聊天工具 Bot（任选其一）：
- Telegram Bot Token（推荐）
- 飞书 Bot App ID 和 App Secret
- 微信 ClawBot（需邀请码）
运行环境：
- Node.js v22+（安装脚本会自动检测）
- 稳定的网络连接（需访问 GitHub 和 npm）

1.3 选择适合你的安装方案

方案	适用人群	难度	耗时	优点
一键脚本	新手首选	⭐	5 分钟	自动配置所有环境
WSL2 部署	Windows 用户	⭐⭐	10 分钟	兼容性好，功能完整
手动安装	开发者	⭐⭐⭐	15 分钟	可自定义配置
服务器部署	企业用户	⭐⭐	10 分钟	24 小时在线

二、Mac 本地部署（最简单）

2.1 系统检查

打开终端，检查系统版本：

bash

sw_vers

确保 macOS 版本 ≥ 12.0。

2.2 一键安装

步骤 1：打开终端

按 Command + 空格
搜索「终端」
打开终端应用

步骤 2：执行安装命令

bash

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

步骤 3：等待安装完成

安装脚本会自动检测并安装 Node.js
自动安装 OpenClaw 和所有依赖
过程约 3-5 分钟

步骤 4：验证安装

bash

openclaw --version

能看到版本号就说明安装成功。

2.3 初始化配置

启动新手引导：

bash

openclaw onboard

配置流程：

接受风险提示：输入 yes
选择启动模式：选择 Gateway 模式
选择 AI 模型：选择你准备好的模型（如 OpenAI、Kimi 等）
输入 API Key：粘贴你的 API Key
选择聊天工具：选择 Telegram 或飞书
配置 Bot：输入 Bot Token 或 App ID/Secret
设置管理员：输入你的聊天工具 ID
完成配置：等待服务启动

2.4 验证安装

发送测试消息：

bash

openclaw status

在聊天工具中发送「你好」，如果 AI 回复说明配置成功！

三、Windows 部署方案

Windows 用户有两种选择：WSL2 部署（推荐） 或 PowerShell 原生部署。

3.1 方案一：WSL2 + Ubuntu 部署（强烈推荐）

步骤 1：启用 WSL2

以管理员身份打开 PowerShell：

powershell

wsl --install

这个命令会：

启用 WSL 功能
自动安装 Ubuntu 发行版
设置 WSL2 为默认版本

完成后重启电脑。

步骤 2：配置 Ubuntu

重启后，在开始菜单找到「Ubuntu」并打开：

设置用户名和密码（首次启动）
更新系统：
bash
```
sudo apt update && sudo apt upgrade -y
```
验证 WSL 版本：
bash
```
wsl --version
```
确保显示版本 2。

步骤 3：安装 Node.js

在 Ubuntu 终端执行：

bash

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

验证安装：

bash

node --version
npm --version

步骤 4：安装 OpenClaw

bash

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

步骤 5：配置并启动

bash

openclaw onboard

按照提示完成配置（参考 Mac 部分的配置流程）。

步骤 6：Windows 访问 WSL2 服务

WSL2 的默认端口是 http://localhost:3000，在 Windows 浏览器中直接访问即可。

3.2 方案二：PowerShell 原生部署

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

在开始菜单搜索「PowerShell」
右键选择「以管理员身份运行」

步骤 2：安装 Node.js

方法 A：官网安装（推荐）

访问 nodejs.org
下载 Windows 安装程序（LTS 版本）
双击安装，一路下一步

方法 B：使用 winget

powershell

winget install OpenJS.NodeJS.LTS

步骤 3：验证 Node.js 安装

powershell

node --version
npm --version

步骤 4：安装 OpenClaw

powershell

npm install -g openclaw@latest

如果遇到权限错误：

powershell

# 修改 npm 安装目录
npm config set prefix "$HOME\npm-global"
# 重新安装
npm install -g openclaw@latest

步骤 5：启动并配置

powershell

openclaw onboard

按照提示完成配置。

3.3 常见问题排查

问题 1：sharp 模块加载失败

powershell

# 重新安装 sharp
npm rebuild sharp

问题 2：Windows Defender 拦截

临时关闭实时保护
或将 OpenClaw 添加到白名单

问题 3：权限不足

确保以管理员身份运行 PowerShell
或使用 WSL2 方案

四、Linux 部署方案

4.1 Ubuntu/Debian 系统

步骤 1：更新系统

bash

sudo apt update && sudo apt upgrade -y

步骤 2：安装 Node.js

bash

# 添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -

# 安装 Node.js
sudo apt-get install -y nodejs

# 验证
node --version
npm --version

步骤 3：安装 OpenClaw

bash

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

步骤 4：配置并启动

bash

openclaw onboard

步骤 5：设置为系统服务（可选）

让 OpenClaw 开机自启动：

bash

openclaw daemon install
openclaw daemon start

4.2 CentOS/RHEL 系统

步骤 1：安装 Node.js

bash

# 安装 Node.js 22
curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
sudo yum install -y nodejs

步骤 2：安装依赖

bash

sudo yum install -y git curl

步骤 3：安装 OpenClaw

bash

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

4.3 常见问题

问题：curl 命令找不到

bash

# Ubuntu/Debian
sudo apt install -y curl

# CentOS/RHEL
sudo yum install -y curl

问题：权限不足

bash

# 使用 sudo 执行安装命令
curl -fsSL https://openclaw.ai/install.sh | sudo bash

五、云服务器一键部署

5.1 适用场景

需要 24 小时在线
本地电脑性能不足
团队协作共享
生产环境部署

5.2 云服务器选择

云厂商	推荐配置	月费用	优点
阿里云	2 核 4G	¥60+	国内访问快，生态完善
腾讯云	2 核 4G	¥50+	性价比高，客服好
华为云	2 核 4G	¥55+	安全性好，政企首选
AWS	t3.small	¥40+	全球部署，稳定性好

5.3 部署步骤

步骤 1：购买云服务器

选择配置：

CPU：2 核
内存：4GB
系统：Ubuntu 22.04 LTS
带宽：1Mbps 起步

步骤 2：SSH 连接服务器

Windows 用户：

powershell

ssh root@你的服务器 IP

Mac/Linux 用户：

bash

ssh root@你的服务器 IP

步骤 3：一键部署

bash

# 更新系统
sudo apt update && sudo apt upgrade -y

# 安装 OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash

# 配置
openclaw onboard

步骤 4：设置为守护进程

bash

# 安装守护进程
openclaw daemon install

# 启动服务
openclaw daemon start

# 查看状态
openclaw daemon status

步骤 5：配置防火墙

阿里云/腾讯云：

登录云服务器控制台
找到「安全组」或「防火墙」
添加入站规则：
- 端口：3000
- 协议：TCP
- 来源：0.0.0.0/0

5.4 远程访问

在本地浏览器访问：

http://你的服务器 IP:3000

六、配置接入聊天工具

6.1 Telegram Bot 配置（推荐）

步骤 1：创建 Bot

在 Telegram 中搜索 @BotFather
发送 /newbot 命令
按提示设置 Bot 名称
复制 Bot Token（格式：123456:ABC-DEF1234...）

步骤 2：配置 OpenClaw

bash

openclaw config channels

选择 Telegram，粘贴 Bot Token。

步骤 3：启动 Bot

在 Telegram 中搜索你的 Bot，发送 /start。

6.2 飞书 Bot 配置

步骤 1：创建飞书应用

访问飞书开发者平台
创建企业自建应用
添加机器人权限
获取 App ID 和 App Secret

步骤 2：配置事件订阅

订阅方式选择「长连接（WebSocket）」
订阅事件：
- im.message
- im.chat
- bot.status

步骤 3：配置 OpenClaw

bash

openclaw config channels

选择飞书，输入 App ID 和 App Secret。

6.3 微信 ClawBot 配置

注意：微信 ClawBot 目前需要邀请码，请联系官方获取。

七、日常使用命令

7.1 基础命令

bash

# 启动 OpenClaw
openclaw start

# 停止 OpenClaw
openclaw stop

# 重启 OpenClaw
openclaw restart

# 查看状态
openclaw status

# 查看版本
openclaw --version

7.2 守护进程命令

bash

# 安装守护进程
openclaw daemon install

# 启动守护进程
openclaw daemon start

# 停止守护进程
openclaw daemon stop

# 查看守护进程状态
openclaw daemon status

# 卸载守护进程
openclaw daemon uninstall

7.3 配置管理

bash

# 重新配置
openclaw onboard

# 查看配置
openclaw config show

# 编辑配置
openclaw config edit

# 验证配置
openclaw config validate

7.4 日志查看

bash

# 查看实时日志
openclaw logs

# 查看最近 50 行日志
openclaw logs -n 50

# 清空日志
openclaw logs clear

八、常见问题排查

8.1 安装问题

问题 1：Node.js 版本不兼容

bash

# 检查版本
node --version

# 升级 Node.js
nvm install 22
nvm use 22

问题 2：npm 权限错误

bash

# 修改 npm 全局安装目录
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

问题 3：网络连接超时

bash

# 配置 npm 淘宝镜像
npm config set registry https://registry.npmmirror.com

# 重新安装
npm install -g openclaw@latest

8.2 启动问题

问题 1：启动失败

bash

# 查看详细错误
openclaw start --verbose

# 检查配置
openclaw config validate

# 查看日志
journalctl -u openclaw -n 50

问题 2：端口被占用

bash

# 查看端口占用
lsof -i :3000

# 修改配置中的端口
openclaw config edit

问题 3：API Key 无效

检查 API Key 是否正确复制
确认 API Key 有足够额度
尝试更换其他 AI 模型

8.3 聊天工具问题

问题 1：Bot 无响应

检查 Bot Token 是否正确
确认事件订阅已配置
查看 Bot 是否有发送消息权限

问题 2：消息发送失败

bash

# 检查渠道状态
openclaw channels status

# 重新配置渠道
openclaw config channels

8.4 性能问题

问题：内存占用过高

bash

# 查看内存使用
openclaw status

# 重启服务
openclaw restart

# 优化配置，减少并发任务数
openclaw config edit

九、下一步

安装完成后，你可以：

学习基础对话：学习如何与 OpenClaw 进行第一次对话，掌握基础指令和回复技巧
配置更多技能：了解 ClawHub 技能市场，为你的 AI 助手添加更多实用技能
设置定时任务：创建自动化工作流，让 AI 定时执行特定任务
接入更多渠道：配置多渠道支持，让用户可以通过不同平台与 AI 交互

OpenClaw 在各系统安装教程：Windows(WSL2)/Mac/Linux/服务器一键部署

OpenClaw 在各系统安装教程：Windows(WSL2)/Mac/Linux/服务器一键部署 ​

一、安装前准备 ​

1.1 系统要求 ​

1.2 准备工作 ​

1.3 选择适合你的安装方案 ​

二、Mac 本地部署（最简单） ​

2.1 系统检查 ​

2.2 一键安装 ​

2.3 初始化配置 ​

2.4 验证安装 ​

三、Windows 部署方案 ​

3.1 方案一：WSL2 + Ubuntu 部署（强烈推荐） ​

步骤 1：启用 WSL2 ​

步骤 2：配置 Ubuntu ​

步骤 3：安装 Node.js ​

步骤 4：安装 OpenClaw ​

步骤 5：配置并启动 ​

步骤 6：Windows 访问 WSL2 服务 ​

3.2 方案二：PowerShell 原生部署 ​

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

步骤 2：安装 Node.js ​

步骤 3：验证 Node.js 安装 ​

步骤 4：安装 OpenClaw ​

步骤 5：启动并配置 ​

3.3 常见问题排查 ​

四、Linux 部署方案 ​

4.1 Ubuntu/Debian 系统 ​

步骤 1：更新系统 ​

步骤 2：安装 Node.js ​

步骤 3：安装 OpenClaw ​

步骤 4：配置并启动 ​

步骤 5：设置为系统服务（可选） ​

4.2 CentOS/RHEL 系统 ​

步骤 1：安装 Node.js ​

步骤 2：安装依赖 ​

步骤 3：安装 OpenClaw ​

4.3 常见问题 ​

五、云服务器一键部署 ​

5.1 适用场景 ​

5.2 云服务器选择 ​

5.3 部署步骤 ​

步骤 1：购买云服务器 ​

步骤 2：SSH 连接服务器 ​

步骤 3：一键部署 ​

步骤 4：设置为守护进程 ​

步骤 5：配置防火墙 ​

5.4 远程访问 ​

六、配置接入聊天工具 ​

6.1 Telegram Bot 配置（推荐） ​

步骤 1：创建 Bot ​

步骤 2：配置 OpenClaw ​

步骤 3：启动 Bot ​

6.2 飞书 Bot 配置 ​

步骤 1：创建飞书应用 ​

步骤 2：配置事件订阅 ​

步骤 3：配置 OpenClaw ​

6.3 微信 ClawBot 配置 ​

七、日常使用命令 ​

7.1 基础命令 ​

7.2 守护进程命令 ​

7.3 配置管理 ​

7.4 日志查看 ​

八、常见问题排查 ​

8.1 安装问题 ​

8.2 启动问题 ​

8.3 聊天工具问题 ​

8.4 性能问题 ​

九、下一步 ​

OpenClaw 在各系统安装教程：Windows(WSL2)/Mac/Linux/服务器一键部署

小龙虾 OpenClaw 安装失败排查指南：10 个最高频错误（2026 最新版）

Claude Code国内安装教程：Mac/Windows全覆盖，有无魔法都覆盖

Hermes Agent原生Windows支持：一行命令安装完整教程

Claude Code Windows桌面端安装：配合DeepSeek V4国内直用

Windows下Claude Code从安装到跑通：VSCode可视化配置全教程（新手友好）

Claude Code保姆级安装教程：Windows小白也能看懂

Hermes Agent安装教程：Windows系统避坑指南

双AI Agent协同实战：OpenClaw+Hermes同机部署完整指南

不要孤军奋战啦！

OpenClaw 在各系统安装教程：Windows(WSL2)/Mac/Linux/服务器一键部署

一、安装前准备

1.1 系统要求

1.2 准备工作

1.3 选择适合你的安装方案

二、Mac 本地部署（最简单）

2.1 系统检查

2.2 一键安装

2.3 初始化配置

2.4 验证安装

三、Windows 部署方案

3.1 方案一：WSL2 + Ubuntu 部署（强烈推荐）

步骤 1：启用 WSL2

步骤 2：配置 Ubuntu

步骤 3：安装 Node.js

步骤 4：安装 OpenClaw

步骤 5：配置并启动

步骤 6：Windows 访问 WSL2 服务

3.2 方案二：PowerShell 原生部署

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

步骤 2：安装 Node.js

步骤 3：验证 Node.js 安装

步骤 4：安装 OpenClaw

步骤 5：启动并配置

3.3 常见问题排查

四、Linux 部署方案

4.1 Ubuntu/Debian 系统

步骤 1：更新系统

步骤 2：安装 Node.js

步骤 3：安装 OpenClaw

步骤 4：配置并启动

步骤 5：设置为系统服务（可选）

4.2 CentOS/RHEL 系统

步骤 1：安装 Node.js

步骤 2：安装依赖

步骤 3：安装 OpenClaw

4.3 常见问题

五、云服务器一键部署

5.1 适用场景

5.2 云服务器选择

5.3 部署步骤

步骤 1：购买云服务器

步骤 2：SSH 连接服务器

步骤 3：一键部署

步骤 4：设置为守护进程

步骤 5：配置防火墙

5.4 远程访问

六、配置接入聊天工具

6.1 Telegram Bot 配置（推荐）

步骤 1：创建 Bot

步骤 2：配置 OpenClaw

步骤 3：启动 Bot

6.2 飞书 Bot 配置

步骤 1：创建飞书应用

步骤 2：配置事件订阅

步骤 3：配置 OpenClaw

6.3 微信 ClawBot 配置

七、日常使用命令

7.1 基础命令

7.2 守护进程命令

7.3 配置管理

7.4 日志查看

八、常见问题排查

8.1 安装问题

8.2 启动问题

8.3 聊天工具问题

8.4 性能问题

九、下一步