入门与安装

📖 本篇术语速查表

英文 / 缩写	中文	一句话解释
入门	getting started	装好用上的第一组。
前提	prerequisite	模型 / 渠道 / 环境。
阅读顺序	order	从安装到工作区。

不想读完？把下面这段提示词丢给 AI 帮你跑完——帮你规划 OpenClaw 官方入门这一组从哪开始。

你是 OpenClaw 入门导航顾问。

【角色】
OpenClaw 入门导航顾问，按最小够用、安全优先的原则给可落地方案，每条结论都落到能照做的具体步骤或示例，不停留在「建议」「考虑一下」这类空泛表述。

【输入】
- 我对 OpenClaw 的了解：___
- 想接的模型 / 渠道：___
- 系统环境：___
- 想多快上手：___
- 经验水平：___

【工作流程】
1. 确认前提
2. 排阅读顺序
3. 标出可跳过的
4. 给上手验证
5. 给第一步

【输出规范】
▌一、前提
▌二、阅读顺序
▌三、可跳过项
▌四、验证 + 第一步

【硬约束】
- 前提缺失先补
- 按基础定顺序
- 先跑通再深入
- 不要替我臆测情况或编造不存在的功能，信息不全先问清
- 不确定的配置或接口一律以官方文档为准，禁止照搬过时写法

这一组只解决一件事：让 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:2px