Loading...

文章背景图

AstrBot 七大陪伴类插件合集:主动消息·联网搜索·群聊增强·长期记忆·自主学习·表情包管理·大肥鱼人格核心|安装与配置指南

2026-11-09
0
- 字
- 分钟
|
astrbot_plugin_proactive_chat

https://zhouruolin.cn/upload/meme_Banner.png

把 DeepSeek 或其他大模型接进 AstrBot 之后,一个”会聊天的机器人”通常还差六块拼图:它能不能主动找你说话?能不能联网查最新消息?能不能在群里读空气、不抢话?能不能记住你上周说过的偏好?能不能学你说话的语气?能不能在合适的时候蹦一张表情包?

本文一次性整理视频中提到的六个 AstrBot 社区插件,全部来自官方 GitHub 仓库,给出仓库地址、安装方式与核心配置要点,方便你照着部署。

1 合集总览

插件 作者 / 仓库 解决的问题 许可证 最低版本
主动消息 Proactive Chat DBJD-CR/astrbot_plugin_proactive_chat 让 Bot 在私聊和群聊中主动发起消息 开源 AstrBot 较新版本
Anysearch 实时联网搜索 AgIzT/astrbot_plugin_anysearch 为 Bot 接入实时联网搜索与网页正文提取 开源 AstrBot 较新版本
Chat Plus 群聊增强 Him666233/astrbot_plugin_group_chat_plus 以 AI 读空气为核心,控制 Bot 在群里的回复时机 AGPL-3.0 AstrBot ≥ v4.11.0
LivingMemory 长期记忆 lxfight-s-Astrbot-Plugins/astrbot_plugin_livingmemory 完整记忆生命周期的长期记忆与 2D/3D 图谱 AGPL-3.0 AstrBot 4.24.2+,Python 3.10+
Self-Learning 自主学习 NickCharlie/astrbot_plugin_self_learning 学习对话风格、群组黑话、社交关系与好感度 AGPL-3.0 AstrBot ≥ 4.11.4,Python 3.11+
表情包管理器 anka-afk/astrbot_plugin_meme_manager WebUI 表情包管理、资源广场、语义检索与自动收集 MIT AstrBot 4.17.0+

以上六个插件均为社区开发者作品,并非 AstrBot 官方内置功能。安装前请阅读各自仓库的 LICENSE 与 README,注意 AGPL-3.0 传染性条款对二次分发的要求。

2 前置条件

  • 已部署一套可正常运行的 AstrBot,并能打开其 WebUI 管理面板。
  • 至少配置好一个可用的 LLM Provider(例如 DeepSeek、OpenAI 兼容接口)。
  • 建议 Python 3.11 及以上;LivingMemory 需要单独配置 Embedding Provider(推荐硅基流动免费的 BAAI/bge-m3)。
  • 插件安装位置默认为 AstrBot 工作目录下的 data/plugins/。

3 插件一:主动消息 Proactive Chat

3.1 它是什么

一个能让 Bot 在私聊和群聊中主动发起消息的插件。它不是定时刷屏机器人,而是具备上下文感知、持久化数据、动态情绪、免打扰时段和 TTS 集成能力,并有独立 WebUI 用于个性化配置。

3.2 官方链接

  • 仓库:https://github.com/DBJD-CR/astrbot_plugin_proactive_chat
  • 插件市场:https://cloud.astrbot.app/ (搜索”主动消息”)

3.3 核心能力

  • 后台定时巡检会话,在满足条件时主动开口,私聊与群聊均支持。
  • 结合会话近期对话生成话题,避免尬聊。
  • 数据落盘到 data/plugin_data/,重装插件不丢记忆。
  • 支持免打扰时段(如 23:00-07:30),静默期间绝不打扰。
  • 可选接入 AstrBot 的 TTS Provider,把主动消息转成语音。
  • 提供独立 WebUI,管理会话、情绪、配置与日志。

3.4 安装与配置

  1. 在 AstrBot 插件市场搜索”主动消息”安装,或通过”从链接安装”填入仓库地址。
  2. 重载插件后,在插件配置中开启需要主动发言的会话,设置主动消息开关、免打扰时段、TTS 开关。
  3. 默认安全姿态:不启用任何群、主动消息关闭、语音输出关闭、免打扰开启——需要你手动逐个打开。
  4. 详细配置项以仓库 README 最新说明为准。

4 插件二:Anysearch 实时联网搜索

4.1 它是什么

面向 AstrBot 的 Anysearch 原生搜索插件。当 Bot 需要查新闻、事实、产品信息或近期变化时,通过它调用 Anysearch API 完成实时联网检索。

4.2 官方链接

  • 仓库:https://github.com/AgIzT/astrbot_plugin_anysearch
  • Anysearch 官网与 API Key:https://anysearch.com/

4.3 核心能力

  • 实时联网检索:支持网页、新闻、代码、文档、学术、图片、视频等内容类型。
  • 批量查询:一次并行执行多个独立搜索,适合对比资料。
  • 网页正文提取:当搜索摘要不够时,提取公开网页的 Markdown 正文。
  • LLM 工具注册:自动向 AstrBot 注册 anysearch_search、anysearch_extract、anysearch_batch_search 三个函数工具,供模型在对话中自动调用。

4.4 指令

/anysearch 关键词
/anysearch extract https://example.com/page
/anysearch batch 关键词1,关键词2,关键词3
/搜索 关键词

4.5 配置要点

  • api_key 为可选项:留空仍可使用 Anysearch 匿名访问;需要更稳定额度时,在 https://anysearch.com/console/api-keys 获取 API Key 后填入。
  • command_result_chunk_size:长结果分段长度,默认 1200;填 0 表示不分段。
  • chunk_private_command_results:私聊长结果自动分段,默认开启,用于规避 OneBot/NapCat 私聊合并转发报错。
  • chunk_group_command_results:群聊长结果自动分段,默认关闭,避免群里刷屏。

4.6 安全说明

搜索关键词和待提取 URL 会发送到 https://api.anysearch.com/mcp。不要用它查询密码、私人文档或商业机密。anysearch_extract 只接受公开 http/https URL,会自动拒绝本地地址、回环地址和私网 IP。

5 插件三:Chat Plus 群聊增强

5.1 它是什么

一个以 AI 读空气为核心的群聊增强插件,让 Bot 更懂氛围、更自然地参与群聊互动。它的原版作者是 Him666233,社区另有 galaxy-b612 维护的修改版(新增三层睡眠状态机)。

5.2 官方链接

  • 原版仓库:https://github.com/Him666233/astrbot_plugin_group_chat_plus
  • 修改版仓库:https://github.com/galaxy-b612/astrbot_plugin_group_chat_plus
  • 许可证:AGPL-3.0

5.3 核心机制

  • AI 读空气:两层过滤——概率筛选 + AI 智能判断,精准控制回复时机。
  • 动态概率系统:回复后概率提升以促进连续对话,时段概率模拟作息节奏。
  • 注意力机制:多用户同时追踪(0-1 连续值),指数衰减,情绪检测。
  • 智能缓存:未回复消息保留上下文,下次回复时自动合并。
  • 记忆系统:支持 LivingMemory(混合检索 + 人格隔离)和 Legacy 双模式。
  • 真实感增强:基于拼音相似性的打字错误(默认 2%)、情绪系统、回复延迟模拟打字速度。
  • Web 管理面板:可视化配置、实时统计图表、访问日志、IP 安全管理、JWT 认证。

5.4 安装

# 方式一:插件市场搜索安装
# 方式二:克隆到 data/plugins
cd data/plugins
git clone https://github.com/Him666233/astrbot_plugin_group_chat_plus.git
# 安装依赖
pip install pypinyin

重载 AstrBot 后在插件管理面板配置。

5.5 使用前必读

  • 必须关闭 AstrBot 官方自带的主动回复功能。本插件与官方主动回复是两套独立系统,同时开启会导致重复回复、刷屏、API 费用翻倍。
  • 图片处理必须配置 image_to_text_provider_id(图片转文字提供商 ID),留空直接传图给多模态模型的方式目前不可靠。
  • 私聊功能仍在开发中,不要开启 enable_private_chat。

5.6 推荐配置(保守版)

{
  "enable_group_chat": true,
  "initial_probability": 0.08,
  "after_reply_probability": 0.8,
  "probability_duration": 120,
  "trigger_keywords": ["填写你的AI角色名字/别名"],
  "enable_attention_mechanism": true,
  "enable_conversation_fatigue": true,
  "enable_proactive_chat": true,
  "enable_typo_generator": true,
  "enable_mood_system": true,
  "enable_typing_simulator": true,
  "enable_humanize_mode": true
}

完整配置项参考仓库内 docs/CONFIG_REFERENCE.md。

6 插件四:LivingMemory 长期记忆

https://zhouruolin.cn/upload/lm_graph-3d.png

6.1 它是什么

为 AstrBot 打造的、拥有完整记忆生命周期的智能长期记忆插件(v2.0 重构版)。它从对话中整理记忆,在需要时结合关键词、语义和图谱召回,并通过归档、衰减和访问强化管理记忆的生命周期。

6.2 官方链接

  • 仓库:https://github.com/lxfight-s-Astrbot-Plugins/astrbot_plugin_livingmemory
  • 使用文档:https://lxfight-s-astrbot-plugins.github.io/astrbot_plugin_livingmemory/
  • 版本下载:https://github.com/lxfight-s-Astrbot-Plugins/astrbot_plugin_livingmemory/releases
  • 许可证:AGPL-3.0

6.3 核心能力

  • 自动整理:达到配置的对话轮次后生成长期记忆,重要记录可保留原文。
  • 按上下文召回:文档与图谱都支持关键词和向量检索,融合排序后结合会话、人格和生命周期筛选。
  • 主动回忆与写入:Agent 可调用 recall_long_term_memory 和 memorize_long_term_memory,按需读写长期记忆。
  • 看得见、可维护:在官方插件视图中浏览 2D/3D 图谱、点击节点变焦、编辑记忆、测试召回。

https://zhouruolin.cn/upload/lm_graph-3d-detail.png

6.4 开始使用

  1. 从 AstrBot 插件市场安装,或将指定版本放入 data/plugins/astrbot_plugin_livingmemory。
  2. 先在 AstrBot 后台”模型提供商 → 嵌入”中创建并启用 Embedding Provider,推荐免费的 BAAI/bge-m3。
  3. 重载 AstrBot,在 LivingMemory 配置中填入 Embedding Provider ID 与 LLM Provider。
  4. 打开”插件 → LivingMemory → 视图 → dashboard”。插件视图需要 AstrBot 4.24.2 或更高版本。
  5. 发送几轮对话后,用以下指令检查:
    • /lmem status 查看状态
    • /lmem summarize 手动总结
    • /lmem search 关键词 检查召回

6.5 免费 Embedding 配置示例

在 AstrBot”模型提供商 → 嵌入 → 新增模型提供商 → OpenAI Embedding”中填写:

配置项 值
API Base URL https://api.siliconflow.cn/v1
API Key 硅基流动控制台创建的密钥
嵌入模型 BAAI/bge-m3
嵌入维度 1024

保存测试后,把该 Provider ID 填入 LivingMemory 的 provider_settings.embedding_provider_id。

7 插件五:Self-Learning 自主学习

https://zhouruolin.cn/upload/sl_logo.png

7.1 它是什么

让 AstrBot 在群聊中持续采集、学习、审查并注入上下文,使 Bot 逐步具备表达风格、群组黑话、社交关系、长期记忆和人格演化能力。它不会直接替换 AstrBot 的回复逻辑,而是在消息进入、Bot 回复发送后、下一次 LLM 请求前这三个位置增强 AstrBot。

7.2 官方链接

  • 仓库:https://github.com/NickCharlie/astrbot_plugin_self_learning
  • 作者:NickMo / Mo Zhiping,维护者 EterUltimate
  • 许可证:AGPL-3.0

7.3 核心功能

功能 说明
对话风格学习 从真实 user→bot 对话对中提取表达模式、few-shot 和风格审查记录
群组黑话学习 统计高频词,结合上下文推断含义,在 LLM 请求前注入解释
人格演化审查 学习结果先进入审查链路,支持批准、拒绝、删除、回滚和自动应用策略
社交关系分析 记录互动关系、好感度、心理状态和群组社交上下文
记忆与知识图谱 构建记忆图、知识图谱和可视化查询入口
LLM 请求注入 在 on_llm_request 阶段注入社交、黑话、记忆、few-shot 和临时人格增量
WebUI Dashboard 全量设置、审查、黑话、图谱、学习内容、日志等级和指标监控
多数据库支持 支持 SQLite、MySQL、PostgreSQL,自动建表和轻量迁移

7.4 安装与警告

cd data/plugins
git clone https://github.com/NickCharlie/astrbot_plugin_self_learning.git

使用前必须先在 AstrBot 原生人格管理中手动备份当前人格数据。 学习、审查和回滚机制不能替代外部备份。

7.5 与 Chat Plus 的搭配

Self-Learning 与 Chat Plus 官方推荐组合使用:

  • Chat Plus 负责”智能决策何时回复”——AI 读空气、动态概率、注意力机制。
  • Self-Learning 负责”智能优化如何回复”——对话风格学习、人格自动优化、好感度系统。

两者功能互补,一个管”什么时候说话”,一个管”怎么说话”。

8 插件六:表情包管理器

8.1 它是什么

为 AstrBot 提供表情包下载、整理、智能发送与自动收集功能。通过 WebUI 管理多个表情包,按会话或人格组合使用,并支持分类选图、语义检索和云端同步。

8.2 官方链接

  • 仓库:https://github.com/anka-afk/astrbot_plugin_meme_manager
  • 许可证:MIT
  • 当前版本:v5.2.10

https://zhouruolin.cn/upload/meme_%E8%B5%84%E6%BA%90%E5%B9%BF%E5%9C%BA.png

8.3 核心能力

你想做的事 它怎么帮你
先让 Bot 用上表情 从资源广场安装表情包,设置使用规则即可,无需额外选图模型或图床
为不同聊天搭配表情 按默认、会话或人格绑定多个包,自由组合
找到更贴合语境的图片 四种选图模式:分类标签、辅助模型分类、Tool 语义检索、辅助模型语义检索
整理越来越大的图库 WebUI 分类预览、拖拽整理、批量操作、跨包移动
留下聊天里的好表情 自动识别、分类、去重,支持人工审核后入包
备份和分享收藏 支持兰空图床、Cloudflare R2、WebDAV、StarDots 云端同步

https://zhouruolin.cn/upload/meme_%E8%A1%A8%E6%83%85%E5%8C%85%E7%AE%A1%E7%90%86.png

8.4 第一次使用

  1. 在 AstrBot 插件市场搜索”表情包管理器”安装。
  2. 进入 AstrBot WebUI → 插件页面 → 表情包管理器。
  3. 打开资源广场,下载一个官方或社区表情包。
  4. 进入设置中心 → 使用规则,将下载的包设为默认,或绑定到指定会话、人格,保存规则。
  5. 开始聊天。插件会自动提供当前表情包的分类提示,无需修改人格。

首次使用没有内置图片,必须先安装表情包。管理页的选包用于浏览和编辑,聊天实际使用哪个包由使用规则决定。

8.5 四种选图模式对比

模式 如何选图 使用前准备 适合场景
原生分类标签 回复模型输出分类标签,再从该分类随机取图 安装表情包,无需额外模型 最省 token,最平衡
辅助模型分类标签 辅助模型根据回复选择分类 额外调用辅助模型 希望辅助模型负责分类
Tool 语义检索 回复模型调用搜索工具选择具体图片 完成图片描述与向量索引 希望模型主动检索更贴切的图
辅助模型语义检索 辅助模型根据回复检索并选图 完成图片描述与向量索引 回复模型专注对话,辅助模型选图

8.6 支持的图床

图床仅用于云端同步,可在”设置中心 → 存储与下载”中配置:兰空图床(Lsky Pro 2.x)、Cloudflare R2、WebDAV、StarDots。其中 Cloudflare R2 使用 MinIO Python SDK 接入 S3 API,不依赖 boto3,避免与桌面端依赖锁冲突。

8.7 常用指令

指令 说明
/表情管理 查看图库 列出所有可用表情类别
/表情管理 添加分类 [类别] [描述] 创建新分类
/表情管理 添加表情 [类别] 通过聊天上传表情
/表情管理 恢复默认表情包 从官方仓库一键安装首个官方包
/表情管理 同步状态 检查同步状态
/表情管理 同步到云端 将本地表情同步到云端

9 组合使用建议

这六个插件并不是互相独立的,它们在”让 Bot 像一个真实陪伴者”这条链路上有明确分工:

  1. 记忆底座:先装 LivingMemory,让 Bot 有长期记忆。
  2. 学习能力:再装 Self-Learning,让 Bot 学会群里的说话风格和黑话。
  3. 回复时机:装 Chat Plus 控制 Bot 什么时候开口(注意关掉官方主动回复)。
  4. 主动发起:装 Proactive Chat,让 Bot 在合适的时候主动找人说话。
  5. 信息能力:装 Anysearch,让 Bot 能联网查最新资料。
  6. 氛围加成:装表情包管理器,让 Bot 在合适的语境蹦一张图。

部署顺序建议从下往上:先把 LLM 和 Embedding 配好,再上记忆和学习类插件,最后上主动发言和表情类插件,每装一个就重载测试一次,避免多个插件同时改 LLM 请求导致难以排查冲突。

10 风险与合规说明

  • 六个插件均为社区开发者作品,AstrBot 官方不背书插件市场中插件的安全性,请仔细甄别来源。
  • 其中 LivingMemory、Chat Plus、Self-Learning 采用 AGPL-3.0 许可证,任何基于其源码的修改或衍生作品必须以相同协议开源;表情包管理器为 MIT,相对宽松;Proactive Chat 与 Anysearch 请以各自仓库 LICENSE 为准。
  • Self-Learning 会持续采集群聊消息进行学习,部署前请告知群成员并取得授权,遵守当地数据保护法规。
  • Anysearch 会将搜索关键词发送到第三方 API,不要用它查询敏感信息。
  • Proactive Chat 与 Chat Plus 都涉及主动发言能力,建议从最保守的配置开始(低概率、免打扰时段、白名单群),逐步放开,避免 Bot 在群里刷屏或产生意外 API 费用。
  • 升级 AstrBot 前建议先升级表情包管理器到 v5.2.9 或更新版本,避免核心依赖锁冲突。
  • 本文仅整理官方仓库公开信息,不构成任何使用建议;因插件配置不当或第三方 API 服务变更导致的任何损失,由部署者自行承担。

安装部署(实操步骤)

1. 前置准备

  • 项目仓库:DBJD-CR/astrbot_plugin_proactive_chat(https://github.com/DBJD-CR/astrbot_plugin_proactive_chat)
  • 需要本机具备 Git;按项目语言准备对应运行时(Python / Node.js / Go / Java 等)
  • 建议先在本机或测试服务器上跑通,再部署到生产环境
  • 遇到依赖版本问题时,以仓库 README 与 Releases 说明为准

2. 官方安装 / 启动命令(摘自项目 README,可直接复制执行)

    pip install fastapi uvicorn
    # Python < 3.11 额外安装
    pip install "tomli>=2.0; python_version < '3.11'"
    

3. 部署流程

  1. 克隆仓库:git clone https://github.com/DBJD-CR/astrbot_plugin_proactive_chat
  2. 进入目录后按上面的官方命令安装依赖
  3. 参考 README 的配置说明填写配置文件或环境变量
  4. 按官方说明启动服务,确认监听端口与访问地址
  5. 浏览器访问验证功能,确认无报错后再开放外网

4. 常见问题排查

  • 依赖安装失败:先升级包管理器,再确认运行时版本符合 README 要求
  • 启动报端口占用:修改配置中的端口或释放被占用端口
  • 页面打不开:检查防火墙 / 安全组是否放行对应端口
  • 功能异常:查看运行日志,对照 Issues 中同类问题处理

5. 官方链接

  • 仓库主页:https://github.com/DBJD-CR/astrbot_plugin_proactive_chat
  • README:https://github.com/DBJD-CR/astrbot_plugin_proactive_chat#readme
  • Issues:https://github.com/DBJD-CR/astrbot_plugin_proactive_chat/issues
  • Releases:https://github.com/DBJD-CR/astrbot_plugin_proactive_chat/releases
评论交流

文章目录