AstrBot 文档AstrBot 安装指南：新手应该先从哪种安装方式开始
面向第一次接触 AstrBot 的用户，帮助你判断桌面端、启动器、Docker 和源码部署各自适合谁，以及安装完成后下一步该去哪里。
这篇适合谁
这篇给第一次接触 AstrBot 的新手，用来先选对安装起点，再进入部署和接入阶段。
先说明边界
这是一篇社区导读页，不是官方安装手册。你会在这里得到路径判断和成功标准，具体命令与参数请看文末官方文档。
安装前先判断这 3 件事
- 你当前目标是快速体验，还是后续要长期在线。
- 你更偏向图形化界面，还是可脚本化、可自动化的运行方式。
- 你是否已经具备稳定网络、基础运维能力和后续维护时间。
4 条常见起步路径怎么选
桌面客户端
适合零基础、想先在本机快速看效果的用户。安装门槛最低，但不应直接视为长期在线方案。
一键启动器
适合 Windows 用户先跑通最短路径。重点是先完成首次可用，不要一开始就追求复杂拓扑。
Docker
适合希望环境更可复现、后续可能迁移到服务器的用户。初次使用时保持单实例即可。
源码部署 / CLI
适合有开发背景、需要更高可控性的用户。路径更灵活，但也需要承担更多环境管理成本。
社区站推荐的新手起步顺序
- 先选一条最短路径，目标只设为“本机成功跑通一次”。
- 跑通后记录你的运行方式和关键依赖，不要马上切换第二条路线。
- 用同一套环境完成一次基础消息收发，确认不是“假成功”。
- 只有在目标变化时再切换到 Docker 或 CLI，不做无理由重装。
什么算安装成功
满足下面 3 条就可以判定“安装阶段完成”：
- AstrBot 可以稳定启动，且重启后仍可进入。
- WebUI 或管理入口可访问，核心配置可保存。
- 能完成至少一次基础消息交互，日志没有持续性报错。