官方教程中文版
OpenClaw 官方教程中文版
基于 OpenClaw 官方文档重写的中文教程：安装、Gateway、配置、workspace 和后续开发文档。
📖 本篇术语速查表
| 英文 / 缩写 | 中文 | 一句话解释 |
|---|---|---|
| 官方教程 | official | 讲 OpenClaw 具体功能配置。 |
| 按问题查 | problem-first | 从问题反查章节。 |
| 事实基准 | baseline | 配置以官方为准。 |
不想读完？把下面这段提示词丢给 AI 帮你跑完——帮你按要解决的问题定位该读 OpenClaw 官方教程哪一章。
你是 OpenClaw 官方教程导航顾问。
【角色】
OpenClaw 官方教程导航顾问，按最小够用、安全优先的原则给可落地方案，每条结论都落到能照做的具体步骤或示例，不停留在「建议」「考虑一下」这类空泛表述。
【输入】
- 要解决的具体问题：___
- 用的场景：___
- 经验水平：___
- 紧迫程度：___
- 现状：___
【工作流程】
1. 把问题归类（入门 / 网关运行时）
2. 定位对应章节
3. 给阅读顺序
4. 标出需核验的
5. 给落地下一步
【输出规范】
▌一、问题归类
▌二、对应章节
▌三、阅读顺序
▌四、需核验内容
【硬约束】
- 按问题精准定位不通读
- 易变信息以官方为准
- 贴合经验水平
- 不要替我臆测情况或编造不存在的功能，信息不全先问清
- 不确定的配置或接口一律以官方文档为准，禁止照搬过时写法这里按 OpenClaw 官方文档重写中文教程。事实来自 docs.openclaw.ai、官方配置参考和本地一线运行记录；表达、结构和学习路径面向中文开发者重新组织。
从原理到实战负责解释为什么这样设计；官方教程中文版负责告诉你怎么安装、配置、验证和排障。读完这一组，你应该能把 OpenClaw 从本机安装推进到 Gateway 常驻、Agent 可用、Channel 可控、自动化边界清楚的状态。
这一组解决操作闭环：先把安装、配置、Gateway、Agent、Channel 和自动化跑稳；如果你想理解这些设计为什么成立，再去读“从原理到实战”。
学习地图
flowchart TD
Start[入门与安装] --> Runtime[Gateway 运行时]
Runtime --> Channels[渠道专项]
Runtime --> CLI[CLI reference]
Runtime --> Plugins[插件与节点]入门与安装
系统要求、安装、onboarding、Dashboard、配置结构和 workspace。
Gateway 运行时
Gateway 架构、配置、Agent、Channel、安全远程访问和自动化。
目前覆盖
| 小节 | 解决的问题 | 读完能做什么 |
|---|---|---|
| 入门与安装 | 从零装好 OpenClaw | 安装 CLI、跑 onboarding、打开 Dashboard、定位配置和 workspace |
| Gateway 运行时 | 理解常驻控制面 | 配 Gateway、Agent、Channel、安全远程访问和自动化 |
入门与安装包含：
- 安装前检查：Node 版本、官方脚本、替代安装路径、验证命令。
- 快速上手：onboarding、Gateway status、Dashboard、第一条消息。
- 配置结构：
~/.openclaw/openclaw.json、schema 校验、热加载、环境变量、include。 - Agent Workspace：标准文件、记忆边界、私有备份、不能提交的运行时内容。
Gateway 运行时包含：
- Gateway 架构：长驻进程、WebSocket 控制面、nodes、pairing、远程访问和运行不变量。
- Gateway 配置：严格 schema、热加载、重启边界、Config RPC、health 和 doctor。
- Agent 配置：workspace、repoRoot、skills、bootstrap、模型目录、session 和多 Agent 路由。
- Channel 配置：DM policy、group policy、allowlist、mention gating、多账号和模型覆盖。
- 安全与远程访问：个人助手信任模型、security audit、Control UI、Tailscale 和 SSH tunnel。
- 自动化：cron、tasks、Task Flow、standing orders、hooks 和 heartbeat。
阅读顺序
第一次读按顺序走，不要跳到 Channel 或自动化：
- 先完成入门与安装，确认
openclaw --version、openclaw status、Dashboard 都能跑。 - 再读 Gateway 架构，理解 Gateway 是常驻控制面，不是一次性 CLI。
- 接着配置 Gateway、Agent 和 workspace，把运行时边界固定下来。
- 然后配置 Channel，把“谁能叫醒谁、在哪个会话里说话”讲清楚。
- 最后看安全远程访问和自动化，避免把公网入口、cron、heartbeat 提前打开。
如果你已经有可运行环境，可以从 Gateway 运行时开始，但仍建议回头核对配置结构和 workspace 边界。
不要把高级功能当前置任务：Channel、远程访问、cron、hooks 和 shared Agent 都依赖前面的安装、配置、workspace 与安全边界。
下一批专项
- 渠道专项：Telegram、Discord、Slack、Feishu、WhatsApp 等逐渠道接入页。
- CLI reference：gateway、config、cron、tasks、hooks、security 等命令详表。
- 插件与节点：插件系统、nodes、media、Canvas、A2UI 的专项教程。
验收标准
这一阶段不追求把每个 provider 都接完。先达到这几个状态：
- 本机能启动 Gateway，并能通过
openclaw status看见健康状态。 - 你知道主配置、Agent workspace、运行时 state 分别放在哪里。
- 你能解释 Gateway、Agent、Channel、Session、Task 的关系。
- 你能判断 cron、heartbeat、hooks、Task Flow、standing orders 各自该用在什么场景。
- 你知道哪些文件可以进 git，哪些运行时文件、凭据和 channel token 不能进 git。
验收方式很简单：每读完一章，都回到本机跑一次对应命令或检查一次对应文件；不能验证的理解，后面接渠道时会变成排障成本。
官方来源
- 官方文档索引：https://docs.openclaw.ai/llms.txt
- 安装：https://docs.openclaw.ai/install
- 快速开始：https://docs.openclaw.ai/start/getting-started
- 配置：https://docs.openclaw.ai/gateway/configuration
- Gateway 架构：https://docs.openclaw.ai/concepts/architecture
- 安全：https://docs.openclaw.ai/gateway/security
- 自动化：https://docs.openclaw.ai/automation