OpenClaw 设置清单
一份逐步检查清单，帮你确认 OpenClaw 安装无误、Gateway 运行正常、第一个渠道闭环已打通。
2026/03/12
OpenClaw 设置清单
这个页面的作用，是在"我已经装完了"和"我知道一切正常"之间搭一座桥。
请在看完安装指南之后使用这个清单。在所有项目都确认通过之前，不要急着去做 workflow 或平台接入。
阶段一：环境基线确认
在碰 OpenClaw 之前，先确认你的机器本身没问题：
- Node.js 22 或更新版本已安装（
node -v） -
pnpm可用（pnpm -v） - 你的终端支持交互式会话
- 你的网络能正常访问你计划使用的模型提供商 API
- Docker 仅在你确实需要容器工作流时才安装
如果有任何一项不通过，先修它。OpenClaw 安装流程不会帮你修好环境本身。
阶段二：OpenClaw 安装已确认
确认安装本身已经完成：
- OpenClaw CLI 或 app 已安装
- 运行
openclaw --version或打开 app 能看到有效版本号 - 你选定了一条安装路线（app-first 或 source-first）并且没有混用
阶段三：workspace 和 config 已生成
workspace 是 OpenClaw 存放所有本地配置和数据的地方：
- setup 跑完后生成了 workspace 目录
- workspace 中存在配置文件
- 配置文件中包含你的模型提供商凭证
- setup 过程中没有出现明显错误（认证失败、权限问题、文件缺失）
workspace 通常在：
- 默认位置：
~/.openclaw/ - 配置文件：
openclaw.json或等效文件 - workspace 数据：
~/.openclaw/下的工作空间目录
如果 workspace 不存在，请从安装指南重新跑 setup 流程。
阶段四：Gateway 正在运行
Gateway 是让 OpenClaw 真正工作的进程。没有它，什么都不行：
- Gateway 启动成功，没有崩溃
- 终端显示 Gateway 正在运行（或 app 报告 "Gateway: active"）
- 启动日志中没有端口冲突或权限错误
怎么确认：
- app-first 用户：app 仪表板通常会显示 Gateway 状态
- source-first 用户：运行
openclaw gateway status或查看终端输出
Gateway 启动不了最常见的原因：
- 端口已被占用
- 配置缺失或无效
- Node.js 版本不对
阶段五：第一个 channel 已连接
选一个 channel 连上去。不要在这个阶段连多个渠道：
- 你选了一个 channel 作为起点（Discord、Telegram 等）
- 渠道凭证已添加到配置中
- OpenClaw 报告该 channel 已连接
- 没有出现认证或权限错误
好的第一个 channel 选择：
- Discord：容易搭建，容易验证，可视化好
- Telegram：Bot API 简单，快速确认
- CLI/test channel：摩擦最小，适合只想验证闭环的情况
第一次设置不要尝试微信、飞书或其他复杂渠道。
阶段六：第一条真实消息闭环
这是唯一真正重要的测试。如果这个能通，其他都是次要的：
- 你通过 channel 给助手发送了一条真实消息
- 助手收到了消息
- 助手生成了回复
- 回复出现在了 channel 中
如果这个闭环能通，你的安装就没问题。如果不能：
- 查看 Gateway 日志找错误
- 确认 channel 凭证正确
- 确认模型提供商 API key 有效且有额度
- 确认消息确实到达了 OpenClaw（而不是只是留在 channel 里）
阶段七：health check 通过
如果你的版本支持，跑一次 health check：
-
openclaw doctor或等效的健康检查命令能运行 - 没有报告严重问题
- 模型提供商连通性已确认
- channel 连通性已确认
如果 health check 报告了一些警告但消息闭环能通，警告可以先放着。只修关键问题。
全部通过后该做什么
你的安装已经完成了。按这个顺序继续：
- OpenClaw Discord Guide —— 搭建一个生产级渠道和真实用例
- OpenClaw Heartbeat Guide —— 加一个周期性检查，确保坏了你能知道
- OpenClaw Use Cases —— 选一个 workflow 模板开始搭建
在你有了一个健康的 channel 和至少一个 heartbeat 之前，不要急着去看场景页或 skill。
如果有地方没通过
回到安装指南查看"最常见的失败点"部分。
最常见的问题：
- Node.js 版本不对
- Gateway 实际没在运行
- channel 连上了但没有回复（通常是 provider 或配置问题）
- app-first 和 source-first 安装步骤混用
更多资料，请看 OpenClaw 资源列表。