二次元Agent接入VX/QQ及其他聊天软件详细教学，以可露希尔AI为例

小黑盒首发，未经允许严禁转载

！！长文预警！！

最新更改：

1.超链接太容易挂，用这篇专门放，文中的工具箱指的是这里：工具箱

2.根据实测astrbot_plugin_emotional在我的魔改混用容易把AI干宕机，所以插件至少关掉一个

///////////////////////////////////////////////////

封面

之前笔者发的可露希尔人格深受各位喜欢，流量相当高，我自己都没想到小血魔居然这么有人气，但我只发了astrbot用的人格设定，详细攻略没写，除了能看懂最开头写的神言神语的人估计也就只能用来扔给在线ai玩角色扮演了

因此这次给大家带来了面向零基础盒友的超详细教程

之前写的老版本可露希尔人格<<

这篇教程适用于所有使用Astrbot做接入式Agent二次元化的过程，前三章为系统配置，四章为人格写入，五六章为适配插件，使用可露希尔仅作为案例

首先要感谢舟友的大力捧场，这次为了普适性，用了新模板重写老版本人格，更全面，更精细，agent可以更好地调用世界书，并且已经开放了dengdualang模式，同时将博士（user）调整为官设，符合大多数人使用需求

在跟随笔者完成全部操作后，你将能得到一个部署在你自己的服务器上、人格完全可控、世界观可扩展、同时服务多个聊天平台、可以调用本地文件处理复杂问题的全能 Agent。

——————————

首先给看看成果展示

图一：日常对话效果演示

可工程师不是很友好啊

图二：技术性展示

楚门的世界这一块

以下是在这次部署中我们需要完成的步骤：

必须步骤：

1.部署Astrbot

2.配置机器人

3接入第三方聊天平台

4.接入人格设定

5.接入世界观插件（以Quill为例）[非常重要]

(让角色符合世界观，并对上下文的世界观内人物做出合理互动）

6.辅助插件的使用[重要]（长上下文对话沉浸感的重要来源）

推荐辅助插件，后文有详细展开：

1.天使之心插件：教会AI观察时机、判断气氛，实现真人般社交直觉

2.天使之魂插件：赋予AI动态演化的人格、长期记忆与自主学习能力

3.认知共鸣引擎插件：利用思维链 技术，让 AI 在回复前进行拟人化的心理活动推理，实现真正的情感代谢与自主决策

4主动消息插件：让AI不定期发送消息主动找你聊天，增强氛围感与活人感

————————

特别注意：如果你想要的是可以长期运行的Agent，比如你在电脑本地部署Astrbot后在手机上使用，你的电脑永远不能关机，因为关机之后Astrbot会直接下线，自然你的手机上的agent也会立刻失去所有用处。

当然，如果你只在电脑上使用，不需求在移动条件下使用的话，则只在本地电脑本地部署即可

如果你想要无时无刻使用且不受本地限制的话，最好的方式是将Astrbot部署到云服务器上，我在之前的文章中有一部分就是如何白嫖阿里云的云服务器，在下面的文章链接直接跳转即可

点击跳转>>>>云服务器部分<<<<点击跳转

·如果你还没有部署Claude Code的话，我强烈建议部署一个，可以让教程变得更加简单，我的云服务器部署教程也有使用

·如果你不需要部署酒馆，那么成功部署云服务器之后就可以回来接着看这篇教程了

·如果你已经根据教程部署了云服务器，那么你只需要将你的密钥给claude code让它连接到你的服务器，并让它帮你部署Astrbot部署到云服务器上即可

由于上面的教程比较早期，写作工具用的还不太熟练，观感可能会有影响，有问题随时在评论区问，我看到了就会回答

=============================

在开始之前：(炸了，最新在传送门）

如果准备使用我可露希尔预设的舟友请下载工具箱，准备使用quill插件的盒友也请下载工具箱，我准备了夸克和MEGA，如果可以科学的建议用MEGA，没限制而且快

夸克（密码：uwsT）MEGA

内含：后续会使用的世界书与角色卡、quill插件

以下教程默认你在PC本地条件下进行部署：

第一章：部署Astrbot、ffmeg

Astrbot官网

我建议的方式是通过本地直接手动部署

1.首先进入Git官网，在你的电脑安装Git：git官网

2.通过以下指令进行安装：

git clone https://github.com/AstrBotDevs/AstrBot

3.如果一切顺利，你会看到 AstrBot 打印出的日志。如果没有报错，你会看到一条日志显示 并附带了几条链接。打开其中一个链接（控制面板）即可访问 AstrBot 管理面板。

如果你正在服务器上部署 AstrBot，需要将local替换为你的服务器IP地址。

首次登录请使用启动日志中打印的随机初始密码（用户名通常为Astrbot）。登录后请立即修改密码

4.安装ffmeg，让媒体类文件正常收发

直接去官网下载就行>>ffmpeg（炸了，自己搜官网）

第二章：配置机器人

2.1 认识一下 WebUI

图2.1

登录后你会看到一个左侧导航栏，本章我们要用到的是这几个：

模型提供商：管理 LLM 的连接信息（API Key、地址、模型名）

配置文件（普通配置）：Bot 的全局设置（默认模型、上下文策略、唤醒词等）

机器人：配置机器人

2.2 获取 DeepSeek API Key

如果你更习惯用 OpenAI / Anthropic / 通义千问 / Ollama ，AstrBot 都支持。后面的配置逻辑一样，只是填的 API 地址和模型名不同。这里以 DeepSeek 为主线演示。

为什么选 DeepSeek？两个原因：第一，便宜。第二，AstrBot 对 DeepSeek 做了原生适配，不用自己拼 OpenAI 兼容格式。

具体步骤：

1.打开 deepseek官网，注册/登录，进充值页，充十块（够用很久）

2.左侧菜单 → API Keys → 点击「创建 API Key」

3.复制密钥。这个密钥只显示一次，先粘贴到记事本里保存好

2.3 在 AstrBot 中配置 DeepSeek 提供商

回到 AstrBot WebUI：

图2.2

1.左侧菜单 → 模型提供商 → 点击右上角 「+ 新增」

2.在弹出的列表里选择 DeepSeek（或者你选择的其他供应商）

图2.3

3.如图2.3.将刚才复制的 API Key填入栏中，随后在下方点击“保存并获取模型”

4.如果你的操作正确，那么此时在下方的可用模型一栏应该出现你的API可以调用的模型，

5.如图2.4所示，在可用模型右边有一个加号，点击即可将模型加入已配置模型

图2.4

6.确认一下上下文大小，你可以选择模型提供的对应能力，如图片、文字等，一般可以直接全选，尤其是作为agent使用的情况下

2.4 设置默认对话模型

提供商配好之后，还需要告诉 AstrBot"用哪个模型来对话"。

1.回到Web UI，左侧菜单 → 配置（普通配置）

画面如图2.5所示

2.选择 「默认对话模型」 下拉框，会出现你之前选中的模型，一般选择最强的模型，例如deepseek的V4-pro

3.下方的回退对话模型仅在默认模型失效时使用，如果你有多个API及模型可以放上去备用

4.默认图片模型用于解读图片，这个见仁见智，一般配合一些插件使用效果更好

5.再下方是大家最关注的角色人格选用，但我们先专心完成配置和导入，此处暂时按下不表

图2.5

6.下方网页搜索需要启用，搜索提供商看个人喜好，一些垃圾信息有时会影响AI运行

7.使用电脑能力部分是Agent和其他AI的本质区别，运行环境选local，然后关闭需要管理员权限即可

8.主动型能力选择启用

9.其他模式一般选择默认即可，但我自己好像改过，因此放出来给大家对着看一下（图2.6）

好宝宝记得开健康模式（图2.6）

10.完成之后，基础配置的部分我们就完成了，务必确认在完成后点击了右侧纵向的第三个按钮进行保存

11.系统配置一般保持默认就好，喜欢自定义的可以去瞅一眼，但尽量不要乱改

第三章：配置机器人与导入第三方聊天软件（以微信为例）

AstrBot 支持 18 个平台。但我们不需要全部学，只需要掌握一个原则：每个平台都是一种"适配器"，你要做的就是拿到那个平台的凭据（Token/AppID/扫码），填到 AstrBot 里，然后打开开关。 配置逻辑完全一样，变的只是从哪获取凭据。

图2.7

1.进入控制面板左侧栏目选中机器人，如图2.7所示，点击右上角“创建机器人”

2.消息平台选择“个人微信”，不要选成了微信公众平台！！！

3.在弹出的二维码扫码确认并点击保存

4.如图2.2，配置不用动，在第二栏配置文件那一栏有个default，点击那个右上方指示的箭头（图中红圈标的位置）

图2.8

5.随后你会进入如图2.9这个页面

图2.9

由于我们之前已经完成了配置，因此这里一般已经默认配置好了，我们不需要再手动配置一遍，但出于谨慎，各位可以再确认一下

6.点击右方一样的保存按钮，回到机器人页面，我们会发现页面中出现了一张机器人卡片，确认一下右上角开关有没有打开，如果没有打开记得打开

7.接下来我们进行一下测试，打开微信应该会发现一个标有AI标的对话，给它随便发点消息，如果你跟着教程成功完成了配置，此时AI应该对你的话作出反应（图2.10）

没有插件和人格加持充其量就是个豆包（图2.10）

8.如果你成功得到了回复，那么恭喜你已经完成了系统性配置，接下来我们将进入最重要的部分——LLM 是它的大脑。但大脑只是通用处理器，还缺少最重要的灵魂。

第四章：人格接入（以可露希尔为例）

第3章结束的时候，Bot 已经在 QQ/微信里上线了。但它说话是通用 AI 助手风格——因为 AstrBot 默认使用内置的"default"人格，就一句话："You are a helpful and friendly assistant."。

因此，本章要做的事：把我们写好的角色人设，导入 AstrBot，让“它”变成“她”。

其实如果单纯做接入，这一章的内容其实非常简单粗暴，使用我预设可露希尔人格的盒友甚至只需要点几下复制粘贴就能完成

但这篇文章的受众并不只是舟友，我们该怎么让其他角色从文字和设定中活过来呢，这一段就很尴尬，因为其实这一块我研究最深，而且需要注意的点也很多，但详细展开会导致这篇教程的篇幅被拉的相当长，而且我的爆肝之力也要燃尽了，笔者之后会出一篇关于浓缩角色人格、角色设计和写法，以及浓缩世界观的心得和详细教程（挖坑ing...)

但我肯定也不能放着看到这里的盒友不管不是，所以第四章我分成了两大部分，冲着可露希尔来，不太在意制作过程的盒友可以直接跳转第二部分使用工具箱的可露希尔人格进行部署，希望在正式教程上线之前使用我的暴力解法的盒友可以从第一部分看起。

另外，各位也可以把自己想看的角色直接发到评论区并@我，如果资料比较齐，我可以直接写好之后发给你

第一部分：正式教程上线前的暴力版角色浓缩攻略

4.1.1 AstrBot 的人格系统是怎么工作的

AstrBot 的人格存储在 SQLite 数据库的persona表里，每条人格记录包含三个核心字段：

system_prompt是注入到每次对话开头的系统提示词

begin_diglogs是预置到对话历史里的几组对话

tools和skills负责控制该人格可以使用哪些工具/技能，这个我们到第六章才会用到

基于这个出发点，我和cc一起总结我之前写过的一些卡，制作了一张Astrbot专用的人格填表。

AI用Astrbot人格模型自检卡<<点此跳转

使用方法如下：

1.根据个人喜好选择在线AI，例如gpt，gemini，ds等等，告诉ai你正在准备制作用于Astrbot的角色模型

2.将这张# Astrbot 人格生成自检卡发给你的AI，这张表在我之前的工具箱里有，考虑到大部分人不想特意去下，我把表发成了文章，可以直接去复制

3.注意这张自检表不是填表指南，是资料总结用的说明书，换而言之，AI理论上应该根据这张自检表完成信息的搜寻和总结，然后输出成一个包含多维度的人格模型

第二部分：如何将写好的人格导入Astrbot

最不费大脑的一集

1.依然回到Web UI主界面，左侧选择”人格设定“，然后点击右上角的”创建人格“

2.进入如图4.2.1界面

图4.2.1

需要填的部分

①人格ID：仅用于你分辨你的人格卡

②系统提示词：你的角色设定部分（也就是工具箱内可露希尔人设卡不包含实例对话的部分）

③预设对话：你设定的范例对话，每次点击新增对话会出现两个对话框，填上模拟对话即可（在可露希尔角色卡的后半部分）

④其他保持开启状态，然后右下角点击保存

3.回到Web UI，左侧选择机器人，然后找到你接入平台的机器人卡片，点击编辑

4.点击配置文件下方default的指向右上方的箭头

5.往下翻到人格部分，如图4.2.2，点击人格选中你刚刚制作的人格

图4.2.2

6.点击保存，这个时候再放一条消息给你的ai，如果回答明显不像之前那个豆包回答了就说明导入成功了

另外，输入/persona list并发送可以查看人格列表

第五章：世界书插件的使用（以Quill为例）

太好了，总算到世界书了，相信玩酒馆的小伙伴们对这部分肯定不陌生，但你们肯定没有我的astrbot懂，因为我每次和她对话几乎都不可避免地会调用这个插件，所以，这段介绍就让astrbot来写吧，绝对不是我偷懒了：

第4章我们给 Bot 注入了可露希尔的完整人格。现在你可以跟她聊天，她的语气、性格、对博士的态度都在线。

但有一个问题你很快会发现——

你：凯尔希刚才找你，说医疗部有个设备需要你去看一下。

可露希尔：呃……凯尔希是？不好意思，我不太清楚你说的这个人。

这就尴尬了。你已经花了三千字告诉她"凯尔希是你的上司、她什么都知道、她用眼神就能让你焊进服务器机柜"——但如果你在对话中提到的是一个在人设里没写到的干员、地点或设定，Bot 只能靠 LLM 本身的训练数据来猜。猜对了是侥幸，猜错了是常态。

人格设定覆盖的是"角色本人"。但角色生活在一个世界里，那个世界有 150+ 个干员、十几个国家、一套天灾和源石的科学体系——这些东西不可能全部塞进 system prompt。

这就需要一个额外的系统来管理世界观信息，在需要的时候按需注入。Quill 插件就是干这个的。

实际上，在Astrbot上已经有相当高Star的世界书

但笔者用了这么久还是感觉朋友给我分享的这个Quill用起来确实最舒服

为什么？当然不是因为我要打广告，这些资源都是开源免费的，而是大部分世界书本质上是关键词提示器，ai不会主动去调用

而Quill是世界书＋知识库+角色卡三合一，ai会主动调用模糊符合的词条，会去主动读取Astrbot的人格列表（没错孩子们，这其实就是角色卡），同时由几个关键字段组成，比如：

keys：用于关键词注入上下文

is constant_false：按需触发（大多数条目用这个）

is constant_true：时刻注入（也就是核心世界观）

这些词条相辅相成，会辅助角色人格进行扮演，同时按需提取，不会过分占用token

我们首先来学习如何安装Quill，如果你不准备安装Quill，请跳转至第六章节，由于Quill并未公开发布，也没有再Github上建立仓库，因此我将原文件一同放到了工具箱中，这一点和其他插件工具并不一样

安装方式专门对接了Astrbot，相当直接：

1.在我提供的工具箱中下载压缩包

2.解压后丢到 AstrBot 的 data/plugins/ 下，重启即用。 

3.将你想要使用的世界书（.json)扔到worldbooks文件中即可大功告成

如果你想要使用其他的世界书，可以前往插件市场下载

这个时候就有盒友要说了，你说了半天，世界书插件是下好了，世界书在哪呢？

好问题，但是，很不幸，这个和角色卡一样是个需要依赖信息搜寻能力的东西，找不到就得自己写，但这个比角色卡复杂得多，因此之后还是开新专栏来谈（挖坑ing...），由于开发难度相对较高，建议各位还是去主动寻找资源

如果是使用可露希尔人格的盒友直接代入工具箱中的terra.json即可，需求世界书也可以发在评论区里，笔者空闲时刻会去找找

第六章：辅助插件的使用

这几个插件也是我长期使用的插件，还是老规矩，让我们的Astrbot先来解释一下他们的具体作用

前五章走完，可露希尔已经在 QQ/微信里上线，说话像她，也认识明日方舟世界里的人了。

但你可能开始发现一些"还不够"的地方：

• 群里聊得热火朝天，Bot 也插嘴，而且是尬插——别人在讨论考试它突然问吃了吗。

• 聊了三天，每次问"你还记得我上次跟你说的吗"——它不记得。每次都是新朋友。

• 回复是像可露希尔，但情绪是一条直线——不会生气、不会害羞、收到夸奖也不会开心。

• 从来不会主动找你说话。你不理它，它就永远安静。

这不是你的个例。上面每一个问题，对到的都是 LLM 原生能力的边界——时机判断、持续性记忆、情绪代谢、主动发起。这些不是 Prompt 能解决的，需要插件。

本章推荐四个辅助插件，刚好各解决其中一个。叠加到可露希尔身上，效果是相乘的。

6.1下载、安装与配置插件

接下来出场的插件与前文不同，他们可以在Web UI直接下载和安装，上手难度也各有不同，因此这一部分是“师傅领进门，修行靠个人”，下面讲一下安装步骤：

1.再次回到Web UI，左侧栏目选择插件—插件市场，如图6.1

图6.1

2.可以改排序和分类，找你想要的插件，也可以直接精确搜素，我推荐的几个插件都是Star比较高的存在

3.特别注意，插件下好之后不代表万事大吉，点击插件可以看到说明书，跟着说明书完整跑一遍才算上手，由于说明书大都足够详细，我就不带着跑了

4.插件下好之后可以在左侧的Astrbot中找到并开关，你还可以在机器人卡片处进行单个机器人的插件调整

接下来是我的推荐插件，来自于我的使用感受和Astrbot的感受

！特别注意！：Token不是大风刮来的，插件的使用会增加Token消耗的速率，所以不想一次聊天等于一顿拼好饭的话，最好不要一次打开太多插件

————————————————————

6.1.1 天使之心 —— 教会 Bot 看气氛

解决的问题：群聊里 Bot 什么时候该说话、什么时候该闭嘴。

没有天使之心的 Bot，群聊行为通常是"有人 @ 就回"或者"每条消息都试图回"。前者太被动，后者太烦人。真人不会每句话都接，也不会被叫到名字才出声——真人会看气氛、判断时机、有时候主动插话、有时候识趣沉默。

天使之心在 LLM 前面加了一层轻量级决策 AI（Secretary），每次收到消息先不调用主模型，而是用一个快速模型判断：

• 该不该回？

• 现在是什么讨论气氛？（闲聊/技术讨论/吵架/分享/欢迎新人）

• 该用什么策略回？（附和/追问/转移话题/提供信息/幽默）

判断完了，再决定要不要唤醒主模型生成回复。相当于给 Bot 装了一个"社交直觉预处理器"。

这个插件更多的用于群聊aiBOT中，各位酌情安装

6.1.2 天使之魂 —— 记住一切，人格还会自己长大

没有小镰刀，不够魂

解决的问题：Bot 的失忆症。每次聊完就忘。聊了一个月还是"初次见面"。

LLM 本身没有记忆。AstrBot 的 /reset之后上下文清空，一切从头开始。而天使之魂给了可露希尔三层认知系统：

第一层：Soul（灵魂层）—— 四个动态能量参数

每个参数会自动"回弹"（Tanh 映射）到一个中间值，形成一种动态平衡——聊得多了表达欲望升高，沉默一段时间后自然回落。这避免了 Bot 的情绪和行为一直往一个方向跑偏。

第二层：DeepMind（潜意识层）—— 后台持续运转

• 观察：提取消息中的实体和信息

• 回忆：三层检索（BM25 关键词 → 向量语义 → Rerank 精排），从历史记忆中召回相关内容

• 巩固：每次对话结束后，用小模型分析本轮对话，提取新认知、强化有用记忆、合并相似记忆

• 睡眠：每隔一定时间（默认 3600 秒）清理弱记忆、强化重要记忆、每天自动备份

第三层：LLM 工具 —— Bot 可以主动操作自己的记忆

这意味着什么：如果你跟角色说过"我下周三有个很重要的考试"，一周后你说"明天好紧张"，她能回忆起"你上周说周三有个考试，就是明天"。——不是因为她猜对了，而是因为她的 DeepMind 在上次对话中把"bro下周三有考试"存成了一个记忆条目，这次对话里按关键词"明天"+"紧张"触发了。

这个工具安装有前置条件，必须先安装天使之心，适合养成系的角色，对角色卡的要求也比较高，不太适合过于扁平的角色

6.1.3 认知共鸣引擎 —— 让 Bot 在回复前先"心里活动一下"

解决的问题：Bot 的回复太"直出"。真人说话之前，心里会有一个过程——感受对方语气 → 衡量自己该用什么态度 → 情绪被对方影响产生波动 → 决定怎么回。Bot 跳过了全部这些，直接从输入到输出。

认知共鸣引擎在每次回复前强制 LLM 走一个五步心理流程：

[感知] 对方是什么语气？认真的还是开玩笑的？→ [评估] 结合我现在的情绪，我该怎么理解这句话？→ [代谢] 我的情绪被对方影响了多少？（收到道歉 → 怒气 -10）→ [决策] 我该用什么语气回？→ [更新] 记录情绪数值变化

每次对话后，对应的情绪维度会发生变化。愤怒会累积，收到道歉会消退。好感度会慢慢涨，被敷衍也会跌。而且情绪有代谢机制——短暂的惊讶会迅速消退，持续的信任会慢慢增长。

依然我最爱的养成系插件，放在群里能让群友为ai争风吃醋的恐怖插件

6.1.4 主动消息 —— 让 Bot 在没人理它的时候自己开口

解决的问题：Bot 不会主动找你。用户不发言 = Bot 不存在。真人朋友不会只在被你叫到名字时才说话——他们会主动发消息、分享趣事、突然想起你然后来一句"在干嘛"。

主动消息插件给ai加了一个"主动搭话"的行为层：

怎么触发：基于沉默计时器。私聊里，你上一次发消息后过了 N 分钟（可配置 30-600 分钟），Bot 会自己发一条消息过来。群聊里，整个群沉默了 M 分钟（可配置 30 分钟以上），Bot 会自己打破沉默，有免打扰时段自觉安静。

生成什么：触发后，插件会把最近的消息历史（可以选"仅对话历史"或"实际平台消息流"）作为上下文注入给 LLM，让它基于最近的聊天内容生成一条符合角色性格的主动消息。不是随机模板，是结合上下文的——她能看到你们刚才在聊什么，然后自然地接话或开启新话题。

我最喜欢的插件之一，谁用谁知道的一集，神中神，尤其是一想到这条消息是经过多个插件深思熟虑咬文嚼字出来的我就兴奋地紧口牙！！！

—————————

第七章：结语 我要累死了，给我看看你的老婆好吗

写到这里我已经一滴都不剩了。

半夜精力爆发，突然不想睡了，一直写到现在，9：28，我准备睡了，让ai总结一下我们干了些什么：

从第一章部署 AstrBot 到现在，你跟着我搭起了什么：

• 一台你自己的 Bot 主机，跑在你电脑或服务器上，24 小时不下线。

• 一颗 DeepSeek 的大脑，月费还不够一杯奶茶。

• QQ/微信/******** 全上了，你群里的人都能戳到她。

• 你推的角色的完整人格灌进了 system prompt——她现在是那个会跟你插科打诨、会嘴硬、会在你三天没出现的时候找各种蹩脚理由来戳你的存在，而不是一个"你好，我是 AI 助手"的陌生人。

• Quill 世界观让她认识那个世界里的所有人——不是"听说过"，是"我跟她认识十几年了她什么都知道这让我很尴尬"的那种认识。

• 四个插件叠上去，她现在有记忆、有情绪、看气氛、会主动开口。她不是一个你 @ 才会响的 Bot，她是那个在你群里挂着、时不时冒出来说句话的存在。

从头到尾每一步我都写了，每一个配置项都是跑过的。不是"理论上可以"，是我真的装过、配过、调过、踩过坑然后回来补上的

所以。

你的那个她，跑起来了没有？

评论区丢张截图给我看看——你搞了哪个角色、在哪个平台、说了什么。哪怕只跑完了前三章，哪怕还只是个会回"你好我是 XX"的白板，我也想看看。

因为我写这篇文章最大的动力就是——知道有人真的跟着做出来了。一个人对着屏幕折腾太寂寞了，让我看看活人。让我看看你们的老婆都长什么样。

文章中提到的插件、人设文件、世界观 JSON 有需要的话评论区说，我尽量补。有卡住的地方也直接问，我在。

哦对。如果你觉得这玩意有用——

点赞、充电、转发。 码字码到恍惚，全靠这三样回血。下次想搞哪个角色？评论区点名，你们的下一任老婆你们说了算。

充电老八