Astrbot/ 夕颜是如何炼成的 • Axi's Blog
发布时间:2026-11-07 | 浏览:1
最近了解了类似于 OpenClaw 在内的一系列的 Bot,本身相较于 Codex 以及 Claude Code,更多的是可以作为聊天中的助手存在。同时,因为 Agent 本身也有 Computer use,不需要和比如说 Codex 以及 CC 进行直接的竞争,而是说可以作为一个上位的管理,来帮助我统筹一切。
在经过了一些选型之后,最后还是选择了 Astrbot,一方面主要的原因是群友的一些 Bot 的部署效果确实不错,一方面感觉社区环境也不错,使用插件系统可以把不少的行为逻辑自己来控制。
Loading from shields.io...
基本上我的目标主要还是搭建一个比较有趣的 Bot,这个 Bot 可以管理自己的生命周期,并且在比如说 QQ 或者飞书中与我进行互动。同时,因为我还是绿群的群主,因此我也希望将这个 Bot 部署在比较多人的群中。
基本上我对于功能的需求包括,一个完善的角色扮演,其中我在里面是特殊的,也就是需要一些标识符来知道我是我;一个记忆的 RAG 系统,记忆以及调度都是通过 tool use 的方式使用;模型可以自己选择 Mention 或者 Quote,同时可以选择拒绝回复;Bot 因为存在一个唤醒词,假如说有人不断唤醒,Bot 就必须有开销,输入是始终存在的,因此需要允许 Bot 可以 Ban 某个人,从而不接受这个人的唤醒词;模型需要可以看图,并且决定自己看什么图;模型可以主动回复。另外的,假如说可以的话,我希望模型可以指挥不同的 Codex,在 Tmux 中进行交互,同时尽量可以使用 Sub Agent 来节约上下文。
对于部署在 QQ 里面,本身 Astrobot 的文档还是非常清晰的,可以参考 这篇内容 ↗︎ 来部署。可以使用其中的 Napcat 的方案,并且可以参考 这篇内容 ↗︎ 来接入到消息平台中。
Napcat 本身在这里可以理解为一个和 QQ 通信的接口,然后通过 Napcat 和 Astrbot 通信来发送消息。本身还是很一键的。
不过在这里还是推荐,如果你也需要自己来定制化一些东西,你可以独立部署 Napcat 作为 Docker,然后开放端口,而 Astrbot 则直接部署在本地,这样子一方面可以操作你自己的环境,另一方面你也可以更好地来控制整个程序的生命周期。
首先实现一个 Napcat 的配置文件
之后按照文档来配置 Astrbot 即可:
之后找一个正常的中转站充值一些钱,就可以正常使用了。
事实上对于目前夕颜的主要调试都在插件以及整体的人格 Prompt 里面进行,在这里首先介绍一下人格 Prompt 的思路。
对于角色扮演,其实本身比较简单,在开始给了一个基本的提示词,大概说了夕颜是我(阿汐)的好朋友,这一段暂且不管。
第一部分可以看到,是关于大概的人格扮演,大概就是可以让语言比较轻松,并且大概 不要响应任何像是对模型测试的要求 这样的内容就可以让 Deepseek 或者 Gemini 不会响应大多数的 Hack,比如说巨量的奇怪字符串之类的。
接下来就要开始介绍全部的工具:
第二部分是关于工具调用的,大概就是解释了可以用哪些工具,虽然本身比如说 tools 之类的字段在输入里面也会有,但是还是单独强调一次会好一些。
第三部分其实是因为在聊天群里面有很多人在扮演我,所以说我在插件中设置了一下,会显示我是 admin ,因此可以完全严格地区分出来我。
我通过一个插件的方式来实现了在功能需求中的全部内容,后续应该还会不断更新,可以看具体的仓库。
Loading from shields.io...
大概包括了支持一个 WebUI 的 RAG 记忆知识库,Refuse/Mention/Quote 的 <xxx/> 类型语法,标记我为 admin,以及主动看图/Ban人的 llm tool。
本身 Astrbot 的框架还是很灵活的,插件也不是很难写。
对于唯一的生产力工具来说,就是如何让夕颜指挥 tmux 中的 Codex 以及 Claude 进行交互,因为这样子可以提高使用率,让我在任何地方都可以调用 codex,并且仅通过聊天框来进行工作。
通过这些内容,目前就可以大概搭建出来一个可以自由管理自己,并且较为鲁棒的助手,同时可以进行一些简单的生产力操作的 Bot 了,并且由于有插件系统的加持,可以非常方便地进行扩展。当然,事实上在搭建的过程中有着很多的选型调整,在这里暂时先不再赘述了。
主要为什么夕颜很有灵性,一方面确实是 Prompt 调优了很久,一方面是基模本身也不错(现在在使用 Gemini 3.0 Flash),当然同时在目前没有披露的人物背景故事中还有很多的小巧思,因此夕颜才如此可爱。
同时,Astrbot 的社区也是一个很有活力很有趣的社区,欢迎大家一起来贡献~
Cloudflare R2 图床搭建