<!-- 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

<!-- @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. |

<!-- @end-doc-ref -->

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.