OM1

环境要求

• macOS 或 Linux 系统（README 仅提供这两个平台的依赖安装方式）
• OpenMind API key（快速开始要求添加）
• conversation agent 需要摄像头与麦克风，配置 VLM 时建议开启摄像头权限
• 已安装 Homebrew（macOS）或 apt 包管理器（Linux）

安装与启动步骤

1. 1安装 macOS 依赖

   macOS 用户用 Homebrew 安装音频与多媒体依赖 portaudio、ffmpeg，这是运行 conversation agent 的前置条件。

   brew install portaudio ffmpeg

   复制

2. 2安装 Linux 依赖

   Linux 用户先更新源，再安装 portaudio19-dev、ffmpeg、pkg-config，缺一可能无法编译或运行音频相关功能。

   sudo apt-get update
   sudo apt-get install -y portaudio19-dev ffmpeg pkg-config

   复制

3. 3获取 OM1 程序

   README 给出两条路：下载官方发布的二进制文件，或克隆仓库。此处给出克隆仓库的命令。

   git clone https://github.com/OpenMind/OM1.git

   复制

4. 4添加 OpenMind API key

   按快速开始第 3 步，需为 OM1 配置你的 OpenMind API key，用于模型推理。README 未给出具体配置命令或文件名，请以官方文档为准。

5. 5启动并验证运行

   用默认的 conversation 入门配置启动 OM1，它会用摄像头和麦克风做语音交互，并在终端可视化状态更新。README 未给出具体启动命令，请参考官方文档。

如何确认成功

启动后终端持续输出状态更新，conversation agent 能通过麦克风与摄像头进行语音交互，即表示运行成功。

常见问题

注意事项

• README 未给出 OM1 的具体启动命令和 API key 配置文件名，请到 docs.openmind.com 查阅后再执行。
• Python 版本位于仓库 python 分支，已废弃且不再维护，新项目请用 Go runtime。
• 项目同时支持人形机器人、四足机器人、TurtleBot 4 以及 Gazebo、Isaac Sim 等仿真环境，也涉及 ROS2、Zenoh 等技术栈。