> ## 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.

# Agdi

# Agdi 🦞

![Agdi](https://mintlify.s3.us-west-1.amazonaws.com/agdiai-597e782f/assets/agdi-logo-text-dark.png)

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

**适用于任何操作系统的 AI 智能体 Gateway 网关，支持 WhatsApp、Telegram、Discord、iMessage 等。**\

发送消息，随时随地获取智能体响应。通过插件可添加 Mattermost 等更多渠道。

> [card] [入门指南](https://agdiai-597e782f.mintlify.site/start/getting-started.md)
>
> 安装 Agdi 并在几分钟内启动 Gateway 网关。

> [card] [运行新手引导](https://agdiai-597e782f.mintlify.site/start/wizard.md)
>
> 通过 `agdi onboard` 和配对流程进行引导式设置。

> [card] [打开控制界面](https://agdiai-597e782f.mintlify.site/web/control-ui.md)
>
> 启动浏览器仪表板，管理聊天、配置和会话。

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

## 工作原理

```mermaid theme={"theme":{"light":"min-light","dark":"min-dark"}}
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 网关是会话、路由和渠道连接的唯一事实来源。

## 核心功能

> [card] 多渠道 Gateway 网关
>
> 通过单个 Gateway 网关进程连接 WhatsApp、Telegram、Discord 和 iMessage。

> [card] 插件渠道
>
> 通过扩展包添加 Mattermost 等更多渠道。

> [card] 多智能体路由
>
> 按智能体、工作区或发送者隔离会话。

> [card] 媒体支持
>
> 发送和接收图片、音频和文档。

> [card] Web 控制界面
>
> 浏览器仪表板，用于聊天、配置、会话和节点管理。

> [card] 移动节点
>
> 配对 iOS 和 Android 节点，支持 Canvas。

## 快速开始

**1. 安装 Agdi**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
npm install -g agdi@latest
```

**2. 新手引导并安装服务**

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

**3. 配对 WhatsApp 并启动 Gateway 网关**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
agdi channels login
agdi gateway --port 18789
```

需要完整的安装和开发环境设置？请参阅[快速开始](https://agdiai-597e782f.mintlify.site/start/quickstart.md)。

## 仪表板

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

* 本地默认地址：[http://127.0.0.1:18789/](http://127.0.0.1:18789/)
* 远程访问：[Web 界面](https://agdiai-597e782f.mintlify.site/web.md)和 [Tailscale](https://agdiai-597e782f.mintlify.site/gateway/tailscale.md)

![Agdi](https://mintlify.s3.us-west-1.amazonaws.com/agdiai-597e782f/whatsapp-agdi.jpg)

## 配置（可选）

配置文件位于 `~/.agdi/agdi.json`。

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

示例：

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: { "*": { requireMention: true } },
    },
  },
  messages: { groupChat: { mentionPatterns: ["@agdi"] } },
}
```

## 从这里开始

> [card] [文档中心](https://agdiai-597e782f.mintlify.site/start/hubs.md)
>
> 所有文档和指南，按用例分类。

> [card] [配置](https://agdiai-597e782f.mintlify.site/gateway/configuration.md)
>
> 核心 Gateway 网关设置、令牌和提供商配置。

> [card] [远程访问](https://agdiai-597e782f.mintlify.site/gateway/remote.md)
>
> SSH 和 tailnet 访问模式。

> [card] [渠道](https://agdiai-597e782f.mintlify.site/channels/telegram.md)
>
> WhatsApp、Telegram、Discord 等渠道的具体设置。

> [card] [节点](https://agdiai-597e782f.mintlify.site/nodes.md)
>
> iOS 和 Android 节点的配对与 Canvas 功能。

> [card] [帮助](https://agdiai-597e782f.mintlify.site/help.md)
>
> 常见修复方法和故障排除入口。

## 了解更多

> [card] [完整功能列表](https://agdiai-597e782f.mintlify.site/concepts/features.md)
>
> 全部渠道、路由和媒体功能。

> [card] [多智能体路由](https://agdiai-597e782f.mintlify.site/concepts/multi-agent.md)
>
> 工作区隔离和按智能体的会话管理。

> [card] [安全](https://agdiai-597e782f.mintlify.site/gateway/security.md)
>
> 令牌、白名单和安全控制。

> [card] [故障排除](https://agdiai-597e782f.mintlify.site/gateway/troubleshooting.md)
>
> Gateway 网关诊断和常见错误。

> [card] [关于与致谢](https://agdiai-597e782f.mintlify.site/reference/credits.md)
>
> 项目起源、贡献者和许可证。


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