一键启动器部署：官方 Launcher 图形化安装流程

启动器（Launcher）是官方维护的安装工具，和桌面客户端的区别在于：它更偏向「自动化脚本拉起」的传统部署流程，保持和命令行部署一致的工作目录结构，适合希望以后好迁移、好排障的用户。

安装步骤

1. 打开官方组织的 astrbot-launcher 仓库页面
2. 进入右侧 Releases 的最新版本
3. 在 Assets 里下载对应系统的安装器：

• Windows x64 下载文件名带 x64-setup.exe 的包
• Windows on Arm 下载 arm64-setup.exe
• Apple 芯片 Mac 下载 aarch64.dmg

1. 安装并打开，启动器会自动完成环境准备和程序拉起

macOS 提示「已损坏，无法打开」

这是 Gatekeeper 拦截未签名应用，不是真的损坏。打开终端执行：

xattr -dr com.apple.quarantine /Applications/AstrBot\ Launcher.app

然后重新打开应用。

数据目录位置

启动器版本不同，数据目录也不同：

• 新版可视化启动器：家目录下的 .astrbot_launcher 目录（Windows 是 C:\Users\你的用户名\.astrbot_launcher）
• 旧版 PowerShell 启动器：Launcher 批处理脚本同级目录下的 data

旧版 Windows 安装器（不推荐）

官方仍保留一套 PowerShell 脚本安装器（AstrBotLauncher 仓库），要求电脑预装 Python 3.10–3.13 并加入环境变量。流程是：下载 Source code (zip) 解压，在地址栏输入 PowerShell 打开，把 launcher_astrbot_en.bat 拖进窗口回车。脚本会自动下载最新源码、装依赖并运行。

两个常见报错：

• Python is not installed：已装过 Python 仍报错，说明环境变量没生效。方法一是编辑 bat 文件，把 set PYTHON_CMD=python 这行改成 Python 解释器的完整路径；方法二是重装 Python 时勾选 Add Python to PATH 后重启
• Windows 已保护您的电脑：点「更多信息」→「仍要运行」，脚本本身无病毒

没有特殊情况，直接用上面的新版启动器，老安装器留给出历史遗留环境的用户。

启动成功的标志

日志出现管理面板已启动的提示并附带访问链接，浏览器打开即见登录页。初始密码规则见首次登录。