OpenClaw系列第2课：OpenClaw 快速安装与首次启动

这是「OpenClaw 教程课程」第 2 课。
第 1 课我们解决了“OpenClaw 是什么”，这一课只做一件事：把它真正跑起来。

很多人看完介绍之后，第一反应都差不多：

  • 这东西听起来很强
  • 但到底怎么装？
  • 装完之后我怎么知道它真的活了？
  • 如果没跑起来，我该先查哪里？

所以第 2 课不讲复杂原理，只讲最关键的入门路径：

从零安装 OpenClaw，并完成第一次可用对话。

一、这节课学完，你会得到什么？

如果这篇文章跟着做完，正常情况下你会得到这几个结果：

  • 一套已经安装好的 OpenClaw
  • 一个已经完成初始化的 Gateway
  • 一个可正常打开的 Web 控制面板
  • 你的第一次可用聊天

也就是说，这一课结束之后，你不再停留在“知道它是什么”，而是已经进入“它可以开始工作”的状态。

二、开始前，你需要准备什么？

OpenClaw 的安装门槛不算高，但有两个前提要先确认。

1）Node.js 版本

根据当前文档：

  • 推荐版本：Node 24
  • 可支持版本：Node 22.14+

先在终端执行：

1
node --version

如果你的版本太旧，后面很可能出现各种奇怪问题。

2）一个模型提供商的 API Key

OpenClaw 本身是网关和运行框架，真正生成内容时，仍然要连接模型提供商。

常见包括：

  • Anthropic
  • OpenAI
  • Google
  • 其他兼容提供商

你不一定要先手动全配好，因为 onboarding 向导里会一步步提示你填。

三、最快安装方式：直接用官方安装脚本

如果你是第一次装，建议不要一上来折腾太多安装方式。

macOS / Linux

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

Windows（PowerShell）

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

如果你是 Windows 用户，虽然原生 Windows 也支持，但从稳定性和完整体验来说，WSL2 往往更省事。

四、安装完成后，不要急着乱点，先跑 onboarding

安装完之后，最关键的一步不是立刻开聊，而是运行初始化向导：

1
openclaw onboard --install-daemon

这条命令非常重要，因为它会帮你完成几件本来很容易配乱的事情：

  • 选择模型提供商
  • 填写 API Key
  • 配置 Gateway
  • 安装后台服务
  • 做基础初始化

你可以把它理解成：

第一次把 OpenClaw 从“装上了”推进到“能用了”的真正入口。

--install-daemon 是什么意思？

这个参数的作用，可以简单理解成：

顺手把 Gateway 作为后台服务安装好。

这样以后你使用 OpenClaw 时，不需要每次都手工重新把核心服务拉起来。

五、初始化完成后，第一件事是确认 Gateway 还活着

很多新手最容易犯的错误是：

  • 看见安装没报错
  • 就以为系统已经完全正常

其实不一定。

你真正应该马上执行的是：

1
openclaw gateway status

这一步的意义非常大，因为它是在确认：

  • Gateway 有没有启动
  • 端口是不是正常
  • 当前服务是不是可达

你可以把这一步当成：

OpenClaw 安装后的第一次体检。

如果这一步状态不正常，后面你就先别急着怪模型、怪前端、怪渠道。

先把 Gateway 的状态看清楚。

六、最小闭环：打开控制面板

如果 gateway status 看起来正常，下一步就该打开控制面板了。

执行：

1
openclaw dashboard

这会在浏览器里打开 Control UI。

如果一切正常，你应该能进入控制界面，并看到一个可以输入消息的聊天区域。

这一步非常关键，因为它完成了一个真正的最小闭环：

  1. OpenClaw 装好了
  2. Gateway 起好了
  3. Dashboard 打开了
  4. 你可以开始发送第一条消息了

也就是说，到这里你已经不只是“安装成功”，而是已经进入了实际可用状态。

七、第一次可用聊天，优先用 Web 面板验证

很多人一上来就想先接 Telegram、接 Discord。

这当然没问题，但如果你的目标是“先确认系统正常工作”，最稳的办法其实是：

先直接在 Web 控制面板里发第一条消息。

因为这一步排除了很多额外变量：

  • 不需要先配置聊天渠道
  • 不需要先管 bot token
  • 不需要先排查消息平台权限
  • 不需要先考虑群聊规则

所以更推荐的新手顺序是：

  1. 安装 OpenClaw
  2. 跑 onboarding
  3. 检查 gateway status
  4. 打开 dashboard
  5. 在浏览器里完成第一次对话
  6. 再去接 Telegram 或其他渠道

八、如果你想尽快接手机聊天，Telegram 往往是最快路径

当你已经通过 Dashboard 验证过系统正常后，如果你想进一步从手机上用它，Telegram 往往是一个很适合的新手入口。

原因很简单：

  • 配置路径相对清晰
  • 使用门槛低
  • 很适合日常直接互动

但这一课我们不展开 Telegram 细节，因为那是后面的独立课程内容。

这节课的重点只有一个：

先确认你的 OpenClaw 本体已经跑起来。

九、常见误区：安装成功 ≠ 系统可用

这是特别值得单独拎出来说的一点。

很多人会把下面几件事混为一谈：

  • 包安装成功
  • onboarding 跑完了
  • Gateway 正常运行
  • 控制面板可以打开
  • 第一条消息真的能收到回复

其实这 5 件事不是一回事。

真正稳妥的判断顺序应该是：

第一步：安装成功

能正常执行安装命令，没有中断。

第二步：初始化成功

openclaw onboard --install-daemon 正常跑完。

第三步：Gateway 状态正常

1
openclaw gateway status

第四步：Dashboard 能打开

1
openclaw dashboard

第五步：第一条消息有正常回复

只有走完这五步，你才可以比较放心地说：

我的 OpenClaw 已经真的跑起来了。

十、如果哪里不对，先怀疑哪一步？

给你一个很实用的排查优先级：

情况 1：安装命令就报错

先检查：

  • Node.js 版本
  • 系统环境
  • 网络环境

情况 2：onboarding 跑不完

先检查：

  • API Key 是否正确
  • 配置过程中有没有填错
  • 是否有权限写入相关目录

情况 3：Dashboard 打不开

先检查：

1
openclaw gateway status

因为很多时候，问题根本不是前端，而是 Gateway 没起来。

情况 4：界面打开了，但消息不回复

先别急着怪模型。

优先确认：

  • Gateway 是否仍在运行
  • 配置的模型提供商是否正常
  • 当前会话是否已真正完成初始化

十一、这节课最值得记住的最小命令集

如果你今天只想记住 4 条命令，就记这组：

1
2
3
4
node --version
openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboard

这四条命令分别对应：

  • 看环境是不是够格
  • 做首次初始化
  • 看核心服务是不是活着
  • 打开可交互界面

十二、总结

这一课你只要真正记住下面 4 件事，就已经够用了：

  1. OpenClaw 不是装完包就结束了，真正关键的是 onboarding。
  2. Gateway 是核心服务，装完之后一定先看 openclaw gateway status。
  3. 第一次验证系统是否正常，优先用 Dashboard，不要一上来就把问题复杂化。
  4. 只有完成“安装 → 初始化 → 状态检查 → 打开界面 → 收到回复”这个闭环，才算真正跑起来。

下一课预告

下一课我们学：

第 3 课：Gateway 是什么？它怎么工作？

这会帮你真正理解：

  • 为什么 Gateway 是 OpenClaw 的中枢
  • 一条消息是怎么流进系统的
  • 为什么很多排错最后都绕不开 Gateway

🦞 本文由八条撰写，持续更新中。