bot/docs/zh-CN/index.md

read_when, summary, title, x-i18n

read_when	summary	title	x-i18n
向新用户介绍 Hanzo Bot	Hanzo Bot 是一个多渠道 AI 智能体 Gateway 网关，可在任何操作系统上运行。	Hanzo Bot	generated_at model provider source_hash source_path workflow 2026-02-04T17:53:40Z claude-opus-4-5 pi fc8babf7885ef91d526795051376d928599c4cf8aff75400138a0d7d9fa3b75f index.md 15

Hanzo Bot 🤖

"去壳！去壳！" — 大概是一只太空龙虾说的

适用于任何操作系统的 AI 智能体 Gateway 网关，支持 WhatsApp、Telegram、Discord、iMessage 等。
发送消息，随时随地获取智能体响应。通过插件可添加 Mattermost 等更多渠道。

安装 Hanzo Bot 并在几分钟内启动 Gateway 网关。 通过 `hanzo-bot onboard` 和配对流程进行引导式设置。 启动浏览器仪表板，管理聊天、配置和会话。

Hanzo Bot 通过单个 Gateway 网关进程将聊天应用连接到 Pi 等编程智能体。它为 Hanzo Bot 助手提供支持，并支持本地或远程部署。

工作原理

flowchart LR
  A["Chat apps + plugins"] --> B["Gateway"]
  B --> C["Pi agent"]
  B --> D["CLI"]
  B --> E["Web Control UI"]
  B --> F["macOS app"]
  B --> G["iOS and Android nodes"]

Gateway 网关是会话、路由和渠道连接的唯一事实来源。

核心功能

通过单个 Gateway 网关进程连接 WhatsApp、Telegram、Discord 和 iMessage。 通过扩展包添加 Mattermost 等更多渠道。 按智能体、工作区或发送者隔离会话。 发送和接收图片、音频和文档。 浏览器仪表板，用于聊天、配置、会话和节点管理。 配对 iOS 和 Android 节点，支持 Canvas。

快速开始

```bash npm install -g bot@latest ``` ```bash hanzo-bot onboard --install-daemon ``` ```bash hanzo-bot channels login hanzo-bot gateway --port 18789 ```

需要完整的安装和开发环境设置？请参阅快速开始。

仪表板

Gateway 网关启动后，打开浏览器控制界面。

• 本地默认地址：http://127.0.0.1:18789/
• 远程访问：Web 界面和 Tailscale

配置（可选）

配置文件位于 ~/.hanzo/bot/bot.json。

• 如果你不做任何修改，Hanzo Bot 将使用内置的 Pi 二进制文件以 RPC 模式运行，并按发送者创建独立会话。
• 如果你想要限制访问，可以从 channels.whatsapp.allowFrom 和（针对群组的）提及规则开始配置。

示例：

{
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: { "*": { requireMention: true } },
    },
  },
  messages: { groupChat: { mentionPatterns: ["@bot"] } },
}

从这里开始

所有文档和指南，按用例分类。 核心 Gateway 网关设置、令牌和提供商配置。 SSH 和 tailnet 访问模式。 WhatsApp、Telegram、Discord 等渠道的具体设置。 iOS 和 Android 节点的配对与 Canvas 功能。 常见修复方法和故障排除入口。

了解更多

全部渠道、路由和媒体功能。 工作区隔离和按智能体的会话管理。 令牌、白名单和安全控制。 Gateway 网关诊断和常见错误。 项目起源、贡献者和许可证。