---
title: "入門與安裝"
description: "OpenClaw 入門與安裝學習地圖：先安裝和 onboarding，再驗證 Gateway、理解配置結構，最後整理 Agent Workspace。"
verifiedAt: "2026-05-05"
---

這一組只解決一件事：讓 OpenClaw 在你的機器上穩定跑起來，並且知道每個關鍵檔案、命令和頁面分別管什麼。不要一上來就接很多渠道、寫複雜 Agent 或開放遠端訪問；先把最小閉環跑通。

> [!NOTE]
> **適合從這裡開始的人**：第一次安裝 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。

```mermaid
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
```

## 2. 章節入口

<Cards>
  <Card title="安裝 OpenClaw" description="系統要求、安裝指令碼、Node 版本、替代安裝路徑和安裝後驗證。" href="/zh-Hant/docs/openclaw/official/00-getting-started/installation" />
  <Card title="快速上手 OpenClaw" description="從 onboarding 到 Gateway、Dashboard、第一條訊息和下一步渠道選擇。" href="/zh-Hant/docs/openclaw/official/00-getting-started/quickstart" />
  <Card title="理解配置結構" description="openclaw.json、JSON5、strict schema、熱載入、環境變數和排障順序。" href="/zh-Hant/docs/openclaw/official/00-getting-started/configuration" />
  <Card title="配置 Agent Workspace" description="workspace 檔案地圖、長期記憶、私有備份、sandbox 和遷移邊界。" href="/zh-Hant/docs/openclaw/official/00-getting-started/workspace" />
</Cards>

## 3. 推薦閱讀順序

新手按這個順序讀：

1. 先讀“安裝 OpenClaw”，按你的系統選擇一個安裝通道，不要混裝。
2. 再讀“快速上手 OpenClaw”，完成 onboarding，並確認 Gateway 正在監聽。
3. 然後讀“理解配置結構”，知道什麼能用 CLI / Control UI 改，什麼必須謹慎編輯。
4. 最後讀“配置 Agent Workspace”，把身份、規則、使用者資訊、工具說明和長期記憶分清。

如果你已經裝好了，可以按問題跳：

- `openclaw` 命令不存在：看安裝章節的 PATH 和 Node 全域性包路徑排查。
- Gateway 沒有啟動：看快速開始裡的 `gateway status`、`doctor`、`logs`、`health`。
- 不知道配置欄位怎麼改：看配置結構裡的 schema、熱載入和排障順序。
- 想把 workspace 放進 git：先看 Workspace 章節裡的“不能提交什麼”。

> [!TIP]
> **跳讀也要先定位問題層**：命令找不到是安裝層；Gateway 不回是執行層；配置不生效是 schema / reload 層；身份和記憶混亂才是 workspace 層。

## 4. 先不要做什麼

入門階段先不要急著做這些：

- 直接把 Gateway 暴露到公網。
- 把 `dmPolicy` 設成 `open` 後不加訪問控制。
- 把 `~/.openclaw/` 整目錄提交到 git。
- 複製陌生人的完整 `openclaw.json`。
- 同時接 Telegram、Discord、Slack、WhatsApp 等多個渠道。
- 先寫 cron、hooks、standing orders，再回頭排 Gateway 基礎問題。

> [!IMPORTANT]
> **先跑通最小閉環**：能安裝、能 onboarding、能看到 Gateway、能在 Dashboard 發第一條訊息，才進入 Gateway 執行時和渠道配置。

> [!WARNING]
> **入門階段不要擴大暴露面**：Channel、遠端訪問和自動化都會放大基礎配置問題；最小閉環沒過，先不要接外部入口。

## 5. 完成後的驗收標準

讀完這一組，你應該能做到：

- 能解釋 OpenClaw 為什麼需要一個長期執行的 Gateway。
- 能在自己的系統上安裝並驗證 `openclaw --version`。
- 能執行 `openclaw doctor`、`openclaw gateway status` 和 `openclaw dashboard`。
- 能說清 `~/.openclaw/openclaw.json` 是配置檔案，不是 workspace 內容。
- 能判斷一個配置改動是否可能熱載入，還是需要重啟 Gateway。
- 能整理 workspace 標準檔案，並避免把 token、OAuth、session 和 auth profiles 放進 git。
- 能進入下一組 Gateway 執行時，而不是繼續在安裝問題裡反覆打轉。

> [!NOTE]
> **這一組的結束狀態**：不是“看完四篇”，而是你能在本機復現安裝、診斷、啟動、開啟 Dashboard 和確認 workspace 邊界。

## 6. 官方資料

- [Install](https://docs.openclaw.ai/install)
- [Getting started](https://docs.openclaw.ai/start/getting-started)
- [Configuration](https://docs.openclaw.ai/gateway/configuration)
- [Agent workspace](https://docs.openclaw.ai/concepts/agent-workspace)

<Cards>
  <Card title="下一組：Gateway 執行時" description="安裝和 workspace 跑通之後，繼續理解 Gateway、Agent、Channel、安全和自動化。" href="/zh-Hant/docs/openclaw/official/01-gateway-runtime" />
  <Card title="總入口：官方教程中文版" description="回到 OpenClaw 官方教程中文版總覽。" href="/zh-Hant/docs/openclaw/official" />
</Cards>
