OpenCharm 是一个开源伴侣项目，目标是给已经运行的 AI 智能体一个“身体”。它不是一个独立的 AI 智能体，而是你现有智能体的脸和声音。它支持 Claude Code、Codex、Gemini CLI、Hermes Agent、OpenClaw、任何 ACP 智能体或任何 OpenAI 兼容的智能体。一次只服务一个智能体。
用途 OpenCharm 让 AI 智能体拥有可视化的表情和语音交互能力。它以桌面挂件的形式存在于 Mac 的刘海旁，用户通过一个按键与智能体交互，并通过一个简单的面部表情了解智能体的状态。项目还计划推出一个可自行搭建的小型硬件板，可以放在笔记本电脑旁边或挂在钥匙上。
主要能力
- 表情脸：由两个字符表示眼睛，一个字符表示嘴巴（如 ^ ^、o O、> <），在纯黑背景上以自身颜色显示。
- 单键三操作：按住说话、按下处理其他操作、轻拍面部。
- 多智能体支持：桌面挂件和 charmd 守护进程支持多种智能体预设，包括 Codex、Gemini CLI、goose、Hermes、OpenClaw，以及 OpenAI 兼容智能体的适配器。这些适配器已有测试覆盖（使用替身智能体），但尚未逐一在真实环境中试过。
- 硬件方案：提供硬件构建指南，包括约 32 美元（2026 年 9 月价格）的 Waveshare 板、小型扬声器和可选的 3D 打印外壳。
- 模拟器：提供在浏览器标签页中运行的 OpenCharm OS 模拟器，用于在硬件到位前开发固件和板子。注意，模拟器不是使用 OpenCharm 的方式。
使用方式 桌面挂件（macOS）：从最新发布版下载，在设置中选择智能体的文件夹，然后按住 ⌥ Space 即可说话。Windows 构建未在真机测试。 命令行方式：使用已发布的 CLI（需要 Node 24、git 和一个智能体如 Claude Code）。从源码运行需要 Emscripten，依次运行 npm run firmware:sim、npm run cli -- serve，在另一个终端运行 npm run sim，然后使用 npm run cli -- pair <code> 配对。在模拟器中，按住 Space 说话。 硬件构建：具体购买和打印内容见 docs/build.md，也可通过 npx opencharm hardware 列出。OpenCharm 将通过设备端口（spec 009）安装到硬件上。
适用场景
- 希望为已有的 AI 智能体增加语音和表情交互的用户。
- 希望自行搭建桌面伴侣设备的开发者和爱好者。
- 在 macOS 上使用支持的智能体进行日常交互。
限制
- 项目处于早期阶段。已在 macOS 上端到端测试（2026 年 10 月 3 日），包括 opencharm init、charmd、模拟器和 Claude Code，从配对到通过真实麦克风获得语音回答。
- 桌面挂件仅限 macOS，Windows 构建未在真机测试。
- 真实板子的固件（spec 009）尚未完成。
- 适配器虽经测试，但使用替身智能体，尚未在真实智能体上逐一验证。
- 项目不销售任何设备，无销售、预购、付款或等待名单，无成品设备发货。
- 构建的挂件没有 CE、FCC、UL 或其他成品认证。
- 不得用于安全、医疗、紧急或时间关键用途。
- 使用和配置的智能体行为由用户及其软件负责。
- 项目与 Meta、Nous Research、OpenClaw、Waveshare 或 Espressif 没有关联。
- 所有内容按“原样”提供，不带任何明示或暗示的保证。
- 锂电池存在膨胀、过热或起火风险，需遵循 docs/build.md 第 3 节，切勿无人看管充电，停止使用膨胀、发热或损坏的电池。
