什么是 BirdNET-Go？

BirdNET-Go 技能允许用户直接通过其 AI 代理环境与本地鸟类声音识别服务器进行交互。通过利用 Openclaw Skills，开发人员和鸟类爱好者可以以编程方式访问实时检测日志、验证物种分类，并检索与特定音频分类相关的环境数据。

该技能弥补了生物声学监测硬件与自动化数据分析工作流之间的差距，使管理大型鸟类声音数据集变得更加容易。它专为托管自己的 BirdNET-Go 实例并希望以流线化方式与其数据交互（无需手动 API 调用）的用户而设计。

下载入口:https://github.com/openclaw/skills/tree/main/skills/rappo/birdnet

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

BirdNET-Go 应用场景

• 通过集中式仪表板或命令行监控本地鸟类活动。
• 自动检索稀有物种检测结果以进行环境报告。
• 搜索历史检测数据以跟踪随时间变化的迁徙模式。
• 生成您所在区域内每日鸟类声学事件的摘要。

1. 该技能使用预配置的本地 URL 建立与自托管 BirdNET-Go 实例的连接。
2. 用户通过 Openclaw Skills 发布特定命令来查询 BirdNET-Go v2 API 端点。
3. 该技能利用 curl 和 jq 等系统级工具从服务器获取并解析 JSON 数据。
4. 结构化结果（包括置信度评分和物种元数据）将返回给用户或代理以进行进一步处理。

BirdNET-Go 配置指南

要开始使用此技能，请确保您的主机上安装了 curl 和 jq。然后，配置您的凭据：

1. 创建配置目录和文件：

mkdir -p ~/.clawdbot/credentials/birdnet/
touch ~/.clawdbot/credentials/birdnet/config.json

2. 将您的 BirdNET-Go 服务器 URL 添加到 ~/.clawdbot/credentials/birdnet/config.json：

{
  "url": "http://192.168.1.50:783"
}

3. 通过列出最近的检测来测试连接：

bash scripts/birdnet.sh recent 5

BirdNET-Go 数据架构与分类体系

该技能以与标准 Openclaw Skills 工作流兼容的结构化格式处理并返回数据：

name: birdnet
version: 1.0.0
description: Query BirdNET-Go bird detections. View recent birds, search by species, get detection details.
metadata: {"openclaw":{"emoji":"??","requires":{"bins":["curl","jq"]}}}

BirdNET-Go

Query your BirdNET-Go bird sound identification system.

Setup

Create ~/.clawdbot/credentials/birdnet/config.json:

{
  "url": "http://192.168.1.50:783"
}

No API key needed for local access.

Commands

List recent detections

bash scripts/birdnet.sh recent [limit]

Shows the most recent bird detections with confidence scores.

Search detections by species

bash scripts/birdnet.sh search "Common Raven"

Search for detections of a specific bird species.

Get detection details

bash scripts/birdnet.sh detection 

Get full details about a specific detection including weather data.

Get species info

bash scripts/birdnet.sh species "Corvus corax"

Get information about a species including rarity score and taxonomy.

Today's summary

bash scripts/birdnet.sh today

Summary of today's bird detections.

Output Format

Recent detections show:

• Common name (Scientific name)
• Confidence score (0.0-1.0)
• Date and time
• Verification status

API Endpoints Used

• GET /api/v2/detections - List detections
• GET /api/v2/detections/:id - Get detection details
• GET /api/v2/species - Get species information