OpenCharm 是一个开源项目，为已经运行的 AI 智能体提供“身体”。官方描述为：它是你已经在用的 AI 智能体（Claude Code、Codex、Hermes Agent、OpenClaw 或任何 ACP 智能体）的开源身体——一张脸、一个声音和一颗按键。目前它以桌面版（desktop charm）的形式出现在 macOS 或 Windows 屏幕顶部，未来可运行在用户自己搭建的小型开发板上。
【用途与定位】 官方强调它不是新的助手，不替代任何东西：智能体继续保留自己的记忆、技能和模型，OpenCharm 提供的是它缺少的部分——一双眼睛、一个声音和一颗不用看就能按到的按键。核心诉求是让用户无需打开手机或输入提示，就能看到智能体正在做什么，并与它对话或批准操作。
【主要能力】
- 表情与状态反馈：用两个字符作眼睛、一个字符作嘴，可远距离辨认。官方列出 22 种情绪与 13 种智能体状态：呼吸、眨眼、四处张望、跟随屏幕上的手指、按键时眼睛隆起、解锁后问候、帮助后开心、约四分钟独处后打瞌睡带 z 字符、被戳有不同反应（快速连戳三次会眩晕）。智能体的事件会被转成对应表情，例如思考中、工作中、卡住、完成、学到新知识、需要输入或批准（橙色圈加一次提示音）、重试堆积、出错、创建或改进了技能、保存了关于用户的信息、花费超过设定上限、或处于免打扰时段（智能体继续运行、表面安静）。
- 语音交互：按住按键说话，麦克风仅在按住期间开启，松手即关闭，没有唤醒词。该规则写在 OpenCharm OS 本身，智能体无法自行打开麦克风。
- 决策与批准：当智能体需要用户确认时出现橙色圆环，按住表示同意、按下表示拒绝，官方描述为类似对讲机的操作方式。
- 自定义：可选颜色、命名、选择脸型；这些选择不会保存或发送。桌面版设置或工作区的 opencharm.json 可同步相同的配置（问候、声音、动作幅度）。charmd 是机器上的小型守护进程，负责把语音送给智能体并带回语音、表情和问题。
- 数据与密钥：设备不存储 API 密钥，不保存 PIN（charmd 只保存哈希）。语音在用户电脑上理解。默认使用 Microsoft 免费语音朗读回复，官方明确说明这意味着每次朗读的文本会发送给 Microsoft；也可以改用本地语音把一切留在本机，或使用自己的 OpenAI 密钥。
【使用方式】
- 桌面版快捷键：macOS 为 ⌥ Option + Space，Windows 为 Ctrl + Alt + Space，可在任意应用中使用，可在设置中更改。按住说话，其他操作按一下。
- 获取方式：从 GitHub Releases 下载，官方称由仓库自身的 CI 从代码构建，提供校验和与构建来源证明；也可以自己从代码构建。支持 macOS 与 Windows。
- 与智能体配对：运行 opencharm init，再在 Claude Code、Codex、Hermes 等智能体旁边运行 opencharm serve，然后打招呼。
- 支持的智能体：任何使用 ACP（Agent Client Protocol）的智能体，包括 Claude Code、Codex、Gemini CLI、goose、Hermes Agent、OpenClaw，或任何提供 OpenAI 兼容 API 的服务器；一次连接一个。官方称 Claude Code 是端到端测试过的。
- 本地或服务器运行：智能体可以在本机运行，读取文件、运行测试、编辑代码并使用被允许的应用；也可以在自有服务器上运行 Hermes、OpenClaw 或任何 OpenAI 兼容服务，通过加密链路从任意位置访问。官方称任何有风险的操作会让脸变橙并等待按键确认。
【硬件与成本】 软件（含桌面版）免费且开源。官方给出的硬件成本约为 32 美元（不含运费）：Waveshare ESP32-S3-Touch-AMOLED-2.16 带电池版本，这块现成开发板已含屏幕、麦克风、扬声器功放、电池和外壳。官方称 OpenCharm 将在设备移植完成后可刷入该板；在此之前它作为桌面版在电脑上运行。打印外壳为可选项，官方描述为三部分、无需支撑、缝线处挂带。外壳可用六种颜色之一或任意颜色打印。官方说明不销售任何东西，用户自行购买零件。
【适用场景】 官方列举的典型用途包括：与智能体对话（按住问任何问题，听到一个清晰回答）；智能体需要确认（按住为是、按下为否）；知道任务何时完成（启动长任务后离开，表情会告知完成）；记住信息（说一次，智能体保存，可查看列表）；学习（五分钟自适应测验，每次回答都有反应）；晨间简报（拿起就听到当天最重要的那件事）；免手烹饪（分步指导含计时器，手上沾面粉也能看）；出发时说一句控制灯光、暖气、门；出行时看门次变化、步行时间、正确站台；困倦时它也困，为明天做好准备。
【设计原则与限制】 官方给出的设计目标包括：按键后十秒内可用、每屏一件事、字形采用纯黑、仅需要用户时才用橙色、目标反应时间低于 100 毫秒。项目开源到外壳文件与固件，可三级定制：写一句话（工作区中关于 charm 身份与知识的文本文件）、添加 MCP 服务器、修改身体（fork OpenCharm OS，一个 C++ 核心同时服务桌面版与开发板，在电脑上的模拟器中开发测试）。 官方说明的限制与风险：项目按原样提供、无保修，用户自行承担构建和使用风险；这是开源项目，官方不销售硬件。桌面版运行 OpenCharm OS，官方称静止时约占用单核 2%、应用约 4 MB。官方提到开发板固件刷新依赖尚未完成的设备移植，Waveshare 出厂固件可随时恢复。官方明确说明未与 Meta 存在关联。关于开发板与桌面版之间具体功能差异的更多细节，官方资料中未全部展开。
