AstrBot

AstrBot是全能AI搭建工具，不用懂太多代码也能玩。它能把AI一键部署到 QQ、微信、飞书、Telegram 等各种聊天软件里，一个后台管所有平台。支持 GPT、Gemini、Llama 等几乎所有大模型，还能本地跑模型省费用。自带网页搜索、代码执行、语音识别这些实用功能，还有近千个插件随便装。界面是可视化的，设置很简单，既能当个人 AI 陪聊，也能做群里的智能客服、查资料助手，功能全、扩展性强，完全免费还能自己改，对普通人和开发者都特别友好。

AstrBot官网：https://astrbot.app/

AstrBot怎么配置

部署成功后访问 http://你的IP:6185，默认账号密码都是 astrbot。

进入「配置文件」→「默认聊天模型」，选择提供商（硅基流动、DeepSeek、OpenAI 等），填入 API Key。如果想本地跑模型，也可以接 Ollama。

AstrBot 本身只处理逻辑，需要通过 NapCat/Lagrange 等协议端实际连接 QQ：

AstrBot 侧：管理面板 → 机器人 → 添加 → 选择 aiocqhttp → 反向 WebSocket 主机填 0.0.0.0，端口填 6199

NapCat 侧：访问 NapCat 的 WebUI（默认 6099 端口）→ 网络配置 → 新建 WebSocket 客户端 → URL 填 ws://astrbot:6199/ws（如果是 Docker 部署用容器名，本地部署用 localhost）

看到 AstrBot 日志出现 aiocqhttp 适配器已连接 的蓝色提示，才算真正联通。

AstrBot怎么安装插件

进入「插件」→「插件市场」，搜索安装插件（如联网搜索、代码执行、天气查询）。

安装后在「已安装插件」中开启，配置参数（如搜索 API Key），重启机器人生效。

常用插件：联网搜索（解决大模型时效性问题）、代码执行（运行 Python/JS 代码）、知识库（导入本地文档）。

AstrBot怎么部署本地模型

安装 Ollama，下载本地模型（如 llama3）。

AstrBot 中新增「Ollama」供应商，填写本地地址（http://localhost:11434），选择模型，测试连接。

切换默认模型为本地 Ollama，实现离线使用、零 API 费用。

AstrBot常见问题

机器人不回复：检查平台连接状态（是否在线）、模型 API Key 是否正确、网络是否通畅。

模型调用失败：核对 API Key 与中转地址，测试连接，更换回退模型。

插件不生效：重启机器人，检查插件配置参数，更新插件版本。

端口占用：修改 WebUI 端口（设置→通用→端口），放行防火墙 / 安全组端口（6185、11451 等）。