@h-ear/openclaw

OpenClaw skill for H-ear World audio classification. Sound intelligence in WhatsApp, Telegram, Slack, Discord, and Teams.

Install

npm install @h-ear/openclaw

Or via ClawHub — search for h-ear or paste https://github.com/Badajoz95/h-ear-openclaw.

Setup

Set HEAR_API_KEY to your H-ear Enterprise API key:

export HEAR_API_KEY=ncm_sk_your_key

Commands

| Command | Description | |---------|-------------| | classify <url> | Classify audio from a URL | | classify batch <url1> <url2>... | Batch classify multiple audio URLs | | sounds [search] | List supported sound classes (521+) | | usage | Show API usage statistics | | jobs [last N] | List recent classification jobs | | job <id> | Show detailed job results | | alerts on <sound> | Register a simple sound alert via webhook | | alerts off <sound> | Remove a sound alert | | webhook list | List enterprise webhook registrations | | webhook detail <id> | Webhook details with filter config | | webhook create <url> | Create enterprise webhook (returns signing secret once) | | webhook ping <id> | Test webhook connectivity | | webhook deliveries <id> | Delivery audit trail | | health | Check API status |

Example

In any connected messaging channel:

> classify https://example.com/city-noise.mp3

**Audio Classification Complete**
Duration: 45.2s | 15 noise events detected

| Sound      | Confidence | Category |
|------------|-----------|----------|
| Car horn   | 94%       | Vehicle  |
| Speech     | 87%       | Human    |
| Dog bark   | 72%       | Animal   |

Programmatic Use

import { createSkill, classifyCommand } from '@h-ear/openclaw';

const { client } = createSkill();
const result = await classifyCommand(client, 'https://example.com/audio.mp3');
console.log(result);

Supported Formats

MP3, WAV, FLAC, OGG, M4A

Get an API Key

Visit h-ear.world to create an account and generate an API key.

License

MIT