快速开始
这篇先不讲复杂原理。你只要记住一句话:
OpenClaw 是一个运行在你自己电脑上的 AI 助手。它有一个常驻的 Gateway 网关,负责接收消息、调用 AI、再把回复送回去。
第一次使用,按下面 5 步走就够了。
如果你完全没有技术背景
先把这篇当成“照着做清单”。 看不懂某个词时不要停,先继续复制命令。只要最后能打开浏览器控制 UI,并让 AI 回复一句话,就算成功。
先准备这 3 样东西
一台电脑 macOS、Linux、Windows 都可以。Windows 可以直接用,但完整体验更推荐 WSL2。
Node.js 推荐 Node 24。如果你已经是 Node 22.14+,也可以继续用。
一个 AI 模型账号或 API key 新手可以先用你已经有账号的提供商。OpenClaw 支持 OpenAI、Anthropic、Google、Ollama、本地或兼容 OpenAI API 的服务。
API key 可以先理解成“AI 服务的门钥匙”。OpenClaw 需要拿着这把钥匙,才能替你去问模型。
检查 Node 版本:
node --version如果显示 v24.x.x,很好。 如果显示 v22.14.0 或更高,也可以。 如果提示找不到 node,先看安装 Node.js。
第一步:安装 OpenClaw
macOS / Linux / WSL2
打开终端,复制这一行:
curl -fsSL https://openclaw.ai/install.sh | bashWindows PowerShell
打开 PowerShell,复制这一行:
iwr -useb https://openclaw.ai/install.ps1 | iex如果你更喜欢 npm,也可以这样装:
npm install -g openclaw@latest第二步:运行新手向导
安装完后,运行:
openclaw onboard --install-daemon这一步会帮你做 4 件事:
- 选择 AI 模型提供商。
- 保存 API key 或登录信息。
- 配置 Gateway 网关。
- 把 Gateway 安装成后台服务,让它开机后也能一直运行。
你可以把它理解成“第一次开机设置”。跟着提示填就行,不需要提前懂所有选项。
如果向导问到你不确定的内容,优先选默认值。默认值通常是给大多数人准备的安全路线。
第三步:确认 Gateway 正在运行
Gateway 是 OpenClaw 的“总服务台”。 它不运行,就像服务台没人值班,聊天软件、网页控制台、手机节点都会找不到 AI。
运行:
openclaw gateway status如果看到正在监听 18789 端口,说明 Gateway 已经起来了。
如果不确定哪里出问题,先跑:
openclaw doctordoctor 就像体检,会检查配置、服务、权限和常见风险。
第四步:打开控制 UI
控制 UI 是浏览器里的管理界面。新手建议先在这里试第一句,不要一上来就接 Telegram 或 WhatsApp。
运行:
openclaw dashboard正常情况下,浏览器会打开:
http://127.0.0.1:18789/看到聊天界面后,输入一句:
你好,帮我用一句话介绍 OpenClaw。如果 AI 回复了,恭喜,你已经跑通最小闭环了。
这个闭环的意思是:
你在浏览器发消息 → OpenClaw 找 AI → AI 回复 → 浏览器看到答案后面所有 Telegram、WhatsApp、手机节点,都是在这个基础上继续加东西。
第五步:再连接聊天软件
控制 UI 能聊通之后,再接聊天软件会简单很多。
推荐顺序:
更多选择看通道总览。
最容易混淆的 4 个词
| 名词 | 人话解释 |
|---|---|
| Gateway 网关 | OpenClaw 的总服务台,负责接消息、管连接、发回复 |
| Control UI | 浏览器里的控制面板,用来聊天、看配置、看会话 |
| Channel 通道 | Telegram、WhatsApp、Discord 这些聊天入口 |
| Node 节点 | 手机、Mac、远程机器等“可被 Gateway 指挥的设备” |
不用一次学完
第一次使用只需要记住 Gateway 和 Control UI。 Channel、Provider、Node 这些词,等你真的接聊天软件、换模型、连手机时再看。
下一步读什么
- 想先稳稳装好:看安装 OpenClaw。
- 想知道系统怎么工作:看OpenClaw 是怎么工作的。
- 想从浏览器管理:看Web 控制 UI。
- 想连接手机或远程机器:看节点入门。
