Skip to content

zh platform start

github-actions[bot] edited this page Oct 25, 2026 · 3 revisions

接入消息平台

AstrBot 支持接入众多主流即时通讯软件平台,帮助您在自己喜欢的 IM 平台上使用 AstrBot 的强大功能。

在 WebUI 中,点击侧边栏的机器人,即可进入消息平台接入界面。点击机器人列表上方的 创建机器人,选择您想要接入的平台,按照本文档左侧提供的接入指南进行操作,即可完成接入。

Tip

建议在部署前预先安装 ffmpeg(并确保支持 amr),否则媒体类文件可能无法正常收发。对于微信类平台接入,强烈建议安装。

创建后,从机器人列表中选择实例,在 接入设置 中修改连接参数,点击 保存更改 生效。会话配置 可为机器人选择默认配置文件,或为特定会话单独绑定配置。连接状态显示在机器人列表中,详细日志位于 数据与日志 → 日志。

删除机器人与关联数据

点击机器人列表中的删除按钮,在确认窗口中选择要同时清理的数据。悬停或点击选项旁的信息图标,可查看每项的清理范围。

删除机器人时选择关联数据

  • 默认勾选 自定义规则、偏好设置、配置路由、未来任务。偏好设置包含当前对话选择、会话变量、外部服务会话 ID、适配器专用投递映射,以及自定义分组中的该机器人会话成员;分组本身保留。
  • AI 对话数据、消息历史记录、追踪日志、使用统计 默认保留,可分别勾选,或点击历史数据区域的 全选。
  • AI 对话数据是模型使用的上下文;消息历史记录是平台收发消息。删除消息历史时,也会清理对应的会话名称、别名和发送者名称。追踪日志仅指本地 Trace 存储。使用统计清理此机器人的模型调用、token 和响应耗时记录;按平台类型汇总的消息量保留。

只有选中的数据会被永久删除。共享的配置文件、人格、知识库、模型服务、附件及插件自建数据保留。配置路由只删除平台部分明确为该机器人 ID 的规则,跨平台通配规则保留。勾选未来任务会取消该机器人的调度并删除任务记录。

取消后重新打开窗口,会恢复默认选择。删除失败时,可能已有部分所选数据被清理;机器人配置会保留,便于检查日志后重试。

Chinese

English

Clone this wiki locally