OpenClaw 快速上手（二）：10 分钟装好并完成第一次对话

README 写的是 5 分钟。我标 10 分钟——多出来的 5 分钟是给"几乎每个人第一次都会犯的 Node 版本错误"准备的。

前置条件

• Node v22.16 或更高。这个要求是认真的。低版本能装但 Gateway 在某些可选链处直接抛异常。我用的是 v24，因为这是官方推荐线。
• 运行时大约 2 GB 空闲内存，加载大型 Skills 时更多。
• 一个 LLM API Key，候选：DashScope（免费档够用）、Anthropic、OpenAI、阿里云百炼 Coding Plan（200 元/月，8 个模型）。

先看 Node：

1
2
3

node -v
# v24.0.x —— 可以
# v20.x.x —— 太老，走下面

如果版本太旧，装 nvm：

1
2
3
4

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc
nvm install 24
nvm use 24

这就是唯一的坑。后面顺。

装 OpenClaw

两种方式：npm 全局，或者 curl-bash。我喜欢 npm，因为我想知道二进制装哪儿了：

1
2
3

npm install -g @anthropic-ai/openclaw@latest
openclaw --version
# 2026.3.13

（是的，npm scope 是 @anthropic-ai。背后是一段商标变更的历史，结果就是这个名字，没有别的影响。）

引导

跑一次引导向导，它会把配置写到 ~/.openclaw/：

1

openclaw onboard

它会问：

1. Agent 叫什么名字——我会取个好记的，方便在聊天里点名骂它。我的叫 Lobster。
2. 它该叫你什么——我用我真实的 handle，而不是 “Boss”。看日志方便。
3. 用哪个 Provider——你有哪个 Key 就选哪个。这条流程我用 DashScope，因为它有免费档。
4. API Key。
5. 默认模型——通用场景下 qwen-plus 是对的默认。

向导写到 ~/.openclaw/openclaw.json，之后可以手改。

启动 Gateway

1

openclaw gateway start

应该看到类似：

[gateway] listening on http://127.0.0.1:18789
[agent] loaded skills: 17
[memory] index ready (0 entries)
[channels] none configured (yet)

Gateway 是长跑进程。后续几篇会逐步往它身上接渠道、接技能。现在它在那里，没有输入。

TUI：在终端里跟它聊

开第二个终端：

1

openclaw tui

得到一个聊天界面。按顺序试三件事：

你好，用一句话介绍你自己。

读一下 ~/.zshrc，告诉我里面有哪些 alias。

在桌面建一个目录 openclaw-test，里面新建文件 notes.md，
内容写 "first run"。

应该发生三件事：

1. 第一条返回一句话——模型在说话。
2. 第二条触发 read 工具——Agent 让 Gateway 读文件，Gateway 日志里会滚一行 tool-call。
3. 第三条真的改了你的文件系统。ls ~/openclaw-test/ 验证。

三件全过，安装结束。如果只第一件过，说明 Agent 没在调用工具——多半是模型太小撑不住 tool-calling，换 qwen-plus 或 qwen3-max 再来。

Web 控制面板（可选，但有用）

也有 Web UI：

1
2

openclaw web start
# 打开 http://127.0.0.1:18790

我大多数时候不开——TUI 更快——但可视化看记忆和技能状态时它有用，配置好 cron 之后也可以在这里看任务列表。

刚才在架构上发生了什么

你的终端 --(stdin)--> openclaw tui
                            |
                            v
                     openclaw gateway   :18789
                            |
            +---------------+-------------------+
            |               |                   |
            v               v                   v
        Agent 循环      Skills 索引       Tool 注册表
            |
            v
     LLM Provider（DashScope, Anthropic, ...）

tui 只是一个轻客户端。Agent 循环住在 Gateway 里。这层分离正是为什么后面你可以再接 Telegram、钉钉或 Web UI 当替代前端，全都通向同一个 Agent。

下一篇打开 Gateway，看你按下回车的时候里面到底在发生什么。