Percept Voice Commands

TotalClaw 作者 jarvis563 v1.0.0

环境语音唤醒词检测，将邮件、提醒、搜索等语音命令路由到 OpenClaw 智能体执行。

源码 ↗

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install totalclaw:jarvis563~jarvis563-percept-voice-cmd

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Ajarvis563~jarvis563-percept-voice-cmd/file -o jarvis563-percept-voice-cmd.md

Git 仓库获取源码

git clone https://github.com/openclaw/skills/commit/7dd8e46415b62dced8ef98b87ee29f7a25d7571e

## 概述（中文）

环境语音唤醒词检测，将邮件、提醒、搜索等语音命令路由到 OpenClaw 智能体执行。

## 技能正文

# percept-voice-cmd

面向 OpenClaw 智能体的语音命令检测与动作执行。

## 功能

检测环境语音中的唤醒词，将语音命令路由到 OpenClaw 智能体执行。支持邮件、短信、提醒、搜索、日历、笔记与自定义命令。

## 何时使用

- 用户说出唤醒词（「Hey Jarvis」、「take notes」或自定义）
- 用户希望免提控制智能体
- 用户要求设置语音命令或唤醒词

## 要求

- 已安装并运行 **percept-listen** 技能
- 可通过 CLI 访问 **OpenClaw 智能体**

## 支持的动作

| 动作 | 示例 |
|--------|---------|
| Email | "Hey Jarvis, email Rob saying the report is ready" |
| Text | "Hey Jarvis, text David that I'm running late" |
| Reminder | "Hey Jarvis, remind me in 30 minutes to call the dentist" |
| Search | "Hey Jarvis, look up the weather in San Francisco" |
| Calendar | "Hey Jarvis, what's on my calendar today?" |
| Note | "Hey Jarvis, take a note that the server password changed" |
| General | "Hey Jarvis, [anything]" → 转发给 OpenClaw |

## 唤醒词配置

默认唤醒词：`hey jarvis`、`take notes`、`send an email`

通过 Percept 仪表板（端口 8960）→ Settings → Wake Words 配置，或直接在数据库中修改。

## 工作原理

1. Percept 缓冲传入的转录片段
2. 检测到唤醒词 → 延长缓冲 5 秒以捕获完整命令
3. 唤醒词后 10 秒延续窗口（捕获后续指令而无需重复唤醒词）
4. 双层意图解析：先快速正则，复杂命令回退 LLM
5. 从通讯录（`percept/data/contacts.json`）解析联系人
6. 通过 OpenClaw CLI 分发命令执行

## 说话人授权

仅已批准说话人可触发语音命令。配置位置：
- `percept/data/speakers.json` — 将说话人 ID 映射为姓名
- 仪表板 → Settings → Speakers → 切换 approved/owner

未批准说话人仅记录，不执行命令。

## 链接

- **GitHub:** https://github.com/GetPercept/percept