Install
openclaw skills install h-earH-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 machine sensor that empowers you, your business and your AI flow.
<!-- 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. -->
<!-- @end-doc-ref -->
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
<!-- @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 <search> | List supported sound classes (521+ across 3 taxonomies). |
h-ear jobs | List recent classification jobs (paginated). |
h-ear job <jobId> | Get detail for one job: status, fileName, eventCount, timestamps. |
h-ear job events <jobId> | Get noise events for a completed job (timeline order, filterable). |
h-ear job audio <jobId> | Get a 1-hour SAS URL to stream the source audio of a job. |
h-ear job waveform <jobId> | Get pre-computed peaks.js waveform + audio URL. |
h-ear job report <jobId> | Get a 7-day SAS URL to download the Excel analysis report. |
h-ear classify <fileOrUrl> | Classify audio (URL or local file). Polls until complete. |
h-ear classify batch | Submit a batch of audio URLs for asynchronous classification (callback delivery). |
h-ear webhook list | List enterprise webhook registrations. |
h-ear webhook get <webhookId> | Show one webhook (URL, events, filter config, delivery stats). |
h-ear webhook create <url> | Create an enterprise webhook (returns signing secret ONCE). |
h-ear webhook update <webhookId> | Update webhook URL, status (active/paused), or filters. |
h-ear webhook delete <webhookId> | Permanently delete a webhook (cannot be undone). |
h-ear webhook ping <webhookId> | Send a test ping to a webhook (verify connectivity + signing). |
h-ear webhook deliveries <webhookId> | Audit trail: recent delivery attempts for a webhook. |
For per-command help with all flags and examples, run h-ear <command> --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.