Octop Gateway

项目简介

Octop Gateway 是面向 AI Agent 与机器人的多平台 IM 通道桥接，提供统一消息抽象。它连接主流 IM 平台，将每条入站消息规范化到同一条处理管线，让 Agent 逻辑只写一次即可在飞书、钉钉、QQ、企业微信、微信 iLink、元宝、小艺、MQTT、Telegram 与 Discord 上运行。网关在通用接口后处理传输、解析、媒体与投递。

核心功能

• 十个平台共用一个处理器：飞书、钉钉、QQ、企业微信、微信 iLink、元宝、小艺、MQTT、Telegram 和 Discord 都在同一接口之后。统一抽象把各平台差异转为通用的 InboundMessage 与 MessageEvent 模型。流式事件让处理器以异步生成器产出 MessageEvent，支持令牌流式传输。可插拔媒体使用 MediaBackend 存储附件，默认提供 FileSystemMediaBackend。每通道约束包含速率限制、超时和输入状态提示。推送路由提供 push_text、push_content 和

适用场景

• 构建一个机器人即可触达多个 IM 平台的用户，无需编写平台专属代码。从单一网关为不同团队或租户运行相互隔离的通道。向单个用户发送主动通知，或向多人广播消息。把 Agent 逻辑连接到飞书、钉钉、QQ、企业微信、Telegram 与 Discord 等平台。

快速开始

• 使用 pip install octop-gateway 安装核心库。需要示例与 Agent 集成附加项时，使用 pip install "octop-gateway[examples]"。前置条件为 Python 3.12+ 以及所连接平台的凭据。复制 .env.example 到 .env 可使用基于环境的配置。定义产出 MessageEvent 的异步处理器，创建 ChannelManager，并添加平台通道。

部署与要求

• Python 3.12+。所连接各平台的凭据。通过复制 .env.example 到 .env 可使用基于环境的配置。

采用前须知

• 许可证：MIT。在使用、修改或分发项目前，请确认其具体条款。