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.
| 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 | List supported sound classes (521+ across 3 taxonomies). |
h-ear jobs | List recent classification jobs (paginated). |
h-ear job | Get detail for one job: status, fileName, eventCount, timestamps. |
h-ear job events | Get noise events for a completed job (timeline order, filterable). |
h-ear job audio | Get a 1-hour SAS URL to stream the source audio of a job. |
h-ear job waveform | Get pre-computed peaks.js waveform + audio URL. |
h-ear job report | Get a 7-day SAS URL to download the Excel analysis report. |
h-ear classify | 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 | Show one webhook (URL, events, filter config, delivery stats). |
h-ear webhook create | Create an enterprise webhook (returns signing secret ONCE). |
h-ear webhook update | Update webhook URL, status (active/paused), or filters. |
h-ear webhook delete | Permanently delete a webhook (cannot be undone). |
h-ear webhook ping | Send a test ping to a webhook (verify connectivity + signing). |
h-ear webhook deliveries | Audit trail: recent delivery attempts for a webhook. |
For per-command help with all flags and examples, run h-ear . For machine-readable schemas (LLM-friendly introspection): h-ear --list-tools --json.
| 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.
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.
共 1 个版本