← 返回 Skills 市场
486
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install percept-listen
功能描述
Captures ambient audio from wearable devices, transcribes locally, and streams searchable, speaker-tagged conversation data to your OpenClaw agent.
安全使用建议
This skill can collect and store ambient conversation data and asks you to install and run a third-party Python package and a local web server reachable via a public tunnel. Before installing: (1) Verify the 'getpercept' package and the GitHub repo (owner, recent commits, issues) to ensure you trust the code; (2) Confirm where STT actually happens — if the phone/cloud does speech-to-text, sensitive audio may be processed by third parties despite the 'local' claim; (3) Be aware that using ngrok/Cloudflare/Tailscale exposes webhook traffic to those providers — use authenticated tunnels and TLS, and limit access; (4) Review and secure the filesystem paths (percept/data/percept.db, /tmp/percept-live.txt) and set appropriate permissions/rotation; (5) Consider legal and privacy obligations for recording ambient conversations and obtain consent; (6) If you are not comfortable auditing a pip package or exposing transcripts via a tunnel, do not install. Additional helpful info to reduce uncertainty: a link to an official project homepage, signed releases or PyPI/project metadata, and explicit documentation stating whether STT runs on-device or in-cloud.
功能分析
Type: OpenClaw Skill
Name: percept-listen
Version: 1.0.0
The skill bundle describes a local ambient audio capture and transcription service. It instructs the user to install a Python package (`getpercept`) and run a local server (`uvicorn`) to receive data via a user-configured webhook/tunnel. The documentation explicitly states that "All processing stays local — no audio leaves your machine," indicating no intent for data exfiltration. There are no signs of prompt injection, malicious execution, persistence mechanisms, or obfuscation within the provided `SKILL.md` or `_meta.json` files. While exposing a local server via a tunnel can introduce vulnerabilities if the server itself is insecure, the instructions themselves are for setting up a legitimate service, not for malicious purposes.
能力评估
Purpose & Capability
Name and description (ambient capture + local transcription) align with the SKILL.md instructions to run a 'percept' receiver and accept webhook transcripts. However, the doc contains a contradictory phrase: the flow says 'Omi pendant captures audio → phone does STT → sends transcript segments via webhook', which implies the phone performs speech-to-text (possibly cloud-based) rather than transcription occurring purely on the user's machine. The skill also instructs installing a PyPI package and running a web server/tunnel although the registry metadata lists no required binaries, env vars, or credentials — a mild mismatch between declared requirements and operational needs.
Instruction Scope
Runtime instructions tell the operator to pip-install getpercept, run a uvicorn server, and configure a public tunnel (ngrok/Cloudflare/Tailscale) so a mobile app can post transcripts to a local webhook. That design intentionally exposes conversation transcripts to the chosen tunneling provider and to any network path between device and tunnel endpoint. Instructions also prescribe where transcripts and DB files are stored on disk. The doc does not warn that the phone's STT may be cloud-based or that tunnel providers will see webhook traffic — this is material scope creep for a skill claiming 'all processing stays local.'
Install Mechanism
There is no formal install spec in the registry; the SKILL.md directs users to 'pip install getpercept' and to run 'percept start' or uvicorn. Installing unverified PyPI packages and running a web server on your machine is a standard but non-trivial action that can introduce arbitrary code. The SKILL.md points to a GitHub repo (github.com/GetPercept/percept), which is helpful, but the registry metadata lists the source as unknown and has no homepage — you should verify the package and repo before installing.
Credentials
The skill declares no required env vars or credentials, which is consistent with the registry metadata. In practice, using tunnels and webhooks will typically require accounts/credentials for ngrok/Tailscale/Cloudflare or some configuration in the Omi/phone app; those are not documented or requested explicitly. Also, the doc's claim that 'all processing stays local' conflicts with the stated phone-side STT step, which may use third-party cloud STT and therefore would involve external credentials and data egress not described here.
Persistence & Privilege
The skill does not request elevated platform privileges or 'always: true'. It is user-invocable and can run services (percept start) on the host, but that is normal for an instruction-only integration. Note: once installed and running, the local server will persist conversation data on disk and the agent (if granted access) could read that data — evaluate that data flow carefully.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install percept-listen - 安装完成后，直接呼叫该 Skill 的名称或使用
/percept-listen触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
- Initial release of percept-listen: enable ambient audio capture and transcription for OpenClaw agents using wearable devices.
- Supports Omi pendant and Apple Watch as audio sources, with local speech-to-text and webhook delivery of transcripts.
- All transcripts are structured, searchable, and stored locally; includes local SQLite database and live transcript files.
- Setup instructions provided for Percept server, device pairing, and webhook configuration.
- Data and configuration remain private; audio processing and storage do not leave the user's machine.
元数据
常见问题
Percept Listen 是什么？
Captures ambient audio from wearable devices, transcribes locally, and streams searchable, speaker-tagged conversation data to your OpenClaw agent. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 486 次。
如何安装 Percept Listen？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install percept-listen」即可一键安装，无需额外配置。
Percept Listen 是免费的吗？
是的，Percept Listen 完全免费（开源免费），可自由下载、安装和使用。
Percept Listen 支持哪些平台？
Percept Listen 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Percept Listen？
由 jarvis563（@jarvis563）开发并维护，当前版本 v1.0.0。
推荐 Skills