Skip to content

广告 · 本站推荐

腾讯云特惠活动 · 云服务器、数据库、CDN 新用户专享折扣

快速开始

这篇先不讲复杂原理。你只要记住一句话:

OpenClaw 是一个运行在你自己电脑上的 AI 助手。它有一个常驻的 Gateway 网关,负责接收消息、调用 AI、再把回复送回去。

第一次使用,按下面 5 步走就够了。

如果你完全没有技术背景

先把这篇当成“照着做清单”。 看不懂某个词时不要停,先继续复制命令。只要最后能打开浏览器控制 UI,并让 AI 回复一句话,就算成功。


先准备这 3 样东西

  1. 一台电脑 macOS、Linux、Windows 都可以。Windows 可以直接用,但完整体验更推荐 WSL2。

  2. Node.js 推荐 Node 24。如果你已经是 Node 22.14+,也可以继续用。

  3. 一个 AI 模型账号或 API key 新手可以先用你已经有账号的提供商。OpenClaw 支持 OpenAI、Anthropic、Google、Ollama、本地或兼容 OpenAI API 的服务。

API key 可以先理解成“AI 服务的门钥匙”。OpenClaw 需要拿着这把钥匙,才能替你去问模型。

检查 Node 版本:

bash
node --version

如果显示 v24.x.x,很好。 如果显示 v22.14.0 或更高,也可以。 如果提示找不到 node,先看安装 Node.js


第一步:安装 OpenClaw

macOS / Linux / WSL2

打开终端,复制这一行:

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

Windows PowerShell

打开 PowerShell,复制这一行:

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

如果你更喜欢 npm,也可以这样装:

bash
npm install -g openclaw@latest

第二步:运行新手向导

安装完后,运行:

bash
openclaw onboard --install-daemon

这一步会帮你做 4 件事:

  1. 选择 AI 模型提供商。
  2. 保存 API key 或登录信息。
  3. 配置 Gateway 网关。
  4. 把 Gateway 安装成后台服务,让它开机后也能一直运行。

你可以把它理解成“第一次开机设置”。跟着提示填就行,不需要提前懂所有选项。

如果向导问到你不确定的内容,优先选默认值。默认值通常是给大多数人准备的安全路线。


第三步:确认 Gateway 正在运行

Gateway 是 OpenClaw 的“总服务台”。 它不运行,就像服务台没人值班,聊天软件、网页控制台、手机节点都会找不到 AI。

运行:

bash
openclaw gateway status

如果看到正在监听 18789 端口,说明 Gateway 已经起来了。

如果不确定哪里出问题,先跑:

bash
openclaw doctor

doctor 就像体检,会检查配置、服务、权限和常见风险。


第四步:打开控制 UI

控制 UI 是浏览器里的管理界面。新手建议先在这里试第一句,不要一上来就接 Telegram 或 WhatsApp。

运行:

bash
openclaw dashboard

正常情况下,浏览器会打开:

text
http://127.0.0.1:18789/

看到聊天界面后,输入一句:

text
你好,帮我用一句话介绍 OpenClaw。

如果 AI 回复了,恭喜,你已经跑通最小闭环了。

这个闭环的意思是:

text
你在浏览器发消息 → OpenClaw 找 AI → AI 回复 → 浏览器看到答案

后面所有 Telegram、WhatsApp、手机节点,都是在这个基础上继续加东西。


第五步:再连接聊天软件

控制 UI 能聊通之后,再接聊天软件会简单很多。

推荐顺序:

  1. Telegram 最适合新手,只需要 Bot Token。

  2. Discord 适合服务器和社区场景。

  3. WhatsApp 适合日常手机聊天,但配置比 Telegram 多一步扫码。

更多选择看通道总览


最容易混淆的 4 个词

名词人话解释
Gateway 网关OpenClaw 的总服务台,负责接消息、管连接、发回复
Control UI浏览器里的控制面板,用来聊天、看配置、看会话
Channel 通道Telegram、WhatsApp、Discord 这些聊天入口
Node 节点手机、Mac、远程机器等“可被 Gateway 指挥的设备”

不用一次学完

第一次使用只需要记住 Gateway 和 Control UI。 Channel、Provider、Node 这些词,等你真的接聊天软件、换模型、连手机时再看。


下一步读什么

用工程视角拆解 AI 智能体框架