Mayros

适用于任何操作系统的 AI 代理网关，支持 WhatsApp、Telegram、Discord、iMessage 等。
发送消息，即可从您的口袋中获得代理响应。插件可添加 Mattermost 等更多渠道。

🚀

开始使用

在几分钟内安装 Mayros 并启动网关。

✨

运行向导

使用 mayros onboard 和配对流程进行引导式设置。

🖥️

打开控制 UI

启动浏览器仪表板进行聊天、配置和会话管理。

什么是 Mayros？

Mayros 是一个自托管网关，可将您喜爱的聊天应用（WhatsApp、Telegram、Discord、iMessage 等）连接到像 Pi 这样的 AI 编码代理。您在自己的机器（或服务器）上运行单个 Gateway 进程，它就成为您的消息应用与始终可用的 AI 助手之间的桥梁。

**适合谁使用？**希望拥有个人 AI 助手并可以随时随地发送消息的开发者和高级用户——无需放弃对数据的控制或依赖托管服务。

有什么不同之处？

自托管：在您的硬件上运行，您说了算
多渠道：一个 Gateway 同时服务 WhatsApp、Telegram、Discord 等
代理原生：为编码代理构建，具有工具使用、会话、内存和多代理路由功能
开源：MIT 许可，社区驱动

**需要什么？**Node 22+、API 密钥（推荐 Anthropic）和 5 分钟时间。

工作原理

mermaid
flowchart LR
  A["聊天应用 + 插件"] --> B["Gateway"]
  B --> C["Pi 代理"]
  B --> D["CLI"]
  B --> E["Web 控制 UI"]
  B --> F["macOS 应用"]
  B --> G["iOS 和 Android 节点"]

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

核心功能

🌐

多渠道网关

通过单个 Gateway 进程支持 WhatsApp、Telegram、Discord 和 iMessage。

🔌

插件渠道

通过扩展包添加 Mattermost 等渠道。

🔀

多代理路由

每个代理、工作区或发送者的隔离会话。

🖼️

媒体支持

发送和接收图像、音频和文档。

🖥️

Web 控制 UI

用于聊天、配置、会话和节点的浏览器仪表板。

📱

移动节点

配对 iOS 和 Android 节点，支持 Canvas。

快速开始

安装 Mayros

bash
npm install -g mayros@latest

入门并安装服务

bash
mayros onboard --install-daemon

配对 WhatsApp 并启动 Gateway

bash
mayros channels login
mayros gateway --port 18789

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

仪表板

Gateway 启动后打开浏览器控制 UI。

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

配置（可选）

配置位于 ~/.mayros/mayros.json。

如果您不做任何操作，Mayros 会在 RPC 模式下使用捆绑的 Pi 二进制文件，并为每个发送者创建会话。
如果您想锁定它，请从 channels.whatsapp.allowFrom 和（对于群组）提及规则开始。

示例：

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