Loading...

文章背景图

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

2026-10-29
243
- 字
- 分钟
|

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+
全家桶方案 大肥鱼人格核心 acceleratorcxy/astrbot_plugin_dafeiyu_core 把主人识别、群聊唤醒、人味化、联网搜索、表情包、睡眠、群档案、费用统计、自动备份打包成一个插件 MIT AstrBot ≥ 4.16,Python 3.10+

以上七个插件均为社区开发者作品,并非 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 官方链接

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 官方链接

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 官方链接

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 官方链接

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 官方链接

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://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 整合方案:大肥鱼人格核心(全家桶)

9.1 它是什么

把"人格机器人"做完整的一套 AstrBot 插件。它原本是四个独立插件(owner / group_wake / humanizer / interest)拼起来的,后来合并成一个包,把主人识别、兴趣机制、群聊唤醒与续聊、人味化输出、联网搜索、睡眠模式、上下文压缩、全量资料备份、费用统计、群档案知识库全部收在一个插件、一套配置、一个页面里。配套的还有社区二创形象"大肥鱼"(DeepSeek 蓝鲸 logo 的同人形象)的完整人格与部署全家桶。

9.2 官方链接

9.3 核心能力

模块 做什么
主人识别 认主人、认听令范围,别人下的指令不乱听;每轮标注说话人身份
群聊唤醒 关键词唤醒、随机搭话、被叫到才回、续聊、群里热闹时提高主动概率
人味化 去 AI 口吻、拆句、控制配图频率,说话更像真人
兴趣机制 兴趣库 + 临时话题观察,聊得多才升级成兴趣,久不聊自动清理
联网搜索 不知道的实时信息自己查(DeepSeek Search/Fetch,百度兜底)
表情包 接 meme_manager 图包,按语境主动发表情包
发言记录 记住群里最近谁说了什么,答复时能分清人和上下文
群档案 每晚自动总结每个群的群友昵称、黑话梗、近期话题成知识库,聊天时自动调用
费用统计 按会话统计 token 与费用,支持峰谷计价
睡眠模式 凌晨只记不回,早上随机醒来补回夜间消息
上下文守护 私聊快满提醒后压缩,群聊按余量/静默/每日自动压缩
全量备份 每晚睡眠时间备份人格/兴趣/会话/发言记录/表情包清单,只留最新 3 份
插件页面 6 个标签页:总览、命令、兴趣、备份、配置、上下文

9.4 安装

  1. 把仓库里的 astrbot_plugin_dafeiyu_core/ 整个目录复制到 data/plugins/astrbot_plugin_dafeiyu_core/。
  2. 容器部署时修权限并清缓存:
    chmod -R a+rX data/plugins/astrbot_plugin_dafeiyu_core
    rm -rf data/plugins/astrbot_plugin_dafeiyu_core/__pycache__
  3. 在 AstrBot 面板重载插件。
  4. 打开插件详情页的 View 标签,填写 master_ids(你的 QQ 号)、master_name,以及各功能段的 bot_filter。

9.5 常用命令

命令 说明
/帮助 命令清单
/触发 <动作> 让机器人执行报告/压缩/上下文/费用/备份/兴趣/搜索/发图等
/主人 看当前会话的说话人身份
/兴趣 看|加|删|搜|记|整理 兴趣库管理
/上下文 /压缩 查看上下文用量或手动压缩
/报告 /费用 [N] 整理报告 / 费用账单
/备份 现在|列表|恢复|删除 全量资料备份管理
/睡眠 睡|醒 睡眠状态 / 手动睡下 / 叫醒

指令默认只认主人,并且只在配置里指定的机器人上生效。

9.6 可选依赖

  • meme_manager 插件:想要主动发表情包时安装,并准备图包。
  • DeepSeek API Key 或百度 AI 搜索 Key:想要联网搜索时配置。
  • QQ 官方机器人(支持 markdown 汇报)或 OneBot / aiocqhttp(个人号)。

10 组合使用建议

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

  1. 记忆底座:先装 LivingMemory,让 Bot 有长期记忆。
  2. 学习能力:再装 Self-Learning,让 Bot 学会群里的说话风格和黑话。
  3. 回复时机:装 Chat Plus 控制 Bot 什么时候开口(注意关掉官方主动回复)。
  4. 主动发起:装 Proactive Chat,让 Bot 在合适的时候主动找人说话。
  5. 信息能力:装 Anysearch,让 Bot 能联网查最新资料。
  6. 氛围加成:装表情包管理器,让 Bot 在合适的语境蹦一张图。
  7. 人格整合:装大肥鱼人格核心,把主人识别、睡眠模式、群档案、费用统计、自动备份等"养号"能力一次性收拢到一个面板里;它同时会调用上面的表情包和联网搜索能力。

如果你不想逐个插件拼装,大肥鱼人格核心本身就是一个"全家桶"——它已经内置了主人识别、群聊唤醒、人味化输出、联网搜索、表情包调用、睡眠模式和群档案,装这一个就能覆盖上面 1、3、5、6 号插件的大部分日常能力,再按需补 LivingMemory 做长期记忆即可。

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

11 风险与合规说明

  • 七个插件均为社区开发者作品,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 服务变更导致的任何损失,由部署者自行承担。
评论交流

文章目录