首页 / 教程 / 安装 OpenClaw
⏱️ 预计 10 分钟
🟢 入门
📋 前置：准备工作清单
🎯 学完这一课，你将能够：
  • ✓ 在电脑上成功安装 OpenClaw
  • ✓ 运行新手引导配置
  • ✓ 确认 Gateway 正常运行

学习目标

在 10 分钟内，把 OpenClaw 安装到你的电脑上，并让它跑起来。

概念解释

安装 OpenClaw 就像给电脑装一个”翻译官”。这个翻译官住在你的电脑里（不是在云端），你跟它说话，它帮你调用各种 AI 大模型来回答。安装过程只需要一条命令，就像在手机应用商店点一下”安装”一样简单。装好之后，你需要告诉它你要用哪个 AI 模型（比如 GPT-4、Claude 等），并且提供一把”钥匙”（API Key），这样翻译官才能帮你连接到对应的 AI 服务。

动手做

第一步：确认你的电脑准备好了

在安装之前，请确认你已经完成上一课的准备工作：

  • 已经安装了 Node.js 24（推荐），或 Node.js 22.14+
  • 网络连接正常
  • 有一个 AI 模型的 API Key（比如 OpenAI、Anthropic 等）

怎么确认 Node.js 装好了？ 打开终端（Terminal / PowerShell），输入：

node -v

如果看到类似 v24.0.0 或 v22.16.0 这样的版本号，就说明没问题。 如果提示”找不到命令”，请先回去安装 Node.js。

第二步：选择你的安装方式

OpenClaw 提供了三种安装方式，选择适合你的那一种：

安装方式适合谁命令
官方脚本（推荐）Mac / Linux 用户curl -fsSL https://openclaw.ai/install.sh | bash
官方脚本（推荐）Windows 用户iwr -useb https://openclaw.ai/install.ps1 | iex
npm 安装所有平台npm install -g openclaw

下面按平台分别讲解。

方式 A：Windows 用户安装步骤

A1. 打开 PowerShell（管理员模式）

  1. 点击屏幕左下角的 开始菜单（或按键盘上的 Windows 键）
  2. 在搜索框中输入 PowerShell
  3. 看到 Windows PowerShell 的图标后，右键点击它
  4. 选择 “以管理员身份运行”
  5. 如果弹出”是否允许此应用对设备进行更改”的提示，点击 “是”

为什么要管理员模式？ 因为安装软件需要往系统目录写文件，普通权限可能不够。就像你要在家里装一个新插座，需要更高的权限一样。

你应该会看到一个蓝色背景的窗口，标题栏写着”管理员: Windows PowerShell”。

A2. 执行安装命令

在 PowerShell 窗口中，复制并粘贴以下命令，然后按回车：

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

快捷粘贴方法： 在 PowerShell 中，按鼠标右键就可以粘贴内容。

A3. 等待下载完成

你会看到一些文字在滚动，这是正常的，表示正在下载和安装。整个过程大约需要 1-3 分钟，取决于你的网速。

看到类似 OpenClaw v2026.4.1 的提示，就说明安装成功了！

A4. 验证安装

输入以下命令，确认安装成功：

openclaw --version

如果显示版本号（比如 v2026.4.1），恭喜你，安装成功！

如果提示”找不到命令”？ 尝试关闭 PowerShell 窗口，重新打开一个新的，再试一次。有时候需要重启终端才能识别新安装的命令。

方式 B：Mac 用户安装步骤

B1. 打开终端

  1. 按 Command + 空格 打开聚焦搜索
  2. 输入 终端（或 Terminal）
  3. 按回车打开

B2. 执行安装命令

在终端窗口中，复制并粘贴以下命令，然后按回车：

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

B3. 可能需要输入密码

安装过程中，可能会提示你输入电脑密码。输入时屏幕上不会显示任何字符（这是安全设计），输入完成后直接按回车就好。

为什么看不到密码？ 这是 Mac/Linux 的安全设计。虽然你看不到，但系统确实在接收你输入的密码。放心输入，按回车即可。

B4. 验证安装

openclaw --version

看到版本号就说明成功了。

方式 C：Linux 用户安装步骤

和 Mac 完全一样：

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

然后验证：

openclaw --version

方式 D：用 npm 安装（所有平台通用）

如果上面的脚本方式因为网络问题失败了，可以用 npm 来安装：

npm install -g openclaw

国内用户加速安装： 如果官方 npm 源很慢，可以使用国内镜像：

npm install -g openclaw --registry=https://registry.npmmirror.com

这条命令会把下载源切换到国内的 npmmirror 镜像站，速度通常会快很多。

第三步：运行新手引导（Onboard）

安装好之后，我们需要做一次初始化配置。这一步会通过一个交互式向导帮你完成所有设置。

在终端中运行：

openclaw onboard --install-daemon

向导会带你走过以下步骤（用上下方向键选择，回车确认）：

步骤 1：选择认证方式

你会看到一个认证选项列表：

? 选择认证方式:
  ❯ DeepSeek API Key
    OpenAI API Key
    Anthropic API Key
    Google Gemini API Key
    ...
    Custom API Key (自定义)

选择你注册的 AI 服务对应的选项。

不知道选哪个？ 如果你是按照第 2 课的建议注册了 DeepSeek，就选 “DeepSeek API Key”。

步骤 2：输入 API Key

选择认证方式后，向导会提示你输入 API Key：

? 请输入你的 API Key: _

把你从 AI 平台获得的 API Key 粘贴进去，按回车。

API Key 是什么？ 它就像一把钥匙，证明你有权限使用这个 AI 服务。通常是一串以 sk- 开头的长字符串。 如果还没有，可以回去完成第 2 课的注册步骤。

安全提醒： API Key 是你的私钥，不要分享给别人，也不要提交到公开平台。

步骤 3：配置 Gateway

向导会自动配置 Gateway（网关），包括端口号（默认 18789）和认证令牌。大部分情况直接用默认值就行。

步骤 4：渠道配置（可选）

向导会问你是否要连接聊天渠道（Telegram、WhatsApp 等）。作为新手，可以先跳过这一步，使用浏览器控制台来跟 AI 对话就行。后面第 8 课和第 11 课再学怎么连接聊天工具。

步骤 5：Web Search 配置（可选）

向导会问你是否要配置网络搜索功能。可以先跳过，后面在 Skills 课程中再配置。

步骤 6：安装 Daemon（后台服务）

向导最后会问你是否安装后台服务（Daemon），这样 OpenClaw 会在后台自动运行。

? 是否安装 Daemon (后台服务)? (Y/n)

输入 Y 并按回车确认。

看到类似 Onboarding completed! 的提示，就说明配置全部完成了！

第四步：检查 Gateway 是否在运行

运行以下命令检查状态：

openclaw gateway status

你应该看到类似这样的输出：

Gateway is running on port 18789
Status: healthy
Uptime: 2m 30s

如果你看到 running 和 healthy，说明一切正常！

如果显示未运行？ 尝试手动启动：

openclaw gateway --port 18789

这种方式是”前台运行”，窗口不能关闭。适合调试用。确认没问题后，按 Ctrl + C 停止，然后用后台模式启动。

检查你的成果

完成以上步骤后，逐项确认：

检查项命令期望结果
OpenClaw 已安装openclaw --version显示版本号（如 2026.4.1）
配置文件已生成openclaw doctor显示所有项目为绿色/OK
Gateway 正在运行openclaw gateway status显示 running / healthy

三项全部通过？太棒了，你已经成功安装了 OpenClaw！

常见失败排查

问题 1：提示”权限被拒绝”（Permission denied）

症状： 安装命令执行后报错 EACCES permission denied。

原因： 系统不允许在当前目录写入文件。

解决方案：

Mac / Linux 用户： 在命令前面加 sudo：

sudo npm install -g openclaw

输入你的电脑密码即可。

Windows 用户： 确保你用的是”管理员模式”的 PowerShell，参考上面 A1 步骤 重新操作。

问题 2：网络超时 / 下载失败

症状： 安装过程中卡住不动，或者提示 network timeout、ETIMEDOUT。

原因： 网络连接不稳定，或者官方服务器在国内访问较慢。

解决方案：

使用 npm 镜像安装：

npm install -g openclaw --registry=https://registry.npmmirror.com

如果你在用公司或学校的网络，可能存在代理限制，试试切换到手机热点再试。

问题 3：Node.js 版本太低

症状： 安装时报错 engine 相关错误，或者 openclaw 命令运行后崩溃。

原因： OpenClaw 需要 Node.js 24（推荐）或 22.14+。

解决方案：

先检查你的 Node.js 版本：

node -v

如果版本低于 22.14（比如显示 v20.x.x 或 v18.x.x），需要升级 Node.js：

  • Windows / Mac： 去 Node.js 官网 下载最新的 LTS 版本重新安装
  • Mac（用 Homebrew）： brew upgrade node
  • Linux： 使用 nvm（Node Version Manager）来管理版本

挑战任务

安装只是第一步，试试下面的小挑战来巩固你的学习：

  1. 查看配置文件： 用文本编辑器打开 ~/.openclaw/openclaw.json，看看里面都记录了什么信息。你能找到你选择的模型名称吗？
  2. 前台运行模式： 运行 openclaw gateway --port 18789 以前台模式启动，观察控制台输出了什么信息。然后按 Ctrl + C 停止它。
  3. 尝试切换模型： 如果你有多个 AI 服务商的 API Key，试着修改配置文件，切换到另一个模型，然后重启 Gateway 看看是否生效。

下一课预告： 装好了 OpenClaw，接下来就是激动人心的时刻了——和你的 AI 助手进行第一次对话！

上一篇
准备工作清单
下一篇
第一次对话