> ## Documentation Index
> Fetch the complete documentation index at: https://agdiai-597e782f.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 入门指南

# 入门指南

目标：以最少的设置，从零开始到完成第一次可用聊天。

> [!NOTE]
>
> 最快的聊天方式：打开 Control UI（无需设置渠道）。运行 `agdi dashboard`
> 并在浏览器中聊天，或在
> 网关主机 (运行 Agdi Gateway 网关服务的机器。)
> 上打开 `http://127.0.0.1:18789/`。
> 文档：[Dashboard](https://agdiai-597e782f.mintlify.site/web/dashboard.md) 和 [Control UI](https://agdiai-597e782f.mintlify.site/web/control-ui.md)。

## 前置条件

* 推荐使用 Node 24（Node 22 LTS，目前为 `22.16+`，仍因兼容性而受支持）

> [!TIP]
>
> 如果你不确定，请使用 `node --version` 检查你的 Node 版本。

## 快速设置（CLI）

**1. 安装 Agdi（推荐）**

> [tab] macOS/Linux
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> curl -fsSL https://agdi.ai/install.sh | bash
> ```
>
> ![安装脚本流程](https://mintcdn.com/agdiai-597e782f/dgz7lCmhpS3UpOxQ/assets/install-script.svg?fit=max\&auto=format\&n=dgz7lCmhpS3UpOxQ\&q=85\&s=5c5501d2b7c83b56d75b380f816309e3)

> [tab] Windows（PowerShell）
>
> ```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
> iwr -useb https://agdi.ai/install.ps1 | iex
> ```

> [!NOTE]
>
> 其他安装方式和要求： [Install](https://agdiai-597e782f.mintlify.site/install.md)。

**2. 运行新手引导**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
agdi onboard --install-daemon
```

新手引导会配置认证、Gateway 网关设置和可选渠道。
详情请参见 [CLI 新手引导](https://agdiai-597e782f.mintlify.site/start/wizard.md)。

**3. 检查 Gateway 网关**

如果你已安装服务，它应该已经在运行：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
agdi gateway status
```

**4. 打开 Control UI**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
agdi dashboard
```

> [!TIP]
>
> 如果 Control UI 能加载，你的 Gateway 网关就已准备就绪，可以使用。

## 可选检查和附加内容

> [accordion] 在前台运行 Gateway 网关
>
> 适合快速测试或故障排除。
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> agdi gateway --port 18789
> ```

> [accordion] 发送一条测试消息
>
> 需要已配置的渠道。
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> agdi message send --target +15555550123 --message "Hello from Agdi"
> ```

## 常用环境变量

如果你将 Agdi 作为服务账户运行，或想使用自定义配置/状态位置：

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

完整的环境变量参考： [环境变量](https://agdiai-597e782f.mintlify.site/help/environment.md)。

## 深入了解

> [card] [CLI 新手引导](https://agdiai-597e782f.mintlify.site/start/wizard.md)
>
> 完整的 CLI 新手引导参考和高级选项。

> [card] [macOS 应用新手引导](https://agdiai-597e782f.mintlify.site/start/onboarding.md)
>
> macOS 应用的首次运行流程。

## 你将获得什么

* 一个正在运行的 Gateway 网关
* 已配置好的认证
* Control UI 访问权限或一个已连接的渠道

## 后续步骤

* 私信安全和批准：[Pairing](https://agdiai-597e782f.mintlify.site/channels/pairing.md)
* 连接更多渠道：[Channels](https://agdiai-597e782f.mintlify.site/channels.md)
* 高级工作流和源码安装：[Setup](https://agdiai-597e782f.mintlify.site/start/setup.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.