/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.
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install h-ear - After installation, invoke the skill by name or use
/h-ear - Provide required inputs per the skill's parameter spec and get structured output
What is 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... It is an AI Agent Skill for Claude Code / OpenClaw, with 522 downloads so far.
How do I install H-ear?
Run "/install h-ear" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is H-ear free?
Yes, H-ear is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does H-ear support?
H-ear is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created H-ear?
It is built and maintained by Paul Day (@badajoz95); the current version is v1.1.7.