快速开始

这个站点覆盖三样东西，共享同一套通知 / 录音 / 灯效底层实现，但运行方式互斥——先搞清楚自己要哪个，再决定装哪个：

	独立 CLI	OpenClaw 插件	Hermes 插件
是什么	独立命令行 yoooclaw / yc，自带本地 daemon	OpenClaw / QClaw 宿主插件 @yoooclaw/phone-notifications	Hermes Agent 的 Python 插件 yoooclaw-hermes-plugin
运行在哪	独立进程，不依赖任何宿主客户端	装进已有的 OpenClaw / QClaw 宿主里	装进已有的 Hermes Agent 里
谁来驱动	你自己在终端敲命令，或配合 Agent（Claude Code / Codex 等）	宿主里的 Agent，通过 openclaw ntf 子命令	Hermes 的 tools / hooks / slash commands
支持手机 App 聊天	不支持——CLI 没有聊天界面	支持——由 OpenClaw / QClaw 宿主本身提供，插件只是给宿主加通知/录音/灯效能力	支持——插件自带 APP 适配器，让原本没有手机端的 Hermes 也能被 App 聊天
装完看这里	独立 CLI	OpenClaw 插件	Hermes 插件

我该选哪个？

• 只想在终端 / 让 Agent 驱动通知、录音、灯效，不需要任何宿主客户端在线 → 装独立 CLI，跳到下面的独立 CLI 快速开始。
• 已经在用 OpenClaw / QClaw 宿主（本身就能在 App 里聊天），想让它再接收手机通知、按规则控制灯效 → 装 OpenClaw 插件，跳到下面的 OpenClaw 插件快速开始。
• 用的是 Hermes Agent，想直接打开手机 App 跟它聊天，同时复用通知 / 录音 / 灯效能力 → 装 Hermes 插件，跳到下面的 Hermes 插件快速开始。

不要同时装

三者共享同一套 Relay 隧道实现，同时启用会互相抢占连接。选一个形态，不要既装 CLI 又装插件。

独立 CLI 快速开始

自带本地守护进程（daemon）、不依赖宿主在线，把手机通知、录音、图片、灯效规则、隧道、监控等能力抽象成 Agent-Native 的命令体系，统一 --format 输出与错误契约。

包	状态	说明
@yoooclaw/cli	可用	独立 yoooclaw / yc CLI：自带 daemon，配置 / 通知 / 录音 / 图片 / 灯效规则 / 隧道 / 监控等全部命令已落地，统一 --format 与错误契约，Agent-Native。

前置要求

• 通过 npm 安装：Node.js >= 18（只用于启动薄 launcher，实际执行 Go 原生二进制）
• 通过 install.sh / GitHub Release 直装：无需 Node
• 从源码构建：Go toolchain；本机当前验证使用 Go 1.26.4
• ASR：当前 Go beta 只支持云端 api / model-proxy 模式，不需要本地 Whisper
• 平台：npm 支持 darwin/linux 的 x64+arm64 与 win32-x64；原生直装支持 darwin/linux 的 x64+arm64。Windows 上凭据落明文、daemon 经 HTTP 优雅停止，详见 CLI 概述。

安装示例：

npm i -g @yoooclaw/cli
yoooclaw --help

从源码构建

git clone https://github.com/YoooClaw/cli.git
cd cli

go test ./...
go vet ./...
scripts/build-go.sh --current
dist-native/yoooclaw-darwin-arm64 --help

详见 CLI：概述与安装。

OpenClaw 插件快速开始

@yoooclaw/phone-notifications 装进 OpenClaw / QClaw 宿主，负责手机通知接收与本地存储、查询摘要统计、定时监控、长录音同步与 ASR 转写、硬件灯效控制。

openclaw plugins install @yoooclaw/phone-notifications
openclaw ntf --help

QClaw 或没有全局 openclaw 命令的宿主可以用一键脚本：

curl -fsSL https://artifact.yoooclaw.com/plugin/install.sh | bash

详见 OpenClaw 插件：概述与安装。

Hermes 插件快速开始

yoooclaw-hermes-plugin 装进 Hermes Agent，让手机 App 能直接跟 Hermes 对话，同时复用通知 / 录音 / 灯效能力；内置对应平台的 yoooclaw 可执行文件，不需要单独装 CLI。

curl -fsSL https://artifact.yoooclaw.com/hermes-plugin/install.sh | bash -s -- --api-key "ock_..."

详见 Hermes 插件：概述与安装。

下一步

• 什么是 Agent —— 第一次接触 Agent / daemon / 宿主这些词？先看这篇。
• OpenClaw / Hermes 生态速览 —— OpenClaw、Hermes、yoooclaw、C·ONE 之间到底是什么关系。
• 官网导览 —— 想买硬件、下 App、查普通用户教程，去官网而不是这里。
• 独立 CLI：概述与安装 —— 安装并了解独立命令行的命令体系。
• 独立 CLI：架构与实现逻辑 —— Go daemon 启动流程、Relay 分发、profile 与凭据分层。
• OpenClaw 插件：概述与安装 —— 装进 OpenClaw / QClaw 宿主的手机通知插件。
• Hermes 插件：概述与安装 —— 让手机 App 能跟 Hermes 对话的插件。