OpenClaw 中文文档 — 快速上手

5 分钟，从零到第一次 AI 对话。不多说，直接上手。

前置：Node.js

node --version
# 需要 v24.x（推荐）或 v22.16+

没装？用 fnm 一步到位：

curl -fsSL https://fnm.vercel.app/install | bash
fnm install 24 && fnm use 24

安装

# macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash

# Windows（PowerShell）
# iwr -useb https://openclaw.ai/install.ps1 | iex

验证：

openclaw --version

看到版本号就对了。Windows 用户建议走 WSL2，原生环境坑比较多。

Onboarding 向导

这步是核心——一个命令搞定认证、Gateway、渠道配置：

openclaw onboard --install-daemon

向导会让你选 QuickStart 或 Advanced。第一次直接 QuickStart，默认配置够用：

• 本地 Gateway，端口 18789
• 自动生成 Token 认证
• DM 会话按渠道+对端隔离

向导依次走完这几步：

1. 模型认证 — 选供应商（Anthropic/OpenAI 等），填 API Key
2. 工作区 — Agent 文件位置，默认就行
3. Gateway — 端口和认证
4. 渠道 — 一些社交软件，也可以先跳过
5. 守护进程 — 注册系统服务，开机自启
6. 健康检查 — 自动验证 Gateway
7. Skills — 装推荐技能

这个设计我觉得挺巧妙的：把所有初始化步骤串成一个流程，不用手动编辑配置文件。而且向导里还有个网页搜索配置，可以选 Perplexity 或 Brave 当搜索引擎，让 Agent 能联网查资料。

验证

# 检查 Gateway 状态
openclaw gateway status

# 打开 Control UI
openclaw dashboard

浏览器打开 http://127.0.0.1:18789/，看到界面就成了。

先看效果——直接在 Control UI 的输入框里打字，AI 就会回你。不需要先配那些社交软件，Control UI 本身就是一个聊天入口。

命令行发消息

如果你配了渠道，也可以从终端直接发：

openclaw message send --target +15555550123 --message "Hello from OpenClaw"

跑通后你有什么

• 一个后台运行的 Gateway
• 已配置的模型认证
• Control UI 聊天入口
• 可选的消息渠道连接

补充：环境变量

一般不用改，列一下留个印象：

• OPENCLAW_HOME — 主目录
• OPENCLAW_STATE_DIR — 状态目录
• OPENCLAW_CONFIG_PATH — 配置文件路径

重新配置

跑过向导之后想改配置？不用重跑整个向导：

openclaw configure           # 重新配置
openclaw agents add <name>   # 添加新 Agent

向导重跑也没问题，不会清除已有配置，除非你主动选 Reset。

下一篇

安装方式全解——CLI 脚本、Docker、Podman、Nix、Ansible 的对比和选择。

完整中文文档：OpenClaw 中文文档

GitHub 仓库：openclaw/openclaw

---

OpenClaw 中文文档系列第二篇，后面会一篇篇写完。觉得有用点个赞，有问题评论区聊。