---
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="/docs/openclaw/official/00-getting-started/installation" />
  <Card title="快速上手 OpenClaw" description="从 onboarding 到 Gateway、Dashboard、第一条消息和下一步渠道选择。" href="/docs/openclaw/official/00-getting-started/quickstart" />
  <Card title="理解配置结构" description="openclaw.json、JSON5、strict schema、热加载、环境变量和排障顺序。" href="/docs/openclaw/official/00-getting-started/configuration" />
  <Card title="配置 Agent Workspace" description="workspace 文件地图、长期记忆、私有备份、sandbox 和迁移边界。" href="/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="/docs/openclaw/official/01-gateway-runtime" />
  <Card title="总入口：官方教程中文版" description="回到 OpenClaw 官方教程中文版总览。" href="/docs/openclaw/official" />
</Cards>
