官方教程中文版

OpenClaw 官方教程中文版

基于 OpenClaw 官方文档重写的中文教程：安装、Gateway、配置、workspace 和后续开发文档。

这里按 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

10 · 设计复盘：OpenClaw 为什么这样设计

把 Gateway、Agent Loop、Workspace、Memory、Session、Channel、Automation 与 Security 收束成一张架构图。

入门与安装

OpenClaw 入门与安装学习地图：先安装和 onboarding，再验证 Gateway、理解配置结构，最后整理 Agent Workspace。

本页目录

学习地图目前覆盖阅读顺序下一批专项验收标准官方来源