Seele安装教程:3分钟在Windows/macOS装好语音AI助手,新手零失败快速上手

原创2026-10-26 09:36:391,976 阅读

Seele安装教程:3分钟在Windows/macOS装好语音AI助手,新手零失败快速上手

Seele 是一款开源的语音 AI 助手桌面宠物:基于语音识别 + TTS + AI 大模型 + 影刀 RPA,让希儿这个"赛博妹妹"听懂你的话,帮你自动执行重复工作。本教程面向新手,讲清楚 Seele 安装步骤:Windows 双击安装包、macOS 拖入应用程序、源码运行三条路径,3 分钟即可完成部署。

Seele语音AI助手希儿形象

一、认识 Seele:装好之前先知道它是什么

Seele 的核心玩法一句话概括:把工作教给电脑一遍,它就能 100% 复现。

  • 🖱️ 桌面宠物:PyQt5 界面、角色 GIF、气泡、托盘和输入窗口;
  • 🤖 Botmux 连接:展示机器人正在工作、等待确认或离线等状态,未匹配本地工作流的输入可转给 Botmux Agent;
  • 🔗 RPA 桥接:仅允许调用已登记的影刀工作流,通过带 token 的本地 HTTP 接口提供给 Botmux MCP。

当前版本记录在 VERSION(当前为 2.5.0),完整架构说明见 README.md。

Seele语音AI助手桌面壁纸

二、Windows 安装教程:双击 setup.exe 即可

Windows 是 Seele 支持最完整的平台(影刀快捷方式、shadowbot: 协议、Win+H 听写均可用),普通用户推荐两条路径任选其一:

路径 1:Windows 安装版(推荐新手)

  1. 下载 Seele-<version>-windows-x64-setup.exe 安装包;
  2. 双击运行,按向导完成安装;
  3. 启动希儿,桌面宠物即出现在任务栏与桌面。

路径 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 版):

  1. ZIP 方式:完整解压 ZIP,打开 Seele 后选择"安装到应用程序",安装完成自动重启;若系统应用目录不可写,会自动安装到当前用户的 ~/Applications;
  2. 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 之后,试着对它说出一句已登记的工作流指令——当希儿开始替你点鼠标、拖窗口的那一刻,你就正式进入"语音驱动办公"的新世界了 🎉

登录后查看全文
Seele