yoooclaw手机、硬件与 Agent 之间的连接层

独立 CLI、OpenClaw 插件、Hermes 插件三种形态，同一套通知 / 录音 / 灯效能力

独立 yoooclaw CLI

自带本地守护进程、不依赖宿主在线的 Agent-Native 命令体系，统一 --format 输出与错误契约。

了解 CLI

daemon 启动流程、StandaloneRuntime 怎么免改复用底层代码、RelayDispatcher、profile / 凭据分层与端口顺延。

看 CLI 实现

配置 / 通知 / 录音 / 图片 / 灯效规则 / 隧道 / 监控等命令，统一 --format 输出与错误契约。

命令体系

全部子命令、参数与示例的完整参考。

命令参考

多 api-key 的分层、选择与回退策略。

了解设计

内置三个 Skill（查通知 / 建灯效规则 / 排查隧道），软链到 Claude Code / Codex 后让 Agent 自己驱动 CLI。

了解 Skill

装进 OpenClaw / QClaw 宿主的手机通知插件——通知接收与本地存储、查询摘要统计、定时监控、长录音同步与 ASR 转写、硬件灯效控制。

了解插件

Hermes Agent 与 YoooClaw 之间的 Python 插件桥接层，让手机 App 能直接跟 Hermes 对话，并共享同一套通知 / 录音 / 灯效能力。

了解 Hermes 插件

这个站点现在有三份文档：独立 CLI、OpenClaw 插件、Hermes 插件。安装前先确认你要的是哪一个，避免装错：

三选一，不要同时装

三者共享同一套通知 / 录音 / 灯效规则底层实现，但运行方式互斥，同时启用会互相抢占 Relay 隧道：

只想在终端 / 让 Agent（Claude Code、Codex 等）驱动通知、录音、灯效 → 装独立 CLI，不依赖任何宿主客户端在线。
已经在用 OpenClaw / QClaw 宿主（宿主本身就能在 App 里聊天），想让它再接收手机通知、控制灯效 → 装 OpenClaw 插件（@yoooclaw/phone-notifications）。
用的是 Hermes Agent，想直接打开手机 App 跟它聊天，同时复用通知 / 录音 / 灯效能力 → 装 Hermes 插件（yoooclaw-hermes-plugin），它自带 APP 适配器，让原本没有手机端的 Hermes 也能被 App 聊天。

独立 CLI 没有聊天功能。 它只是一套命令行工具，聊天需要靠 OpenClaw / QClaw 或 Hermes 这类 Agent 宿主。
OpenClaw 插件本身不实现 chat，App 里跟 Agent 聊天是 OpenClaw / QClaw 宿主自带的能力；插件只是给这个宿主加上通知 / 录音 / 灯效这条数据面。
建议有编程基础的同学使用独立 CLI。 需要在终端里敲命令、理解 daemon / 配置 / 凭据等概念，并通常配合 Agent 使用。