前言¶
在 OpenClaw 一类 Agent 上,常见交互仍是打字或走云端语音链路。若你希望在本机用外接 USB 麦克风采集语音、用 USB 扬声器播放回复,并在本地完成与 Agent(社区里常称「小龙虾」)的对话,需要一套把音频硬件和 Agent 接起来的 Skill。下面介绍 SkillHub 社区技能 openclawHearSpeak 的定位、能力与安装方式。
这是什么¶
openclawHearSpeak 是 SkillHub 上的社区 Skill,坐标为 @user_aae27d93/openclawhearspeak,当前版本 1.0.0,分类为 ai-agent,由发布者 user_aae27d93 维护。
官方简介只有一句可核对表述:借助 USB 麦克风和 USB 扬声器实现本地直接与小龙虾对话。名称中的 OpenClaw 与「小龙虾」对应同一类本地 Agent 使用场景;Skill 不替代 Agent 本身,而是面向「本机 USB 音频设备 + 语音往返」这一环节。
SkillHub 页面元数据:评分 100000,下载 674 次,安装计数 0(以页面展示为准)。标签含 requires_api_key=true,表示启用或运行链路中可能需要配置 API Key;具体密钥类型与配置项以 Skill 包内说明为准,公开页面未展开字段名。
核心功能¶
依据官方简介,可核实的能力边界如下:
- 输入:通过 USB 麦克风采集用户语音(本地设备,非浏览器内置麦的泛化描述)。
- 输出:通过 USB 扬声器播放 Agent 的语音回复。
- 交互形态:在本地完成与「小龙虾」的对话闭环,强调 本地直连 的硬件路径,而非仅文字聊天。
公开资料未列出 ASR/TTS 供应商、采样率、延迟指标或支持的操作系统列表;正文不展开未在 SkillHub 页面出现的实现细节。
安装与启用¶
安装遵循 SkillHub 通用流程:先具备 skillhub CLI,再将技能装到当前 Agent 实际读取的 skills 目录(装错目录会导致 Agent 识别不到,需重启后仍无效)。
1. 检查或安装 SkillHub CLI¶
command -v skillhub && skillhub --version
若未安装,可使用官方安装脚本(完整安装含 CLI 与默认 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安装 openclawHearSpeak¶
SkillHub 技能页给出的安装提示为:根据 SkillHub 安装文档,安装 @user_aae27d93/openclawhearspeak。
在终端中,将坐标代入 skillhub install,并用 --dir 指向本机 Agent 的 skills 目录,例如:
skillhub install user_aae27d93/openclawhearspeak --dir <你的 Agent skills 目录>
常用客户端 skills 路径(摘自官方安装文档,按你实际使用的客户端择一):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/
OpenClaw 及其变体(NanoBot、PicoClaw、memUBot、MaxClaw、CoPaw、AutoClaw、KimiClaw、QClaw、EasyClaw、workbuddy 等)通常也有各自的 skills 目录,需与当前运行环境一致。
安装完成后按所用 Agent 的要求重启或重新加载 skills。因标签 requires_api_key=true,若 Skill 包内要求 API Key,请在 Agent 或 Skill 文档指定位置配置后再试语音链路;公开 SkillHub 页未提供具体配置示例。
典型用法¶
SkillHub 公开页未提供可逐步复制的命令示例或对话脚本。可复现的通用步骤仅为:
- 将 USB 麦克风、USB 扬声器接入本机并被系统识别。
- 在目标 OpenClaw 类 Agent 中按上一节完成 openclawHearSpeak 安装与启用。
- 在 Agent 中触发该 Skill 所定义的语音对话流程(具体触发方式以 Skill 包内 SKILL.md 为准)。
若安装后无语音输入输出,应先核对 skills 目录、Agent 重启,以及 API Key 是否按 Skill 要求已配置。
适用场景与注意¶
适合:已在或计划使用 OpenClaw 生态、希望用 外接 USB 麦 + USB 音箱 做本地语音往返、并接受社区 Skill(source: community)维护节奏的用户。
注意:
- 硬件依赖 USB 音频设备;笔记本内置麦/扬声器是否在支持范围内,公开简介未说明,以外接 USB 设备为明确前提。
- requires_api_key=true:可能涉及语音识别、合成或云端接口,使用前需自行准备密钥并遵守服务条款。
- 社区 Skill,版本 1.0.0;功能以简介为准,升级与兼容性请通过 SkillHub 查看更新记录。
- 安装统计中的「安装 0」仅反映平台计数方式,不代表不可用;以本机 Agent 能否加载 Skill 为准。
结尾¶
openclawHearSpeak 把 SkillHub 上的 Agent 能力延伸到本机 USB 音频:麦克风进、扬声器出,用于与「小龙虾」本地对话。需要安装与坐标时,以 SkillHub 官方页为准:
- 技能页:https://www.skillhub.cn/skills/user_aae27d93/openclawhearspeak
- API 条目:https://api.skillhub.cn/user_aae27d93/openclawhearspeak