/install h-ear
\x3C!-- Version: keep in sync with package.json. Runtime code reads from package.json via createRequire — this header is the static manifest the OpenClaw gateway parses at install/registration time. Bump both together. -->
H-ear — Sound Intelligence for AI Agents
H-ear.world transforms sound into an actionable, meaningful translation layer of the world around you. Describe, share and act upon environmental audio as a machine sensor that empowers you, your business and your AI flow.
Commands
\x3C!-- @doc-sync-ref gen:#openclaw-commands -->
| Command | Description |
|---|---|
h-ear health |
Check H-ear API health and liveness (no auth required). |
h-ear usage |
Show API usage statistics (minutes, calls, quota). |
h-ear sounds \x3Csearch> |
List supported sound classes (521+ across 3 taxonomies). |
h-ear jobs |
List recent classification jobs (paginated). |
h-ear job \x3CjobId> |
Get detail for one job: status, fileName, eventCount, timestamps. |
h-ear job events \x3CjobId> |
Get noise events for a completed job (timeline order, filterable). |
h-ear job audio \x3CjobId> |
Get a 1-hour SAS URL to stream the source audio of a job. |
h-ear job waveform \x3CjobId> |
Get pre-computed peaks.js waveform + audio URL. |
h-ear job report \x3CjobId> |
Get a 7-day SAS URL to download the Excel analysis report. |
h-ear classify \x3CfileOrUrl> |
Classify audio (URL or local file). Polls until complete. |
h-ear webhook list |
List enterprise webhook registrations. |
h-ear webhook get \x3CwebhookId> |
Show one webhook (URL, events, filter config, delivery stats). |
h-ear webhook create \x3Curl> |
Create an enterprise webhook (returns signing secret ONCE). |
h-ear webhook update \x3CwebhookId> |
Update webhook URL, status (active/paused), or filters. |
h-ear webhook delete \x3CwebhookId> |
Permanently delete a webhook (cannot be undone). |
h-ear webhook ping \x3CwebhookId> |
Send a test ping to a webhook (verify connectivity + signing). |
h-ear webhook deliveries \x3CwebhookId> |
Audit trail: recent delivery attempts for a webhook. |
| \x3C!-- @end-doc-ref --> |
For per-command help with all flags and examples, run h-ear \x3Ccommand> --help. For machine-readable schemas (LLM-friendly introspection): h-ear --list-tools --json.
Setup
| Variable | Required | Default | Description |
|---|---|---|---|
HEAR_API_KEY |
Yes* | H-ear Enterprise API key (ncm_sk_...). Required unless HEAR_BEARER_TOKEN is set. Get one at h-ear.world. |
|
HEAR_BEARER_TOKEN |
Yes* | OAuth bearer token. Alternative to HEAR_API_KEY — one of the two must be set. |
|
HEAR_ENV |
Yes | Target environment: dev, staging, or prod. |
|
HEAR_BASE_URL |
No | Per-environment default | Override API base URL (advanced). |
*One of HEAR_API_KEY or HEAR_BEARER_TOKEN is required.
Webhook Delivery
Batch classification (classify batch) and sound alerts (alerts on) use webhook callbacks for asynchronous result delivery. The OpenClaw gateway manages webhook endpoints automatically -- the skill registers callbacks against the gateway's own webhook receiver, which routes results back to your connected messaging channel. No external endpoint configuration is required by the user.
Webhook events: job.completed, job.failed, batch.completed, quota.warning.
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install h-ear - 安装完成后,直接呼叫该 Skill 的名称或使用
/h-ear触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
H-ear 是什么?
H-ear.world transforms sound into an actionable, meaningful translation layer of the world around you. Describe, share and act upon environmental audio as a... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 522 次。
如何安装 H-ear?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install h-ear」即可一键安装,无需额外配置。
H-ear 是免费的吗?
是的,H-ear 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
H-ear 支持哪些平台?
H-ear 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 H-ear?
由 Paul Day(@badajoz95)开发并维护,当前版本 v1.1.7。