<style>.toc-chapters{max-height:none!important}.copy-btn,#sidebar-toggle,#fullscreen-toggle{display:none!important}@media(max-width:768px){.tutorial-app{display:flex;height:auto;overflow:visible;flex-direction:column}.tutorial-main{order:0;overflow:visible}.tutorial-content{overflow:visible}.tutorial-sidebar{order:1;position:static!important;width:100%!important;min-width:0!important;max-height:none!important;display:flex!important;transform:none!important}.sidebar-toc{overflow:visible}}</style>
首页 › OpenClaw 从入门到精通 ›第 2 章 · 安装和快速启动

第 2 章：安装 OpenClaw，5 分钟搞定

适合人群：零基础普通用户 本章目标：把 OpenClaw 装到你的电脑上，并完成初始化

⚠️ 安装命令、支持系统与初始化向导可能会调整。开始操作前，请以 OpenClaw 当前官方安装文档为准。

2.1 环境要求

先检查一下你的电脑能不能装。其实要求很低：

硬件要求

  • 内存：2GB 以上（推荐 4GB+）
  • 硬盘：2GB 可用空间就够了
  • CPU：任何近 5 年的电脑都可以

操作系统

  • macOS：Intel 或 Apple Silicon（M1/M2/M3/M4）都可以
  • Windows：Windows 10/11
  • Linux：Ubuntu、Debian、CentOS 等都支持

必装依赖

OpenClaw 基于 Node.js，所以需要先装 Node.js。

等等，Node.js 是什么？ 你可以把 Node.js 理解成一个"运行环境"——就像看电影需要播放器一样，OpenClaw 需要 Node.js 才能运行。 推荐版本：Node 24（最新稳定版） 最低版本：Node 22.19+

📌 老用户注意：如果你的 Node 版本比较低，安装脚本会自动检测并帮你更新，不用自己操心。

2.2 安装方式一：curl 安装脚本（推荐）

这是最简单、最推荐的方式，适合大多数人。打开一个命令：

curl 是一个跟网址交换数据的命令，bash 是执行脚本。整条命令的意思是：从 OpenClaw 官网下载安装脚本，然后自动运行。

macOS / Linux

打开「终端」（Terminal）App，粘贴下面这一整行，按回车：

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

Windows

打开 PowerShell（建议以管理员身份运行），粘贴：

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

安装脚本会自动帮你：

  1. ✅ 检查系统上有没有 Node.js
  2. ✅ 如果没有，自动安装最新版 Node.js
  3. ✅ 下载并安装 OpenClaw
  4. ✅ 自动启动初始化向导（下一步会讲）

整个过程大概 1-3 分钟，取决于你的网速。

不想自动启动初始化？ 加个参数：

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

2.3 安装方式二：npm install

适合：已经装了 Node.js，习惯用 npm 的朋友

如果你已经装了 Node.js，也可以直接用 npm 安装：

npm install -g openclaw@latest

这里的参数说明：

  • -g：全局安装，装好后在任何目录都能用
  • @latest：安装最新版本

装完后运行初始化：

openclaw onboard --install-daemon

安装后找不到命令行？

有时候装完后在终端里输入 openclaw 会提示"找不到命令"。别慌，这是因为全局安装的路径不在系统 PATH 里。

解决办法：

先看看你的 Node 全局包装在哪儿：

npm prefix -g

大概率会显示类似 /usr/local 或 /Users/你的用户名/.npm-global 这样的路径。

然后把它加到你的 shell 配置文件里：

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

如果你用的是 zsh（macOS 默认），这行加到 ~/.zshrc 如果你用的是 bash，这行加到 ~/.bashrc 或 ~/.bash_profile

加完后关掉终端重新打开，或者运行 source ~/.zshrc，openclaw 命令就能用了。

2.4 安装方式三：brew install

适合：macOS 用户，已经装了 Homebrew

如果你用的是 Mac，而且已经装了 Homebrew，那也可以通过 Homebrew 安装：

brew install openclaw

装好后再运行初始化：

openclaw onboard --install-daemon

2.5 运行 openclaw onboard 交互式初始化

无论用哪种方式安装，安装后都需要运行初始化向导。

如果你用的是安装脚本方式，这一步会自动启动。如果没自动启动，或者你用其他方式装的，手动运行：

openclaw onboard

初始化向导会问你以下几个问题：

① 选择 AI 模型提供商

你会看到类似这样的问题：

? Which provider do you want to use? (Use arrow keys)
❯ Anthropic (Claude)
  OpenAI (GPT)
  Google (Gemini)
  DeepSeek
  Grok (xAI)
  ……

选择你打算用的 AI 模型。如果你是第一次，推荐：

  • Claude Sonnet（Anthropic）：目前最聪明、最稳定的选择之一
  • GPT-4o（OpenAI）：功能全面
  • DeepSeek V3：性价比高，中文支持好

📌 看不懂英文？就用 DeepSeek 或 智谱（GLM），国内可用，中文支持好。

② 输入 API Key

向导会让你输入 API Key。这个 Key 相当于你使用 AI 模型的"门票"，需要去对应的 AI 官网申请。

什么是 API Key？ 你可以把它理解成"使用凭证"。AI 公司按使用量收费，API Key 就是用来记账的。 去注册：

  • Anthropic（Claude）：console.anthropic.com
  • OpenAI（GPT）：platform.openai.com
  • DeepSeek：platform.deepseek.com
  • 智谱（GLM）：open.bigmodel.cn

不用担心：向导全程不会把你的 Key 上传到任何地方，只存在你自己的电脑上。

③ 绑定默认聊天通道

向导会问你要不要配置聊天通道。如果你暂时不想连 Telegram、微信这些，直接选「跳过」，以后随时可以配。

2.6 安装 Gateway 守护进程

初始化过程中，你还会看到这样的提示：

? Install as a background service? (Y/n)

选 Y（推荐）。

这会安装一个「守护进程」——就是让 OpenClaw 在你关机重启后自动再运行，不需要你每次手动启动。

也可以加 --install-daemon 参数一步到位：

openclaw onboard --install-daemon

各系统的守护方式：

  • macOS：使用 LaunchAgent，重启自动运行，在菜单栏显示图标
  • Linux / WSL2：使用 systemd 用户服务
  • Windows：使用计划任务（Scheduled Task）

2.7 验证安装成功

装完了，怎么知道有没有装好？

第一步：查看版本号

openclaw --version

如果能看到版本号（比如 1.xx.x），说明 CLI 客户端装好了。

第二步：检查 Gateway 状态

openclaw gateway status

如果显示类似下面的信息，说明网关正在运行：

Gateway is running
  PID: 12345
  Port: 18789
  Uptime: 2 minutes

第三步：运行诊断检查

openclaw doctor

这个命令会全面检查你的环境，发现常见的配置问题。

完整的安装验证流程

# 1. 查看版本
openclaw --version

# 2. 查看状态
openclaw gateway status

# 3. 诊断检查
openclaw doctor

人工检查：不要只看“安装成功”

在继续前，自己完成三项确认：

  1. openclaw --version、状态检查和诊断命令均无阻塞报错；
  2. 只在测试目录里完成第一次操作，未意外授予敏感目录、外部消息渠道或长期运行权限；
  3. 已在官方页面确认当前模型调用、插件或托管服务可能产生的费用。

命令名称、输出和初始化选项会随版本变化；遇到差异时以当前官方文档为准，而不是照抄旧截图或旧输出。

常见问题

Q：安装时说「command not found」

可能是 Node.js 没装好，或者 PATH 没配置好。试一下：

node --version   # 看 Node 装好了没
npm prefix -g    # 看全局包位置

如果 node --version 也报错，说明 Node.js 没装。用安装脚本会自动帮你装。

Q：Gateway 启动失败

运行 openclaw doctor 查看具体问题，常见原因：

  • 端口 18789 被占用 → 换个端口
  • 配置有问题 → 看第 4 章
  • Node 版本太低 → 升级到 Node 24

Q：我想卸载

想卸载的话很简单：

openclaw uninstall

这会移除 OpenClaw 和相关文件。

本章小结

  • ✅ 装 OpenClaw 只需要 5 分钟
  • ✅ 推荐用安装脚本 curl -fsSL https://openclaw.ai/install.sh | bash
  • ✅ 全程有交互式向导引导，填个 API Key 就行
  • ✅ 验证安装：openclaw --version + openclaw gateway status
  • ✅ 安装守护进程后，电脑重启也能自动运行

下一步

装好后，继续阅读 第 3 章：第一次聊天，先在测试会话中完成一次低风险操作。完成会话整理后，可用 AI 整理会议纪要 把录音转写或笔记变成待核对的行动清单。

← 第 1 章 · OpenClaw 是什么 第 3 章 · 第一次聊天 →

系统教程，帮你把工具用好，再回到任务中。 浏览任务方案 →