abe-fail2ban-reporter
/install abe-fail2ban-reporter
fail2ban 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 \x3Cip>
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.
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install abe-fail2ban-reporter - After installation, invoke the skill by name or use
/abe-fail2ban-reporter - Provide required inputs per the skill's parameter spec and get structured output
What is abe-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 I... It is an AI Agent Skill for Claude Code / OpenClaw, with 62 downloads so far.
How do I install abe-fail2ban-reporter?
Run "/install abe-fail2ban-reporter" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is abe-fail2ban-reporter free?
Yes, abe-fail2ban-reporter is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does abe-fail2ban-reporter support?
abe-fail2ban-reporter is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created abe-fail2ban-reporter?
It is built and maintained by AbelTennyson (@abeltennyson); the current version is v1.0.0.