Aegisclaw

AegisClaw - 金甲龙虾 (Binance Security & Profit Guardian)

🦞 A defensive AI agent based on the principle of least privilege and Binance sub-account ecosystem, focusing on low-risk automated asset management and arbitrage.

When to Use This Skill

Use this skill when the user asks to:

• Check Binance account security status
• Scan for idle assets and dust
• Monitor funding rate arbitrage opportunities
• Perform dust sweeps (convert small balances to BNB)
• Generate weekly profit reports
• Initialize or configure Binance API connection

Commands

Required Environment Variables

The skill requires the following environment variables (set via .env file or system environment):

• BINANCE_API_KEY - Binance API Key (required)
• BINANCE_API_SECRET - Binance API Secret (required)
• BINANCE_TESTNET - Whether to use testnet (optional, default: false)

Key Features

🛡️ Security Fence

• Sub-account sandbox isolation - Recommended to use independent sub-accounts
• API permission self-check - Automatically detect and warn of dangerous permission configurations
• Operation firewall - Slippage limits, trading frequency control

💰 Profit Engine

• Launchpool/Megadrop monitoring - Intelligent scan for new mining opportunities
• Automatic dust conversion - Automatically convert small assets to BNB (Dust Sweeper)
• Funding rate arbitrage - Risk-free arbitrage between spot and futures

📊 Data Statistics

• Balance snapshot recording - Automatically save daily asset snapshots
• Trade history tracking - SQLite database persistence
• Weekly profit reports - One-click generate and share profit reports

Security Recommendations

1. Use Sub-accounts: Create a sub-account with only 500-1000 USDT for operations. Do not use main accounts.

2. Limit API Permissions:

   • ✅ Enable: Spot Trading (SPOT)
   • ❌ Disable: Withdrawals (WITHDRAW)
   • ❌ Disable: Futures Trading (FUTURES)

3. Bind IP Whitelist: Restrict API to access from specific IPs only. Regularly check IP whitelist.

4. Control Fund Scale: Sub-account funds recommended within 1000 USDT. Use idle funds that won't affect daily life.

Usage Flow

Initial Setup

1. Initialize with API credentials: /aegisclaw init <api_key> <api_secret>
2. Run security check: /aegisclaw check
3. Verify account type and permissions

Daily Operations

1. Scan assets: /aegisclaw scan
2. Check arbitrage opportunities: /aegisclaw arbitrage
3. Execute dust sweep if needed: /aegisclaw dust

Weekly Review

1. Generate weekly report: /aegisclaw report
2. Review profit/loss and asset distribution

Error Handling

• Invalid API credentials: The skill will report initialization failure and prompt to check API key and secret
• Permission denied: If API lacks required permissions, the skill will warn and suggest adjusting settings
• Rate limit exceeded: The skill will notify you to retry later
• Network error: The skill will attempt one retry before asking user to try again later

Integration Notes

This skill integrates with OpenClaw through the plugin interface in openclaw_plugin/plugin.py. It can be called via:

• Direct commands in chat interfaces
• Scheduled tasks via cron jobs
• Automated workflows with other skills

Key Safety Points

• Never share or expose API keys or secrets in logs or user-facing messages
• Always validate permissions before executing trading operations
• Use sub-accounts with limited funds for safety
• Monitor account balance regularly and set reasonable limits
• This skill is designed for low-risk operations - avoid high-risk trading strategies

Repository & Support

• GitHub: https://github.com/hyy2099/aegisclaw
• License: MIT
• Author: hyy2099

🦞 AegisClaw - Your Binance risk-free profit guardian and asset protector