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#

CommandDescriptionh-ear healthCheck H-ear API health and liveness (no auth required).h-ear usageShow API usage statistics (minutes, calls, quota).h-ear sounds <search>List supported sound classes (521+ across 3 taxonomies).h-ear jobsList 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 batchSubmit a batch of audio URLs for asynchronous classification (callback delivery).h-ear webhook listList 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#

VariableRequiredDefaultDescriptionHEAR_API_KEYYes*H-ear Enterprise API key ( ncm_sk_...). Required unless HEAR_BEARER_TOKEN is set. Get one at h-ear.world.HEAR_BEARER_TOKENYes*OAuth bearer token. Alternative to HEAR_API_KEY — one of the two must be set.HEAR_ENVYesTarget environment: dev, staging, or prod.HEAR_BASE_URLNoPer-environment defaultOverride 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.