← Back to Skills Marketplace
1683
Downloads
1
Stars
2
Active Installs
1
Versions
Install in OpenClaw
/install birdnet
Description
Query BirdNET-Go bird detections. View recent birds, search by species, get detection details.
README (SKILL.md)
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 \x3Cid>
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 detectionsGET /api/v2/detections/:id- Get detection detailsGET /api/v2/species- Get species information
Usage Guidance
This skill appears to do only what it says: query a BirdNET-Go server on the configured URL. Before installing, verify the config file's URL points to a trusted local device (the default 192.168.1.50 is a LAN address). If you set the URL to a public/unknown host, that host will receive your queries and any returned data — only use endpoints you trust. Review the included scripts if you want to confirm there are no additional network calls or writes, and ensure curl/jq are available on the system.
Capability Analysis
Type: OpenClaw Skill
Name: birdnet
Version: 1.0.0
The skill bundle is a legitimate wrapper for the BirdNET-Go API. It uses standard OpenClaw credential management (`~/.clawdbot/credentials/birdnet/config.json`) to configure the API URL, defaulting to a local IP. The `scripts/birdnet.sh` script uses `curl` for API interaction and `jq` for JSON parsing and output formatting. User inputs are handled safely, with `jq --arg` for search queries and explicit URL encoding (`jq -sRr @uri`) for species names, preventing injection vulnerabilities. There is no evidence of data exfiltration, malicious execution, persistence, or prompt injection against the agent in `SKILL.md`.
Capability Assessment
Purpose & Capability
Name/description match the behavior: the script queries BirdNET-Go API endpoints. Required binaries (curl, jq) are appropriate and no unrelated credentials, files, or services are requested.
Instruction Scope
SKILL.md and scripts/birdnet.sh limit actions to reading a single config file (~/.clawdbot/credentials/birdnet/config.json) for the API URL and performing read-only GET requests against that API. There are no instructions to read unrelated files, modify system settings, or transmit data to third-party endpoints.
Install Mechanism
No install spec — instruction-only with a small helper script. Nothing is downloaded or extracted by the skill itself.
Credentials
The skill requires no environment variables or credentials. It reads a single well-scoped config path in the user's home directory; this is proportional to its purpose.
Persistence & Privilege
always is false and the skill does not request persistent platform privileges or modify other skills or system-wide settings. It only reads a user config file and makes network requests to the configured URL.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install birdnet - After installation, invoke the skill by name or use
/birdnet - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of the BirdNET-Go integration skill.
- Query BirdNET-Go for recent bird detections, detection details, and species information.
- Search detections by species name or get summary of today's activity.
- Simple local setup with no API key required.
- Uses standard command-line tools: curl and jq.
- Outputs detection info including confidence, verification, and timestamps.
Metadata
Frequently Asked Questions
What is Birdnet?
Query BirdNET-Go bird detections. View recent birds, search by species, get detection details. It is an AI Agent Skill for Claude Code / OpenClaw, with 1683 downloads so far.
How do I install Birdnet?
Run "/install birdnet" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Birdnet free?
Yes, Birdnet is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Birdnet support?
Birdnet is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Birdnet?
It is built and maintained by rappo (@rappo); the current version is v1.0.0.
More Skills