OpenClaw全平台安装教程：Windows/macOS/Linux手把手教你搞定

OpenClaw 是 2026 年最火的开源 AI Agent 框架，但很多新手卡在了第一步——安装。这篇文章帮你从零到跑通，三个平台全覆盖。

📋 一、安装前准备

在开始安装之前，先确认你的电脑满足以下基本条件：

💡 不想手动装 Node.js？ 没关系——OpenClaw 的一键安装脚本会自动帮你检测并安装 Node 环境。

🚀 二、推荐安装方式（一键脚本）

这是最简单、最推荐的安装方式，适合绝大多数用户。

✅ macOS / Linux

打开终端（Terminal），粘贴以下命令并回车：

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

✅ Windows

强烈建议使用 WSL2 环境。如果你还没有安装 WSL2，先在 PowerShell（管理员）中运行：

wsl --install

然后在 WSL2 终端中执行：

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

或者直接在 PowerShell 中运行：

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

🎯 脚本会自动帮你做什么？

安装脚本不是简单地把文件丢进去，它会自动完成以下工作：

• ✅ 检测系统中是否已安装 Node.js
• ✅ 如果没有，自动安装 Node 24
• ✅ 安装 OpenClaw 核心程序
• ✅ 启动交互式新手引导（onboard）
• ✅ 引导你配置 AI 模型和聊天平台

⏱️ 整个安装过程通常只需要 2-5 分钟（取决于网络速度）。

📦 三、使用 npm 安装（适合有 Node 经验的用户）

如果你已经熟悉 Node.js 环境，也可以用 npm 直接安装：

使用 npm

npm install -g openclaw@latestopenclaw onboard --install-daemon

使用 pnpm

pnpm add -g openclaw@latestpnpm approve-builds -gopenclaw onboard --install-daemon

常见问题速查

如果安装时遇到 sharp 构建错误：

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

如果提示缺少 node-gyp：

# macOSxcode-select --installnpm install -g node-gyp# Ubuntu/Debiansudo apt install build-essentialnpm install -g node-gyp

🔧 四、初次配置（onboard）

安装完成后，运行配置向导：

openclaw onboard --install-daemon

配置向导会引导你完成以下 4 个步骤：

Step 1：选择 AI 模型

OpenClaw 支持多种主流 AI 模型，根据你的需求选择：

Step 2：添加 API Key

从你选择的 AI 供应商获取 API Key，粘贴到配置中。

🔒 安全提示：API Key 会安全地存储在本地 ~/.openclaw/.env 文件中，不会上传到任何第三方服务器。

Step 3：连接聊天平台

OpenClaw 支持通过多种平台与 AI 对话：

• 💬 WhatsApp — 扫码即可连接
• ✈️ Telegram — 输入 Bot Token
• 📱 Discord — 创建 Bot 并授权
• 💼 Slack — 适合团队使用
• 📧 Google Chat — 企业协作
• 📲 iMessage — macOS 用户专属

Step 4：发送测试消息

配置完成后，向你连接的聊天平台发送一条测试消息，比如：

"你好，你能做什么？"

如果收到 AI 的回复，说明配置成功！

🐧 五、Docker 安装（适合服务器部署）

如果你想把 OpenClaw 部署到服务器上，Docker 是最佳选择：

# 拉取镜像并启动docker run -d \  --name openclaw \  -v ~/.openclaw:/home/node/.openclaw \  -p 3000:3000 \  openclaw/openclaw:latest

Docker 部署的优势：

• 🔄 环境隔离，不污染宿主系统
• 📦 一键部署，方便迁移
• 🛡️ 更安全，适合生产环境
• ⬆️ 升级方便，拉新镜像即可

✅ 六、验证安装

安装和配置完成后，运行以下命令确认一切正常：

# 检查版本openclaw --version# 环境诊断（推荐！）openclaw doctor# 查看网关状态openclaw status# 打开 Web 控制面板openclaw dashboard

💡 如果 openclaw 命令找不到，说明 npm 全局路径没有加入系统 PATH。解决方法见下方常见问题。

❓ 七、常见问题排查

问题1：命令提示"找不到 openclaw"

原因：npm 全局安装路径没有加入系统 PATH。

macOS / Linux 解决方法：

# 查找 npm 全局路径npm prefix -g# 将以下内容添加到 ~/.zshrc（或 ~/.bashrc）export PATH="$(npm prefix -g)/bin:$PATH"# 重新加载配置source ~/.zshrc

Windows 解决方法：

# 查看 npm 全局路径npm prefix -g# 将输出的路径添加到系统 PATH 环境变量# 方法：系统属性 → 高级 → 环境变量 → Path → 新建

问题2：安装时报 sharp 错误

# 方法1：设置环境变量SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest# 方法2：使用 pnpm 代替pnpm add -g openclaw@latest

问题3：Windows 上体验不佳

OpenClaw 官方强烈建议 Windows 用户使用 WSL2，而不是直接在原生 Windows 上运行。

# 安装 WSL2（管理员 PowerShell）wsl --install# 重启后在 WSL2 中安装 OpenClawcurl-fsSL https://openclaw.ai/install.sh | bash

问题4：网络连接问题（国内用户）

如果因为网络原因无法访问 npm registry，可以切换国内镜像：

# 使用淘宝镜像npm config set registry https://registry.npmmirror.com# 安装完成后恢复默认（可选）npm config set registry https://registry.npmjs.org

🔄 八、更新与卸载

更新到最新版本

# 如果用一键脚本安装的curl -fsSL https://openclaw.ai/install.sh | bash# 如果用 npm 安装的npm update -g openclaw# 如果用 pnpm 安装的pnpm update -g openclaw

卸载

# npm 全局卸载npm uninstall -g openclaw# 删除配置文件（可选）rm -rf ~/.openclaw

📊 各平台安装方式对比

🏆 最佳实践：macOS/Linux 用一键脚本，Windows 用 WSL2 + 一键脚本，服务器用 Docker。

写在最后

OpenClaw 的安装其实并不复杂，核心就三步：

1. 装 Node.js（或者让脚本帮你装）
2. 运行安装命令（一行搞定）
3. 配置 AI 模型（跟着向导走）

如果你在安装过程中遇到任何问题，可以：

• 📖 查看官方文档：docs.openclaw.ai
• 💬 加入 Discord 社区求助
• 🔍 在 GitHub Issues 中搜索类似问题

你在哪个平台上安装的 OpenClaw？遇到了什么问题？欢迎在评论区交流👇

📌 实用链接汇总

• OpenClaw 官网：github.com/openclaw/openclaw
• 官方文档：docs.openclaw.ai/zh-CN/install
• GitHub 仓库：github.com/openclaw/openclaw
• Discord 社区：discord.gg/openclaw

如果觉得这篇教程对你有帮助，别忘了👇

• ❤️ 点赞 —— 让更多人看到
• ⭐ 收藏 —— 安装时随时翻出来参考
• 🔄 转发 —— 分享给需要的朋友
• 💬 留言 —— 说说你的安装体验和踩坑经历
• 关注我 —— 持续分享 AI 工具教程和深度评测

我们下篇见！ 🦞

本文基于 2026 年 3 月 OpenClaw 官方文档整理，安装步骤以官方最新版本为准。

*我是安忆，关注AI 进展，每日更新。我们下期见！*