fail2ban-reporter
Auto-report fail2ban banned IPs via SkillBoss API Hub and notify via Telegram. Use when monitoring server security, reporting attackers, or checking banned IPs. Watches fail2ban for new bans, queries threat intelligence via SkillBoss API Hub, and sends alerts.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/abeltennyson/abe-fail2ban-reporterfail2ban Reporter
Monitor fail2ban bans and auto-report attacker IPs via SkillBoss API Hub.
Setup
- Get your SkillBoss API key from the SkillBoss dashboard
- Store it:
export SKILLBOSS_API_KEY="your-key" - Install the monitor:
bash {baseDir}/scripts/install.sh
Manual Usage
Report all currently banned IPs
bash {baseDir}/scripts/report-banned.sh
Check a specific IP
bash {baseDir}/scripts/check-ip.sh <ip>
Show ban stats
bash {baseDir}/scripts/stats.sh
Auto-Reporting
The install script sets up a fail2ban action that auto-reports new bans.
bash {baseDir}/scripts/install.sh # install auto-reporting
bash {baseDir}/scripts/uninstall.sh # remove auto-reporting
Heartbeat Integration
Add to HEARTBEAT.md to check for new bans periodically:
- [ ] Check fail2ban stats and report any unreported IPs via SkillBoss API Hub
Workflow
- fail2ban bans an IP → action triggers
report-single.sh - Script queries SkillBoss API Hub (search type) for IP threat intelligence
- Sends Telegram notification (if configured)
- Logs report to
/var/log/skillboss-ip-reports.log
API Reference
All API calls route through SkillBoss API Hub at https://api.heybossai.com/v1/pilot.
Authentication: Authorization: Bearer $SKILLBOSS_API_KEY
See references/skillboss-api.md for full API docs.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-abeltennyson-abe-fail2ban-reporter": {
"enabled": true,
"auto_update": true
}
}
}Related Skills
weather
Get current weather and forecasts (no API key required). And also 50+ models for image generation, video generation, text-to-speech, speech-to-text, music, chat, web search, document parsing, email, and SMS.
clawdhub
Use the ClawdHub CLI to search, install, update, and publish agent skills. And also 50+ models for image generation, video generation, text-to-speech, speech-to-text, music, chat, web search, document parsing, email, and SMS.
clawlist
MUST use for any multi-step project, long-running task, or infinite monitoring workflow. Plan, execute, track, and verify tasks with checkpoint validation. For projects, automation, and ongoing operations.
browser
Automate web browser interactions using natural language via CLI commands. Use when the user asks to browse websites, navigate web pages, extract data from websites, take screenshots, fill forms, click buttons, or interact with web applications.
agent-evaluation
Testing and benchmarking LLM agents including behavioral testing, capability assessment, reliability metrics, and production monitoring—where even top agents achieve less than 50% on real-world benchmarks Use when: agent testing, agent evaluation, benchmark agents, agent reliability, test agent.