Seele安装教程:3分钟在Windows/macOS装好语音AI助手,新手零失败快速上手
Seele安装教程:3分钟在Windows/macOS装好语音AI助手,新手零失败快速上手
Seele 是一款开源的语音 AI 助手桌面宠物:基于语音识别 + TTS + AI 大模型 + 影刀 RPA,让希儿这个"赛博妹妹"听懂你的话,帮你自动执行重复工作。本教程面向新手,讲清楚 Seele 安装步骤:Windows 双击安装包、macOS 拖入应用程序、源码运行三条路径,3 分钟即可完成部署。
一、认识 Seele:装好之前先知道它是什么
Seele 的核心玩法一句话概括:把工作教给电脑一遍,它就能 100% 复现。
- 🖱️ 桌面宠物:PyQt5 界面、角色 GIF、气泡、托盘和输入窗口;
- 🤖 Botmux 连接:展示机器人正在工作、等待确认或离线等状态,未匹配本地工作流的输入可转给 Botmux Agent;
- 🔗 RPA 桥接:仅允许调用已登记的影刀工作流,通过带 token 的本地 HTTP 接口提供给 Botmux MCP。
当前版本记录在 VERSION(当前为 2.5.0),完整架构说明见 README.md。
二、Windows 安装教程:双击 setup.exe 即可
Windows 是 Seele 支持最完整的平台(影刀快捷方式、shadowbot: 协议、Win+H 听写均可用),普通用户推荐两条路径任选其一:
路径 1:Windows 安装版(推荐新手)
- 下载
Seele-<version>-windows-x64-setup.exe安装包; - 双击运行,按向导完成安装;
- 启动希儿,桌面宠物即出现在任务栏与桌面。
路径 2:Windows 便携版(绿色免安装)
下载 Seele-<version>-windows-x64-portable.zip,完整解压到一个固定目录后直接运行即可,不污染系统目录。
💡 企业内网用户可关注 Windows 字节版(
windows_byte),它会自动复用/安装 WSL2 并部署 Botmux 与字节 CLI,详细流程见 WINDOWS_BYTE_INSTALL.md。
三、macOS 安装教程:拖一拖就装好了
macOS 上 Seele 提供 DMG 与 ZIP 两种安装包(Apple Silicon 版):
- ZIP 方式:完整解压 ZIP,打开 Seele 后选择"安装到应用程序",安装完成自动重启;若系统应用目录不可写,会自动安装到当前用户的
~/Applications; - DMG 方式:打开 DMG,把 Seele 拖到 Applications 即可。
安装完成后无需保留下载目录。
⚠️ macOS 权限三连(只提示一次):系统首次运行时需授予辅助功能、麦克风和输入监控权限,否则语音输入会失效。
四、源码运行 Seele:4 条命令跑起来(进阶)
想体验源码版或有二次开发需求时,推荐 Conda + Python 3.11 环境:
conda create -n Seele python=3.11
conda activate Seele
pip install -r requirements.txt
python Seele.py
依赖清单见 requirements.txt(PyQt5、pynput、sounddevice 等,Windows 平台还会自动带上 keyboard、pywin32 等热键相关依赖)。
💡 Wayland、macOS 或部分 Linux 桌面可能不允许
keyboard注册全局热键,此时可在桌面宠物右键菜单选择"唤醒输入"。
五、首次启动后的 3 个零失败小贴士
1. 检查更新是"标配"
启动 5 秒后 Seele 会在后台检查最新正式版本,之后每小时检查一次;右键菜单最后一项始终为"检查更新",有新版时显示红点,点击即下载、校验(SHA256)、替换并重启,新版启动失败会自动恢复旧版。
2. 设置存在哪里
角色、语音、自定义工作流、Botmux 设置和日志都保存到当前用户专属目录,更新不会覆盖:
| 平台 | 配置目录 |
|---|---|
| macOS | ~/Library/Application Support/Seele/<edition>/ |
| Windows | %LOCALAPPDATA%\Seele\<edition>\ |
| Linux | $XDG_DATA_HOME/Seele/<edition>/ |
3. 想接 Botmux Agent?复制一份配置即可
复制 botmux_config.example.json 为 botmux_config.json 并填入 Dashboard 地址与 token;仓库内插件位于 botmux-skill/,环境变量与 WSL2 配置详见 botmux-skill/README.md。mac 字节版首次启动会自动检测 Node.js、npm、tmux、Trae CLI、Lark CLI、AgentBuddy 和 Botmux 工具链,命令细节可参考 MAC_BYTE_AUTO_INSTALL_COMMANDS.md。
六、常见问题速查(FAQ)
Q:Windows 上没有影刀客户端,Seele 还能用吗?
A:桌面宠物、Botmux 状态和语音交互照常可用,RPA 工作流需要本机有对应客户端或兼容的触发文件消费者(可用 SEELE_TOOLS_DIR 覆盖触发目录)。
Q:Linux 上能装吗? A:源码方式支持。需由系统包管理器安装 Qt/XCB、PortAudio 和 Tk,详见 README.md 的"源码运行"章节。
Q:安装后语音没声音? A:检查麦克风/输入监控权限(macOS)与系统音量;mac 字节版安装流程还会自动检测输出音量并临时调整。
装好 Seele 之后,试着对它说出一句已登记的工作流指令——当希儿开始替你点鼠标、拖窗口的那一刻,你就正式进入"语音驱动办公"的新世界了 🎉

