# 入门指南

> 几分钟内安装好 OpenClaw 并开始第一次聊天。

- 网址：https://funcoding.ai/agents/openclaw/start/getting-started/
- 来源：OpenClaw 官方文档原文（中文），MIT 许可，同步于 2026-10-11
- 官方原文：https://docs.openclaw.ai/zh-CN/start/getting-started

---
安装 OpenClaw，运行新手引导，并在大约 5 分钟内与你的 AI 助手聊天。完成后，你将拥有一个正在运行的 Gateway 网关、已配置的身份验证，以及一个可用的聊天会话。

## 所需条件

- **Node.js 22.22.3+、24.15+ 或 25.9+**（推荐默认使用 24）
- 来自模型提供商（Anthropic、OpenAI、Google 等）的**一个 API key**——新手引导会提示你输入

<div class="callout callout-tip">

使用 `node --version` 检查 Node 版本。
**Windows 用户：**原生 Windows Hub 应用是最便捷的桌面端方案。也支持 PowerShell 安装程序和 WSL2 Gateway 网关方案。请参阅 [Windows](https://funcoding.ai/agents/openclaw/platforms/windows/)。
需要安装 Node？请参阅 [Node 设置](https://funcoding.ai/agents/openclaw/install/node/)。

</div>

## 快速设置

**安装 OpenClaw**

**macOS / Linux**

        ```bash
        curl -fsSL https://openclaw.ai/install.sh | bash
        ```
        <img
  src="/official-assets/openclaw/docs/assets/install-script.svg"
  alt="安装脚本流程"
  class="rounded-lg"
/>

**Windows (PowerShell)**

```powershell
iwr -useb https://openclaw.ai/install.ps1 | iex
```

<div class="callout callout-note">

其他安装方式（Docker、Nix、npm）：[安装](https://funcoding.ai/agents/openclaw/install/)。

</div>

**运行新手引导**

```bash
openclaw onboard --install-daemon
```

向导将引导你选择模型提供商、设置 API key 并配置 Gateway 网关。快速开始通常只需几分钟，但提供商登录、渠道配对、守护进程安装、网络下载、Skills 或可选插件可能会延长完整新手引导所需的时间。你可以跳过可选步骤，稍后使用 `openclaw configure` 返回继续配置。

完整参考请参阅[新手引导（CLI）](https://funcoding.ai/agents/openclaw/start/wizard/)。

**验证 Gateway 网关正在运行**

```bash
openclaw gateway status
```

你应该会看到 Gateway 网关正在监听端口 18789。

**打开仪表板**

```bash
openclaw dashboard
```

这会在浏览器中打开 Control UI。如果页面可以加载，则表示一切运行正常。

**发送第一条消息**

在 Control UI 聊天中输入一条消息，你应该会收到 AI 回复。

想改用手机聊天？设置最快的渠道是 [Telegram](https://funcoding.ai/agents/openclaw/channels/telegram/)（只需一个机器人令牌）。所有选项请参阅[渠道](https://funcoding.ai/agents/openclaw/channels/)。

<details>
<summary>高级：挂载自定义 Control UI 构建</summary>

  如果你维护本地化或自定义的仪表板构建，请将 `gateway.controlUi.root` 指向包含已构建静态资源和 `index.html` 的目录。

```bash
mkdir -p "$HOME/.openclaw/control-ui-custom"
# 将已构建的静态文件复制到该目录中。
```

然后设置：

```json
{
  "gateway": {
    "controlUi": {
      "enabled": true,
      "root": "$HOME/.openclaw/control-ui-custom"
    }
  }
}
```

重启 Gateway 网关并重新打开仪表板：

```bash
openclaw gateway restart
openclaw dashboard
```

</details>

## 后续操作

- [连接渠道](https://funcoding.ai/agents/openclaw/channels/)：Discord、Feishu、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等。
- [配对和安全](https://funcoding.ai/agents/openclaw/channels/pairing/)：控制谁可以向你的智能体发送消息。
- [配置 Gateway 网关](https://funcoding.ai/agents/openclaw/gateway/configuration/)：模型、工具、沙箱和高级设置。
- [浏览工具](https://funcoding.ai/agents/openclaw/tools/)：浏览器、Exec、Web 搜索、Skills 和插件。

<details>
<summary>高级：环境变量</summary>

  如果你以服务账户运行 OpenClaw，或希望使用自定义路径：

- `OPENCLAW_HOME` — 用于内部路径解析的主目录
- `OPENCLAW_STATE_DIR` — 覆盖状态目录
- `OPENCLAW_CONFIG_PATH` — 覆盖配置文件路径

完整参考：[环境变量](https://funcoding.ai/agents/openclaw/help/environment/)。

</details>

## 相关内容

- [安装概览](https://funcoding.ai/agents/openclaw/install/)
- [渠道概览](https://funcoding.ai/agents/openclaw/channels/)
- [设置](https://funcoding.ai/agents/openclaw/start/setup/)