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 audio as a spatiotemporal annotated soundscape that empowers you, your business and your AI flow.

Commands

Command	Description
classify <url>	Classify audio from a URL. Returns detected sound classes with confidence scores.
classify batch <url1> <url2>...	Batch classify multiple audio URLs. Results delivered asynchronously via the gateway's webhook endpoint.
sounds [search]	List supported sound classes (521+ across 3 taxonomies).
usage	Show API usage statistics (minutes, calls, quota).
jobs [last N]	List recent classification jobs with status.
job <id>	Show detailed job results with classifications.
alerts on <sound>	Enable real-time alerts for a sound class. Notifications delivered to your connected channel via the gateway.
alerts off <sound>	Disable alerts for a sound class.
health	Check API status.

Setup

Variable	Required	Default	Description
HEAR_API_KEY	Yes		H-ear Enterprise API key. Get one at h-ear.world.
HEAR_ENV	Yes		Target environment: dev, staging, or prod.
HEAR_BASE_URL	No	Per-environment default	Override API base URL (advanced).

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.