如何安装 OpenClaw：完整分步安装指南 2026

简介

安装 OpenClaw 非常简单，有多种方法可以满足不同的喜好和技术舒适度。无论您想要快速的单行安装、更喜欢 npm 还是想要从源代码构建，本指南涵盖了所有选项。

本指南涵盖 macOS、Windows 和 Linux 上的安装。有关特定于平台的详细信息，请参阅我们的专用指南：

• macOS 设置指南
• Windows 设置指南
• Linux 设置指南

先决条件

在安装 OpenClaw 之前，请确保您拥有：

• Node.js 18+ — 运行 OpenClaw 所必需的（单行安装程序会自动处理此问题）
• 终端访问 — 系统上的命令行界面
• 互联网连接 — 用于下载包和依赖项
• 2GB+ RAM — 建议平稳运行

如果 Node.js 尚不存在，单行安装程序将自动安装它，因此即使您没有安装 Node.js，也可以继续。

安装方法

方法 1：单行安装（推荐）

让 OpenClaw 运行的最快方法是单行安装程序。它自动处理 Node.js 安装和所有依赖项。

macOS/Linux

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

该脚本将：

1. 检查Node.js（如果缺少则安装）
2. 通过npm全局安装OpenClaw
3. 设置必要的权限
4. 验证安装

安装完成后，你会看到：

✓ OpenClaw installed successfully!
  Run 'openclaw onboard' to get started.

Windows（PowerShell）

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

或者使用 npm 方法（见下文），该方法在 Windows 上的工作方式相同。

方法2：npm安装

如果你已经安装了 Node.js，你可以直接通过 npm 安装 OpenClaw：

npm i -g openclaw

这会全局安装 OpenClaw，使 openclaw 命令在系统范围内可用。

使用 pnpm：

pnpm add -g openclaw

使用纱线：

yarn global add openclaw

方法 3：可破解安装（从源代码）

对于想要修改源代码或做出贡献的开发人员，您可以从源代码构建 OpenClaw：

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm run build

然后使用以下命令运行 OpenClaw：

pnpm run openclaw onboard

或者全局链接：

pnpm link --global

此方法使您可以完全控制代码库，并可以轻松地根据您的需求自定义 OpenClaw。

方法 4：macOS 配套应用程序（测试版）

对于 macOS 用户，有一个配套的菜单栏应用程序，它除了 CLI 之外还提供 GUI 界面：

1. 从 GitHub 版本 下载
2. 打开.dmg文件
3. 将 OpenClaw 拖至应用程序
4. 从应用程序或 Spotlight 启动

配套应用程序与 CLI 安装一起工作，并提供：

• 菜单栏访问
• 视觉状态指示器
• 快速设置访问
• 日志查看器

要求：

• macOS 14+（索诺玛或更高版本）
• 通用二进制（适用于 Apple Silicon 和 Intel）

系统要求

macOS

• macOS 13 Ventura 或更高版本
• Node.js 18+（由 one-liner 自动安装）
• 推荐 2GB+ 内存
• Apple Silicon (M1/M2/M3) 或英特尔处理器

窗口

• Windows 10 或 Windows 11
• Node.js 18+
• PowerShell 5.1+ 或 Windows 终端
• 推荐 WSL2 以获得最佳体验

Linux

• Ubuntu 20.04+、Debian 11+、Fedora 34+ 或类似版本
• Node.js 18+
• 2GB+ 内存
• ARM64或x86_64架构
• 支持树莓派 4+

安装后设置

安装后，您需要在使用前配置OpenClaw。运行入职命令：

openclaw onboard

此交互式设置将引导您完成：

1.AI模型选择选择您的人工智能提供商：

• AnthropicClaude — Claude 3.5 十四行诗、Claude 3 作品、Claude 4
• OpenAI GPT — GPT-4o、GPT-4 Turbo、GPT-4.1
• 本地模型 — Ollama、LM Studio、MiniMax

您将需要云模型的 API 密钥。对于 Claude，请从 console.anthropic.com 获取密钥。对于 OpenAI，请从 platform.openai.com 获取密钥。

2.角色配置

设置你的人工智能的个性：

• 名称（默认：“龙虾”）
• 语气和风格
• 能力和限制
• 响应偏好

3. 内存设置

配置持久内存：

• 存储位置
• 内存保留策略
• 上下文窗口大小

4. 初始技能

选择要启用的默认技能：

• 电子邮件管理
• 日历集成
• 浏览器控制
• 文件系统访问

验证安装

安装后，验证一切正常：

openclaw --version

您应该看到版本号（例如 v1.0.0）。

测试安装：

openclaw test

这会运行快速诊断以确保所有组件正常工作。

连接聊天应用程序

安装并配置 OpenClaw 后，连接您的聊天应用程序：

openclaw integrations

这将打开一个交互式菜单进行设置：

• WhatsApp
• 电报
• Discord
• 松弛
• i消息
• 其他平台

有关详细设置指南，请参阅：

• WhatsApp 设置
• 电报设置
• Discord 设置
• Slack 设置
• iMessage 设置

启动 OpenClaw

启动 OpenClaw 服务器：

openclaw

这将启动本地服务器并连接所有配置的集成。您将看到状态消息，指示哪些聊天应用程序已连接。

要在后台运行：

openclaw start --daemon

或者使用像 pm2 这样的进程管理器：

npm i -g pm2
pm2 start openclaw
pm2 save
pm2 startup

故障排除

安装失败

如果单行安装程序失败：

1. 检查Node.js版本：

   node --version

   应该是 v18 或更高版本。

2. 直接尝试npm install：

   npm i -g openclaw

3. 检查权限：

   sudo npm i -g openclaw

   （仅限 macOS/Linux）

未找到命令

如果未找到 openclaw 命令：

1. 检查npm全局路径：

   npm config get prefix

2. 添加到路径（如果需要）：

   export PATH="$PATH:$(npm config get prefix)/bin"

3. 安装后重启终端

端口已在使用中

如果您看到“端口已在使用”错误：

openclaw --port 3001

或者找到并终止使用该端口的进程：

lsof -ti:3000 | xargs kill

权限错误

在 macOS/Linux 上，您可能需要授予权限：

• 终端访问
• 文件系统访问
• 网络访问

检查系统偏好设置 → 安全和隐私。

更新 OpenClaw

要更新到最新版本：

npm update -g openclaw

或者重新运行单行安装程序（如果已安装，它将更新）。

检查更新：

npm outdated -g openclaw

卸载 OpenClaw

要删除 OpenClaw：

npm uninstall -g openclaw

这将删除全局安装，但保留您的配置和数据。要删除所有内容：

rm -rf ~/.openclaw

后续步骤

现在 OpenClaw 已安装：

1. 探索技能 — 查看可用技能 /skills
2. 设置集成 — 连接您的聊天应用程序（请参阅集成页面）
3. 阅读常见问题解答 — 常见问题解答见 /faq
4. 加入社区 - Discord、GitHub 讨论等

结论安装 OpenClaw 既快速又简单。一行安装程序可处理大部分复杂性，使所有技术水平的用户都可以使用它。安装后，openclaw onboard 命令将指导您完成配置。

有关特定于平台的提示和高级设置选项，请参阅我们的详细指南：

• macOS 设置
• Windows 设置
• Linux 设置

准备好开始使用您的个人人工智能助理了吗？运行 openclaw onboard 并开始设置过程！