AstrBot

环境要求

• 需先安装 uv（Python 包管理工具，README 中给出官方安装文档链接）
• Python 3.12（一键部署命令中通过 --python 3.12 指定）
• macOS 用户首次运行 astrbot 命令可能因系统安全校验耗时约 10-20 秒
• 如需生产级稳定部署，需参考官方文档使用 Docker / Docker Compose

安装与启动步骤

1. 1安装 uv 环境

   README 要求先自行安装 uv 工具，安装方式见 README 中给出的 uv 官方文档链接。未装 uv 无法使用后续命令。

2. 2一键安装 AstrBot

   使用 uv 以 Python 3.12 安装 astrbot 工具，安装完成后 astrbot 命令即可在终端使用。

   uv tool install astrbot --python 3.12

   复制

3. 3初始化环境

   仅第一次部署时执行，用于初始化 AstrBot 运行环境，重复执行没有必要。

   astrbot init

   复制

4. 4启动 AstrBot

   运行后 AstrBot 服务启动，保持该终端窗口运行；macOS 首次运行该命令可能等待 10-20 秒。

   astrbot run

   复制

5. 5升级 AstrBot（可选）

   后续需要更新版本时执行，升级同样指定 Python 3.12，无需重新初始化。

   uv tool upgrade astrbot --python 3.12

   复制

如何确认成功

执行 astrbot run 后命令无报错并持续运行，即表示已启动；具体访问地址与界面请以官方文档为准。

常见问题

注意事项

• astrbot init 只需在首次部署时执行一次。
• 必须先在系统中安装 uv，否则无法执行 uv tool install 命令。
• Docker、宝塔面板、1Panel、CasaOS、手动源码部署等方式的具体步骤请参考官方文档。
• 桌面端 AstrBot App 面向 ChatUI 使用场景，官方不建议用于服务器场景。