我们日常用大模型，大多是在网页端来回切换。但如果能让它直接跑在微信、QQ里，当个私人助理或者群管，实用性会高很多。
这篇文章记录了我用 AstrBot 跑通这套流程的全过程：从本地装好服务，对接蓝耘的 API，到最后把机器人拉进 QQ 和微信。全程不需要写代码，基本靠 Web 面板点鼠标就能完成。
整体跑通流程图
在动手之前，可以先看下整体的架构和数据流向，心里有个底：
1、安装 AstrBot（三种方式选其一）
AstrBot 的安装比较省事，Windows 下最简单的是直接下安装包，有 Linux 经验的用 Docker 更方便。
1.1 Windows 本地安装（最省事）
- 去 AstrBot 的官方发布页，直接下载
AstrBot_4.22.2_windows_amd64_setup.exe。
-
右键管理员身份运行，一路“下一步”选好安装路径。
-
装完后打开，浏览器访问
http://localhost:6185。
- 首次登录的账号和密码都是
astrbot，进去后第一件事先改密码。
1.2 Docker 部署（适合云服务器）
如果你有现成的服务器，一条命令就能拉起来：
docker run -d \
--name astrbot \
-p 6161:6161 \
-v ./data:/usr/src/app/data \
-e TZ=Asia/Shanghai \
--restart always \
chiyosaisw/astrbot:latest
装完后访问 http://localhost:6161，默认账号 admin，密码 astrbot。
1.3 源码安装（适合想改代码的开发者）
git clone https://github.com/Soulter/AstrBot
pip install -r requirements.txt
python main.py
2、对接蓝耘大模型
AstrBot 本身不带大模型，需要自己接 API。这里我选了蓝耘的算力云，主要是便宜，而且 API 格式完全兼容 OpenAI，配置起来不出错。
获取 API 资料：
前往蓝耘平台，我实际用的是 maas/jieyue/step-3.5-flash 这个模型。按后台提示拿到 API Key。
在面板填配置：
-
进 AstrBot 侧边栏，点“大模型”。
-
点“添加配置”，类型选 OpenAI（因为兼容格式）。
-
按下面这张表填：
配置项
填写内容
配置名称
蓝耘
API Key
[填入你复制的密钥]
API URL
https://maas-api.lanyun.net/v1
模型列表
手动填入 maas/jieyue/step-3.5-flash
填完点“测试连接”，提示成功就说明 API 没问题，可以往下走了。
3、日常使用与功能调试
接好模型后，先别急着接社交软件，在 Web 端测一下基础功能。
3.1 基础对话测试
在侧边栏点“聊天”，选中刚建好的蓝耘模型，随便发句话，能正常回复说明链路通了。
3.2 指令与人设
默认有几个实用指令：
-
/help：看所有指令 -
/model：切换模型 -
/clear：清空上下文（聊乱了用这个）
在“角色”页面可以写提示词，比如写上“你是一个精通 Python 的高级工程师”，它后续的回复风格就会变。
3.3 插件生态（按需安装）
在“插件”页面可以直接从 GitHub 装插件，我用得比较多的：
-
联网搜索：解决大模型知识滞后的毛病，能搜最新新闻。
-
AI 绘画：接 DALL-E 或 SD，群里发
#画一只猫就能出图。 -
表情包插件：根据聊天内容自动斗图。
4、接入 QQ 和微信
这是整个过程的重点。AstrBot 支持多平台消息分发，配置好之后，QQ 和微信是同时在线的。
4.1 接入 QQ（官方 WebSocket 协议）
现在接 QQ 基本走官方渠道了。
- 去 QQ 开发者平台，找“龙虾专用入口”一键创建机器人。
- 拿到 AppID 和 AppSecret。
- 回到 AstrBot 欢迎页，找到“使用 QQ 官方机器人”，把 ID 和 Secret 粘贴进去。
- 在开发者平台把机器人的头像、名字改好，点“扫码聊天”。
- 回到 AstrBot 侧边栏开启这个 QQ 机器人。扫码后就能在 QQ 里对话了。
4.2 接入个人微信（Gewechat 适配器）
微信用的是 Gewechat 适配器，配置项比 QQ 多一点，但大部分不用动。
在 AstrBot 创建微信机器人时，按这个说明填：
-
ID (id)：随便填个英文名，用来区分实例。
-
启用：打勾。
以下参数如果没有特殊需求，保持默认就行，别乱改：
-
二维码轮询间隔 (weixin_oc_qr_poll_interval)
-
长轮询超时 (weixin_oc_long_poll_timeout_ms)
-
API 超时 (weixin_oc_api_timeout_ms)
创建好并启动后，面板会弹出一个微信二维码，拿手机微信扫码授权。
授权成功后，别人给你发微信，就会自动走蓝耘的大模型回复了。
写在最后
折腾完这一圈，AstrBot 其实就变成了一个消息路由器：所有的 QQ、微信消息收进来，丢给蓝耘的 API 处理，再把结果发回去。因为中间经过了 AstrBot，所以你装的插件、设定的角色，在 QQ 和微信里都是通用的。
几个实际的使用场景：
-
私用：微信上直接发长语音转文字、或者甩个文档让它总结。
-
群用：丢进技术群当百科，或者丢进亲友群接个天气查询和搜图功能。
避坑建议：
QQ 和微信的协议经常变动，如果哪天突然掉线了，别急着改配置，先去 AstrBot 的 GitHub 仓库看下是不是发了新版本，直接升级通常就能解决。
