Aegis Protocol
/install aegis-protocol
Aegis Protocol 🛡️
Self-Healing Stability Monitor for AI Agents
Version: 0.12.6
Author: Dream
License: MIT
Features
- 20-Dimension Monitoring: System, services, AI agent, security, maintenance
- Auto Recovery: Terminate stuck sessions, restart services, compact context
- Health Scoring: Quantified health score (0-100)
- Healing Memory: Record and learn from recovery strategies
- Result Caching: 5-minute TTL for reduced system calls
Commands
aegis-protocol init
Initialize configuration file
aegis-protocol status
Show system health summary
aegis-protocol check
Run full health check
aegis-protocol heal
Execute automatic recovery
aegis-protocol config
View current configuration
Usage Examples
# Initialize
python3 aegis-protocol.py init
# Check health
python3 aegis-protocol.py check
# Auto recover
python3 aegis-protocol.py heal
# View config
python3 aegis-protocol.py config
Configuration
File: ~/.openclaw/workspace/.watchdog-config.json
{
"thresholds": {
"sessionTimeoutMinutes": 60,
"pm2RestartAlert": 50,
"diskUsagePercent": 90,
"memoryUsagePercent": 95,
"contextUsagePercent": 80
}
}
Monitoring Dimensions
| Category | Checks |
|---|---|
| System | CPU, Memory, Disk, Zombies, FD, Connections |
| Services | PM2, Nginx, Docker, Cron |
| AI Agent | Sessions, Context, Tasks, Loops |
| Security | SSL, Updates, Git |
| Maintenance | Backup, Cleanup, Network |
Health Score
| Score | Status |
|---|---|
| 90-100 | Excellent |
| 70-89 | Good |
| 50-69 | Warning |
| 0-49 | Critical |
Testing
# Unit tests
python3 -m pytest tests/ -v
# Coverage
python3 -m pytest tests/ --cov=aegis_protocol -v
Coverage: 82%
Tests: 20+ passing
Quality Metrics
| Metric | Value |
|---|---|
| Type hints | >90% |
| Test coverage | 82% |
| Documentation | 100% |
| Bugs | 0 |
Version History
v0.7.0 (2026-04-05)
- Result caching with 5-minute TTL
- Type hints >90% coverage
- Exception classification (4 types)
- 20-dimension monitoring
- Health scoring system
Aegis Protocol - The Never-Sleeping Guardian 🌀
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install aegis-protocol - 安装完成后,直接呼叫该 Skill 的名称或使用
/aegis-protocol触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Aegis Protocol 是什么?
Self-healing stability monitor for AI agents - 5 core checks + 15 extended checks, auto-recovery, health scoring. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 120 次。
如何安装 Aegis Protocol?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install aegis-protocol」即可一键安装,无需额外配置。
Aegis Protocol 是免费的吗?
是的,Aegis Protocol 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Aegis Protocol 支持哪些平台?
Aegis Protocol 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Aegis Protocol?
由 ankechenlab-node(@ankechenlab-node)开发并维护,当前版本 v0.12.9。