---
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="/zh-Hant/docs/openclaw/official/00-getting-started" />
  <Card title="Gateway 執行時" description="Gateway 架構、配置、Agent、Channel、安全遠端訪問和自動化。" href="/zh-Hant/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)
