入门与安装
OpenClaw 入门与安装学习地图：先安装和 onboarding，再验证 Gateway、理解配置结构，最后整理 Agent Workspace。
这一组只解决一件事：让 OpenClaw 在你的机器上稳定跑起来，并且知道每个关键文件、命令和页面分别管什么。不要一上来就接很多渠道、写复杂 Agent 或开放远程访问；先把最小闭环跑通。
适合从这里开始的人：第一次安装 OpenClaw、换机器重装、openclaw 命令找不到、Gateway 状态不清楚、openclaw.json 不敢改，或者 workspace 和 ~/.openclaw/ 经常混在一起。
1. 这一组包含什么
入门与安装一共 4 章：
- 安装 OpenClaw：按系统选择官方脚本、包管理器、本地 prefix 或源码安装，并完成版本、doctor 和 Gateway 验证。
- 快速上手 OpenClaw：用 onboarding 跑通模型认证、Gateway、Dashboard 和第一条消息。
- 理解配置结构：分清
openclaw.json、JSON5、strict schema、热加载、环境变量和密钥边界。 - 配置 Agent Workspace：理解 Agent（智能代理）的长期工作现场，以及哪些内容不能放进 workspace git。
flowchart TD
Install["安装 OpenClaw"]
Onboard["跑 onboarding"]
Gateway["验证 Gateway"]
Config["理解配置结构"]
Workspace["整理 Agent Workspace"]
Runtime["进入 Gateway 运行时"]
Install --> Onboard
Onboard --> Gateway
Gateway --> Config
Config --> Workspace
Workspace --> Runtime
style Install fill:#e0f2fe,stroke:#0284c7,stroke-width:2px
style Gateway fill:#dcfce7,stroke:#22c55e,stroke-width:2px
style Config fill:#fef3c7,stroke:#f59e0b,stroke-width:2px
style Runtime fill:#ede9fe,stroke:#8b5cf6,stroke-width:2px2. 章节入口
安装 OpenClaw
系统要求、安装脚本、Node 版本、替代安装路径和安装后验证。
快速上手 OpenClaw
从 onboarding 到 Gateway、Dashboard、第一条消息和下一步渠道选择。
理解配置结构
openclaw.json、JSON5、strict schema、热加载、环境变量和排障顺序。
配置 Agent Workspace
workspace 文件地图、长期记忆、私有备份、sandbox 和迁移边界。
3. 推荐阅读顺序
新手按这个顺序读：
- 先读“安装 OpenClaw”，按你的系统选择一个安装通道，不要混装。
- 再读“快速上手 OpenClaw”，完成 onboarding，并确认 Gateway 正在监听。
- 然后读“理解配置结构”，知道什么能用 CLI / Control UI 改，什么必须谨慎编辑。
- 最后读“配置 Agent Workspace”，把身份、规则、用户信息、工具说明和长期记忆分清。
如果你已经装好了，可以按问题跳：
openclaw命令不存在：看安装章节的 PATH 和 Node 全局包路径排查。- Gateway 没有启动：看快速开始里的
gateway status、doctor、logs、health。 - 不知道配置字段怎么改：看配置结构里的 schema、热加载和排障顺序。
- 想把 workspace 放进 git：先看 Workspace 章节里的“不能提交什么”。
跳读也要先定位问题层：命令找不到是安装层；Gateway 不回是运行层；配置不生效是 schema / reload 层；身份和记忆混乱才是 workspace 层。
4. 先不要做什么
入门阶段先不要急着做这些：
- 直接把 Gateway 暴露到公网。
- 把
dmPolicy设成open后不加访问控制。 - 把
~/.openclaw/整目录提交到 git。 - 复制陌生人的完整
openclaw.json。 - 同时接 Telegram、Discord、Slack、WhatsApp 等多个渠道。
- 先写 cron、hooks、standing orders，再回头排 Gateway 基础问题。
先跑通最小闭环：能安装、能 onboarding、能看到 Gateway、能在 Dashboard 发第一条消息，才进入 Gateway 运行时和渠道配置。
入门阶段不要扩大暴露面：Channel、远程访问和自动化都会放大基础配置问题；最小闭环没过，先不要接外部入口。
5. 完成后的验收标准
读完这一组，你应该能做到：
- 能解释 OpenClaw 为什么需要一个长期运行的 Gateway。
- 能在自己的系统上安装并验证
openclaw --version。 - 能运行
openclaw doctor、openclaw gateway status和openclaw dashboard。 - 能说清
~/.openclaw/openclaw.json是配置文件，不是 workspace 内容。 - 能判断一个配置改动是否可能热加载，还是需要重启 Gateway。
- 能整理 workspace 标准文件，并避免把 token、OAuth、session 和 auth profiles 放进 git。
- 能进入下一组 Gateway 运行时，而不是继续在安装问题里反复打转。
这一组的结束状态：不是“看完四篇”，而是你能在本机复现安装、诊断、启动、打开 Dashboard 和确认 workspace 边界。