H-ear

该 Skill 是 H-ear 服务的命令行客户端，用于提交音频（本地文件或 URL）进行分类并轮询结果，查询任务、噪声事件、波形、Excel 分析报告与用量，浏览支持的声类，以及创建、更新、删除、测试和审计企业 Webhook 与告警。命令支持机器可读的 JSON 输出，运行需配置 API 凭据与目标环境，网络请求发往 H-ear 远端服务。

badajoz95

热度 63.68

最近更新 2026-05-11 17:37:44

分类：数据依赖：代码执行 / 读写文件 / 第三方 API应用场景：API 集成 / 数据处理 / 报告撰写 / 自动化脚本

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add h-ear

Metadata

name: h-ear
description: 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.
version: 1.1.5
author: H-ear World
homepage: https://h-ear.world
metadata: {"openclaw":{"requires":{"env":["HEAR_API_KEY","HEAR_ENV"],"bins":[]},"primaryEnv":"HEAR_API_KEY"}}

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

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.

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.