AstrBot 介绍与部署教程：打造你的专属 AI 机器人

什么是 AstrBot？

AstrBot 是一个跨平台的 AI 助手框架，能帮你在自己的电脑上搭建一个智能机器人。把它接入 QQ 后，你就可以和 AI 聊天、让它帮你做事。

简单来说，它就像一个”桥梁”——把 AI 的能力接到你每天用的聊天软件里。

我这次主要关注 Windows 桌面版的部署路径，因为它对本地环境要求更少，适合先把机器人跑起来再慢慢研究插件和长期托管。

为什么选择 AstrBot？

1. 支持多个聊天平台

它可以接入这些平台：

QQ：最常用，本文会详细教
企业微信：工作场景
飞书：团队协作
Telegram：国外聊天软件
Discord：游戏社区常用
微信：个人助理

2. 可以用很多 AI 服务

你想用哪个 AI 都可以：

DeepSeek（国产，便宜好用）
OpenAI（GPT-4、GPT-3.5）
Claude
其他更多选择……

3. 完全免费开源

代码公开在 GitHub 上，没有任何收费套路。

4. 有桌面版，入门成本更低

AstrBot 提供了桌面客户端，下载后按普通软件方式启动，前期可以先避开 Docker、命令行和服务常驻这些问题。

部署方式怎么选？

AstrBot 有几种安装方式，适合不同的人：

方式	适合谁	难度
桌面版（推荐）	先体验功能，暂时不想处理服务器环境	简单
整合包	有一定基础的用户	简单
Docker	想要稳定运行、长期在线	中等
源码部署	开发者，需要自定义修改	困难

本文推荐使用桌面版，因为：

下载一个安装包就行
和普通软件一样安装
自带管理界面
不用碰命令行

Windows 系统部署教程（桌面版）

这是入门成本较低的安装方式，适合先验证 AstrBot 是否符合自己的使用场景。

第一步：下载安装包

打开浏览器，访问这个地址：

1	https://github.com/AstrBotDevs/AstrBot-desktop/releases/latest

在页面下方找到 “Assets”，展开它
找到以下文件并点击下载：
1
AstrBot_版本号_windows_amd64_setup.exe
这个是安装版，下载后双击安装即可。
不知道选哪个？ 大多数电脑都选 amd64_setup.exe 就行。如果你是 ARM 芯片的 Windows 设备，选 arm64_setup.exe。
如果你不想安装，想”绿色版”直接运行，可以下载 portable.zip 版本，解压就能直接用。

国内下载慢怎么办？ 可以用 Gitee 镜像加速：
1
https://gitee.com/knight3fax/AstrBot
在 Releases 页面找到对应版本下载。

第二步：安装 AstrBot

双击下载好的 setup.exe 文件
如果弹出”用户账户控制”提示，点**”是”**
按照安装向导操作：
- 选择安装位置（默认即可，也可以改到 D 盘）
- 点**”下一步”**继续
等安装完成，勾选**”运行 AstrBot”，点“完成”**

第三步：启动并使用

安装完成后，桌面会出现 AstrBot 的图标
双击打开，你会看到一个窗口界面
首次启动时，AstrBot 会自动初始化，等待几秒即可
窗口里会显示一个地址，通常是：
1
http://localhost:6180
或者窗口里有一个**”打开管理面板”**按钮，直接点击即可
浏览器会自动打开管理界面，第一次访问会要求你设置管理员密码

搞定！就这么简单！ 不需要任何命令行操作。

日常使用

启动：在开始菜单搜索 AstrBot，打开就行。

停止：关闭 AstrBot 窗口即可，或者在系统托盘右键退出。

升级： AstrBot 桌面版通常会在启动时自动检查更新，有新版本会提示你升级。

配置 AI 模型

现在 AstrBot 已经运行了，但还不会回答问题。接下来要给它”装上大脑”。

以 DeepSeek 为例（推荐，便宜好用）

1. 获取 API Key

打开浏览器，访问：
1
https://platform.deepseek.com/
点击右上角 “注册”，用手机号注册
登录后，找到 “API Keys” 或 “密钥管理”
点击 “创建 API Key”
给密钥起个名字，比如”我的机器人”
创建后会显示一串很长的代码，复制保存好（只显示一次）

2. 在 AstrBot 里配置

打开 AstrBot 管理界面
登录你刚才设置的密码
在左侧菜单找到 “AI 模型” 或 “服务提供商”
点击 “添加” 或 “新增”
选择 DeepSeek
填写：
- API Key：粘贴刚才复制的那串代码
- 模型：选择 deepseek-chat
点击 “保存”

搞定！现在你的机器人已经有”大脑”了！

接入 QQ（可选）

如果你想让机器人在 QQ 上和你聊天，继续看这里。

好消息！ 最新版 AstrBot 已经自带 QQ 机器人功能，无需额外安装 NapCat 等第三方工具。

在 AstrBot 中配置 QQ

打开 AstrBot 管理界面
在左侧菜单找到 “消息平台” 或 “消息适配器”
点击添加新的适配器，选择 QQ 官方 API 或 QQ 机器人
按照提示填写你的 QQ 机器人信息：
- 如果你使用的是 QQ 官方机器人，需要到 QQ 开放平台申请机器人账号，获取 AppID 和 Token
- 如果你使用的是 第三方协议，按照对应平台的指引配置即可
保存配置
重启 AstrBot（在 AstrBot 桌面版里可以直接点重启按钮）

测试一下

用另一个 QQ 号给你的机器人发消息
或者把机器人拉到一个群里，@它说话
如果机器人回复了，恭喜你！部署全部完成！

常见问题

Q: 桌面版和普通软件一样吗？

A: 是的！AstrBot 桌面版就像你安装微信、QQ 一样，双击打开就能用，不需要任何技术基础。

Q: 访问不了管理界面怎么办？

A: 检查几件事：

AstrBot 有没有在运行？看看任务栏有没有它的图标
浏览器地址有没有输错？是 localhost 不是 localghost 😄
试试关闭防火墙或杀毒软件看看

Q: 国内 GitHub 下载太慢怎么办？

A: 可以用 Gitee 镜像下载：

1	https://gitee.com/knight3fax/AstrBot

在 Releases 里找到对应的版本下载。

Q: QQ 机器人收不到消息？

A: 可能原因：

检查 QQ 机器人配置是否正确（AppID、Token 等）
确认 QQ 机器人账号状态正常，没有被封禁
检查网络连接是否正常

Q: AI 不回复或回复很慢？

A: 检查：

API Key 填对了没？有没有多复制空格？
DeepSeek 账户里有没有余额？（新用户一般会送免费额度）
网络是不是断了？

Q: 关机后数据会丢吗？

A: 不会！AstrBot 会自动保存数据。桌面版的数据默认存储在程序目录下。

总结一下

恭喜你看到最后！现在你应该已经：

知道了 AstrBot 是什么——一个 AI 机器人框架
在自己电脑上装好了 AstrBot 桌面版——像装普通软件一样简单
给机器人装上了 AI 大脑——配置了 DeepSeek
(可选)接入了 QQ——可以和机器人聊天了

接下来你可以：

在 AstrBot 管理界面探索更多功能
安装各种有趣的插件
给机器人设置不同的”性格”
把它介绍给朋友们用

拥有自己的 AI 机器人，其实就像安装一个软件一样简单！

番星的科技记录站