bot/docs/zh-CN/start/getting-started.md

read_when, summary, title, x-i18n

read_when	summary	title	x-i18n
从零开始进行首次设置 你想用最快的路径开始可用聊天	在几分钟内安装 Hanzo Bot 并开始你的第一次聊天。	入门指南	generated_at model provider source_hash source_path workflow 2026-03-16T06:27:55Z gpt-5.4 openai 47583047c1a603c1254d2540846452ad321d12bc7fc3f24e5def9282ee96f415 start/getting-started.md 15

入门指南

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

最快的聊天方式：打开 Control UI（无需设置渠道）。运行 `hanzo-bot dashboard` 并在浏览器中聊天，或在 网关主机 上打开 `http://127.0.0.1:18789/`。 文档：[Dashboard](/web/dashboard) 和 [Control UI](/web/control-ui)。

前置条件

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

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

快速设置（CLI）

```bash curl -fsSL https://hanzo.bot/install.sh | bash ``` ```powershell iwr -useb https://hanzo.bot/install.ps1 | iex ```

<Note>
其他安装方式和要求： [Install](/install)。
</Note>

```bash hanzo-bot onboard --install-daemon ```

新手引导会配置认证、Gateway 网关设置和可选渠道。
详情请参见 [CLI 新手引导](/start/wizard)。

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

```bash
hanzo-bot gateway status
```

```bash hanzo-bot dashboard ``` 如果 Control UI 能加载，你的 Gateway 网关就已准备就绪，可以使用。

可选检查和附加内容

适合快速测试或故障排除。

```bash
hanzo-bot gateway --port 18789
```

需要已配置的渠道。

```bash
hanzo-bot message send --target +15555550123 --message "Hello from Hanzo Bot"
```

常用环境变量

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

• BOT_HOME 设置用于内部路径解析的主目录。
• BOT_STATE_DIR 覆盖状态目录。
• BOT_CONFIG_PATH 覆盖配置文件路径。

完整的环境变量参考： 环境变量。

深入了解

完整的 CLI 新手引导参考和高级选项。 macOS 应用的首次运行流程。

你将获得什么

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

后续步骤

• 私信安全和批准：Pairing
• 连接更多渠道：Channels
• 高级工作流和源码安装：Setup