Skip to content

连接聊天平台

Kirara AI 支持连接多种聊天平台,通过适配器机制实现跨平台的消息处理。本文将指导您完成平台连接的配置。

适配器:平台连接的桥梁

适配器是 Kirara AI 与外部平台之间的连接桥梁,主要功能包括:

  • 处理不同平台的消息协议
  • 转换消息格式为统一结构
  • 管理平台特有的认证机制

配置入口

通过 WebUI 左侧导航栏按路径操作:
IM 管理 → 平台管理 → 添加适配器

配置步骤

一、选择适配器类型

Kirara AI 提供以下适配器:

  • 内置适配器:支持 Telegram、企业微信等主流平台
  • 插件适配器:通过插件市场扩展的平台支持

▸ 提示:若目标平台未列出,需先安装对应插件

二、命名配置

  • 命名规范
    • 格式:[平台]_[用途](示例:telegram_cs_bot
    • 字符限制:小写字母/数字/下划线
    • 全局唯一性:不可与现有配置重名

三、填写平台凭证

内置适配器配置指南

适配器类型平台关键参数获取位置
telegramTelegram 机器人Bot Token@BotFather 创建机器人时获取
http_legacyHTTP 服务Host + Port 组合本地服务配置信息
wecom企业微信CorpID + Secret + AgentID企业微信管理后台 应用详情页

配置示例:

Telegram 机器人

▸ 必须参数:

  • Token:格式为 数字:字母组合,从 @BotFather 获取

▸ 注意事项:

  1. 确保开启 Privacy Mode
  2. 确认已添加机器人到群组

HTTP 服务

▸ 功能说明: 通过 HTTP 协议将 Kirara AI 的能力开放给其他系统,使外部程序可以通过 API 调用获得 AI 服务。

▸ 配置参数:

  • Host:服务监听地址(默认:127.0.0.1)
  • Port:服务监听端口(建议:8080)

企业微信(WeCom)

▸ 参数获取路径:

  1. 登录 企业微信管理后台
  2. 进入「应用管理」→「自建应用」
  3. 在应用详情页获取所需信息

连接其他平台

若需连接未内置的平台:

  1. 访问 插件市场 搜索目标平台适配器
  2. 安装完成后,返回本页面即可在下拉菜单看到新选项
  3. 根据插件文档填写配置参数