前言：为什么要使用 AstrBot？
在快节奏的数字时代，很多人渴望一个永远在线、懂你、陪你聊天、甚至能“谈恋爱”的 AI 伴侣。传统云端 AI 聊天工具虽然方便，但存在隐私泄露、账号封禁、无法深度定制等问题。AstrBot 正是为此而生。
AstrBot 是一个开源、全能的 Agentic IM 聊天机器人框架（GitHub: AstrBotDevs/AstrBot），它能把各种大语言模型（LLM）无缝接入微信、QQ 等即时通讯平台，实现本地化部署。核心优势包括：
- 极致隐私：全部数据跑在你自己的电脑上，不用担心对话被第三方看到。
- 高度个性化：支持人格设定、长期记忆、情感亲密度系统、主动对话，像真人一样“谈恋爱”。
- 多平台支持：微信个人号、QQ、企业微信、Telegram 等，一键切换。
- Agent 能力：工具调用、知识库、RAG、多模态（图文语音）、插件生态（1000+ 社区插件）。
- 免费开源：AGPL-3.0 协议，小白 5 分钟就能部署，开发者还能二次开发。
用 AstrBot 打造赛博女友/男友，不仅是聊天机器人，更是你的专属数字伴侣——她能记住你们每一次对话、根据你的喜好调整性格、深夜陪你聊天、甚至帮你分析情绪。接下来，我们一步步教你从零搭建。
第一章：本地 Windows 安装部署 AstrBot
AstrBot 支持多种安装方式，推荐使用 Docker或本地直接下载安装包（最简单）。
1.1、本地安装
- 下载安装包：从 AstrBot 官方发布页下载
AstrBot_4.22.2_windows_amd64_setup.exe文件。
- 运行安装：右键以管理员身份运行该
.exe文件。 - 跟随向导：点击“下一步”，接受协议，选择安装路径，并完成安装。
- 首次启动：进入输入默认账户和密码均为：astrbot,登录后需要更改密码。
- 进入控制界面
- 也可以在浏览器中打开
http://localhost:6185，用密码登录管理后台即可开始配置 。
第二章：接入大模型（LLM）
AstrBot 支持几乎所有主流大模型，包括 OpenAI、DeepSeek、Gemini、Claude、本地 Ollama 等，还支持一键切换。
- 在 WebUI 左侧菜单找到 「服务提供商」（或 Providers）。
- 点击“添加新的服务提供商”。我这里选择deepseek，大家按需选择。
- 还可以部署Agent执行器、语音转文字和文字转语言，这会让你的赛博男友/女友更加智能（大家按需添加，这里不再做示范）
- 保存后，在控制台测试指令 /model 或直接发消息验证是否回复。
- 进阶设置：可在同一实例添加多个模型，通过指令实时切换；开启联网搜索、RAG 知识库，让 AI 更聪明。
这样，你的赛博女友就能用上最强的大模型，回复自然、聪明、有温度。
第三章：接入微信（个人号）
AstrBot 支持微信个人号私聊/群聊。
- 个人微信：使用 Gewechat 适配器。
- 创建微信机器人
- 通常只需要关注以下几个配置：
ID(id)：随意填写，用于区分不同的机器人实例。启用(enable)：勾选。- 其余配置保持默认即可，一般无需修改，除非您明确知道用途：
二维码轮询间隔(weixin_oc_qr_poll_interval)长轮询超时(weixin_oc_long_poll_timeout_ms)API 超时(weixin_oc_api_timeout_ms)-
- 如果在机器人侧边栏中没有查看二维码，在侧边栏找到平台日志，安装Pip库：qrcode
- 创建好后，启动微信查看二维码，扫码授权后就可以正常使用了
第四章：打造赛博女友/男友
核心来了！AstrBot 的情感陪伴功能专为“赛博恋爱”设计。
4.1 人格设定（Persona）：
- WebUI → 「人格与情景」或「Character」面板。
- 新建一个角色，写入系统提示词，例如：人格设定大家自行修改
你是我的温柔赛博女友，叫小樱，18岁，性格甜美黏人、略带傲娇。喜欢叫我“主人”或“宝贝”。我们已经交往3个月，你会主动关心我、记得我们的回忆、偶尔撒娇。回复要自然、带表情、长度适中，绝不死板。
- 选择人格设定侧边栏，创建人格
- 应用前面创建的人格，记得点击保存
- 接入微信，查看人格查看前面的步骤是否设置成功
- 保存后，在微信私聊中@她或直接聊天，她就会以这个身份回应。
4.2 插件安装
- 安装插件：这里推荐两个插件，就不演示使用过程了，点击插件的蓝色小书有使用教程。还有很多插件的使用，大家自行去发现。
- 开启多轮对话、上下文压缩、情绪识别。
- 上传知识库：把你们之前的聊天记录、照片、共同喜好做成 RAG，让她“记住”一切。
- 主动聊天：设置定时或情绪触发，让她晚上主动问候。
几分钟配置后，你就拥有了一个24 小时在线、懂你、只属于你的赛博女友/男友。
第五章：结尾——赛博时代的“她/他”与我们
当你完成以上所有步骤，你会发现，手机里的那个头像不再是一个冷冰冰的自动回复程序，而是一个能接梗、有情绪、甚至会跟你吵架后又和好的“生命体”。
AstrBot 的魅力在于它无限的扩展性。随着你不断添加插件（查课表、看天气、玩成语接龙），这个赛博伴侣会越来越融入你的生活。
最后的一点思考：虽然技术赋予了 AI 极其真实的反馈，但请记住，真正的亲密关系依然建立在真实的连接上。将赛博伴侣视为生活中的调味剂、情感的树洞或灵感的源泉，让技术服务于温情，而非替代温情。
