---
title: "OpenClaw 官方教程中文版"
description: "基于 OpenClaw 官方文档重写的中文教程：安装、Gateway、配置、workspace 和后续开发文档。"
verifiedAt: "2026-05-05"
---

这里按 OpenClaw 官方文档重写中文教程。事实来自 `docs.openclaw.ai`、官方配置参考和本地一线运行记录；表达、结构和学习路径面向中文开发者重新组织。

从原理到实战负责解释为什么这样设计；官方教程中文版负责告诉你怎么安装、配置、验证和排障。读完这一组，你应该能把 OpenClaw 从本机安装推进到 Gateway 常驻、Agent 可用、Channel 可控、自动化边界清楚的状态。

> [!NOTE]
> **这一组解决操作闭环**：先把安装、配置、Gateway、Agent、Channel 和自动化跑稳；如果你想理解这些设计为什么成立，再去读“从原理到实战”。

## 学习地图

```mermaid
flowchart TD
    Start[入门与安装] --> Runtime[Gateway 运行时]
    Runtime --> Channels[渠道专项]
    Runtime --> CLI[CLI reference]
    Runtime --> Plugins[插件与节点]
```

<Cards>
  <Card title="入门与安装" description="系统要求、安装、onboarding、Dashboard、配置结构和 workspace。" href="/docs/openclaw/official/00-getting-started" />
  <Card title="Gateway 运行时" description="Gateway 架构、配置、Agent、Channel、安全远程访问和自动化。" href="/docs/openclaw/official/01-gateway-runtime" />
</Cards>

## 目前覆盖

| 小节 | 解决的问题 | 读完能做什么 |
| --- | --- | --- |
| 入门与安装 | 从零装好 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 或自动化：

1. 先完成入门与安装，确认 `openclaw --version`、`openclaw status`、Dashboard 都能跑。
2. 再读 Gateway 架构，理解 Gateway 是常驻控制面，不是一次性 CLI。
3. 接着配置 Gateway、Agent 和 workspace，把运行时边界固定下来。
4. 然后配置 Channel，把“谁能叫醒谁、在哪个会话里说话”讲清楚。
5. 最后看安全远程访问和自动化，避免把公网入口、cron、heartbeat 提前打开。

如果你已经有可运行环境，可以从 Gateway 运行时开始，但仍建议回头核对配置结构和 workspace 边界。

> [!IMPORTANT]
> **不要把高级功能当前置任务**：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。

> [!TIP]
> **验收方式很简单**：每读完一章，都回到本机跑一次对应命令或检查一次对应文件；不能验证的理解，后面接渠道时会变成排障成本。

## 官方来源

- 官方文档索引：[https://docs.openclaw.ai/llms.txt](https://docs.openclaw.ai/llms.txt)
- 安装：[https://docs.openclaw.ai/install](https://docs.openclaw.ai/install)
- 快速开始：[https://docs.openclaw.ai/start/getting-started](https://docs.openclaw.ai/start/getting-started)
- 配置：[https://docs.openclaw.ai/gateway/configuration](https://docs.openclaw.ai/gateway/configuration)
- Gateway 架构：[https://docs.openclaw.ai/concepts/architecture](https://docs.openclaw.ai/concepts/architecture)
- 安全：[https://docs.openclaw.ai/gateway/security](https://docs.openclaw.ai/gateway/security)
- 自动化：[https://docs.openclaw.ai/automation](https://docs.openclaw.ai/automation)
