一文搞定 OpenClaw 安装!全平台详细教程来了

嘿，我是不秋！今天给大家带来 OpenClaw 的完整安装指南，不管你是 macOS、Linux 还是 Windows 用户，都能找到适合你的安装方式～

🦞 什么是 OpenClaw？

在开始安装之前，先快速了解一下 OpenClaw 是什么：

OpenClaw 是一个强大的 AI Agent 框架，让你能够轻松创建、管理和部署智能助手。它提供了：

•🎯 统一的任务执行平台 - 整合各种 AI 能力和工具•🔧 丰富的技能系统 - 支持文件操作、浏览器自动化、飞书集成等•📱 多渠道消息支持 - 可以连接到 Discord、Telegram、微信等平台•🤖 子代理协作 - 支持多 Agent 协同完成复杂任务•📊 可视化管理界面 - 通过 Dashboard 轻松监控和管理

简单说，OpenClaw 就是你的 AI 助手"操作系统"，让 AI 真正帮你干活！

📋 安装前准备

系统要求

•Node.js: Node 24（推荐）或 Node 22 LTS（22.16+）•操作系统: macOS、Linux 或 Windows•特别说明: Windows 用户强烈建议使用 WSL2

检查 Node.js 版本

打开终端，输入：

node -vnpm -v

如果还没安装 Node.js，别担心，安装脚本会自动帮你处理！

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

这是最简单、最推荐的安装方式，一键搞定所有配置！

macOS / Linux / WSL2 用户

打开终端，复制粘贴以下命令：

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

然后按提示完成新手引导就 OK 啦！

Windows 用户

打开 PowerShell，输入：

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

💡 高级选项

如果你想跳过新手引导，只安装二进制文件：

macOS / Linux / WSL2：

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

Windows：

&([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

📦 方法二：npm/pnpm 安装

如果你已经自己管理 Node.js，可以用这种方式。

使用 npm 安装

# 安装 OpenClawnpm install -g openclaw@latest# 运行新手引导并安装守护进程openclaw onboard --install-daemon

⚠️ 遇到 sharp 构建错误？

如果你看到 sharp 相关的错误，试试这个方法：

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

如果提示需要 node-gyp，先安装构建工具链：

# macOSxcode-select--installnpm install -g node-gyp# 然后重新安装npm install -g openclaw@latest

使用 pnpm 安装

# 安装 OpenClawpnpm add -g openclaw@latest# 批准构建脚本（重要！）pnpm approve-builds -g# 运行新手引导openclaw onboard --install-daemon

注意： pnpm 会要求你显式批准带有构建脚本的包。首次安装出现 "Ignored build scripts" 警告后，运行 pnpm approve-builds -g 并选择列出的包（openclaw、node-llama-cpp、sharp 等）。

安装最新开发版

想体验最新的 GitHub main 分支版本：

# npmnpm install -g github:openclaw/openclaw#main# pnpmpnpm add -g github:openclaw/openclaw#main

💻 方法三：从源码安装

适合贡献者或想深度定制的小伙伴。

步骤 1：克隆仓库

git clone https://github.com/openclaw/openclaw.gitcd openclaw

步骤 2：安装依赖并构建

pnpm installpnpm ui:buildpnpm build

步骤 3：链接 CLI

让 openclaw 命令全局可用：

pnpm link --global

或者你也可以直接在仓库内运行：

pnpm openclaw ...

步骤 4：运行新手引导

openclaw onboard --install-daemon

🐳 其他安装方式

OpenClaw 还支持更多安装方式，满足特殊需求：

方式	适用场景
Docker	容器化部署、无头服务器
Podman	无 root 权限的容器环境
Nix	声明式系统配置
Ansible	批量自动化部署
Bun	仅 CLI 使用场景

具体教程可以参考官方文档：https://docs.openclaw.ai

✅ 安装完成后的验证

安装完成后，运行以下命令检查一切是否正常：

# 检查配置问题openclaw doctor# 查看 Gateway 状态openclaw status# 打开浏览器管理界面openclaw dashboard

如果所有检查都通过，恭喜你，安装成功！🎉

🔧 常见问题排查

问题 1：找不到 `openclaw` 命令

运行以下命令诊断：

node -vnpm -vnpm prefix -gecho "$PATH"

如果 $(npm prefix -g)/bin 不在你的 $PATH 中，需要添加到 shell 配置文件：

macOS/Linux（~/.zshrc 或 ~/.bashrc）：

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

Windows： 将 npm prefix -g 的输出添加到系统 PATH 环境变量中。

然后打开新终端（或运行 rehash/hash -r）。

问题 2：Windows 用户注意事项

强烈建议使用 WSL2 运行 OpenClaw：

1.安装 WSL2：https://learn.microsoft.com/en-us/windows/wsl/install2.在 WSL2 中按照 Linux 的安装步骤操作

这样可以避免很多兼容性问题！

问题 3：VPS/云主机安装

重要提示： 尽量避免使用第三方"一键式"市场镜像。

推荐做法：

•选择干净的基础 OS 镜像（如 Ubuntu LTS）•使用官方安装脚本自行安装

🆙 更新与卸载

更新 OpenClaw

# 使用安装脚本更新curl -fsSL https://openclaw.ai/install.sh | bash# 或使用 npm 更新npm install -g openclaw@latest

卸载 OpenClaw

# 使用安装脚本卸载curl -fsSL https://openclaw.ai/install.sh | bash -s -- --uninstall# 或手动删除npm uninstall -g openclaw

详细教程：https://docs.openclaw.ai/install/updating

🎯 下一步做什么？

安装完成后，你可以：

1.阅读入门指南 - https://docs.openclaw.ai/start/getting-started2.探索技能系统 - 了解如何使用文件操作、浏览器自动化等技能3.配置消息渠道 - 连接到 Discord、Telegram 等平台4.创建你的第一个 Agent - 开始构建专属 AI 助手

💬 需要帮助？

遇到问题？以下资源可以帮到你：

•📚 官方文档 - https://docs.openclaw.ai•💻 GitHub 仓库 - https://github.com/openclaw/openclaw•🎮 技能市场 - https://clawhub.ai•💬 社区 Discord - https://discord.com/invite/clawd

📝 小结

以上就是 OpenClaw 的完整安装教程啦！总结一下：

✅ 推荐方式：使用安装脚本，一键搞定✅ 系统要求：Node 24（或 22.16+），macOS/Linux/Windows✅ Windows 用户：强烈建议使用 WSL2✅ 验证安装：openclaw doctor + openclaw status✅ 遇到问题：检查 PATH 配置，参考官方文档

安装过程中遇到任何问题，欢迎在社区提问！不秋在这里等你～ 🦞