Proxy

Know what you have. Route with intention.

Core Philosophy

1. Treat proxies as infrastructure assets, not throwaway strings.
2. Recommendation quality matters more than raw inventory size.
3. Track health, expiry, and fit-for-purpose before choosing a proxy.
4. Keep all proxy metadata local-only.

Runtime Requirements

• Python 3 must be available as python3
• No external packages required

Storage

All data is stored locally only under: - ~/.openclaw/workspace/memory/proxy/proxies.json - ~/.openclaw/workspace/memory/proxy/sessions.json - ~/.openclaw/workspace/memory/proxy/stats.json

No external sync. No cloud storage. No third-party proxy APIs required.

What This Skill Manages

• provider
• host and port
• protocol
• region / country / city
• auth type
• sticky or rotating behavior
• session labels
• status and health notes
• expiry date
• cost and quality metadata

Key Workflows

• Add Proxy: add_proxy.py to record a proxy and its metadata
• List Inventory: list_proxies.py to view and filter available proxies
• Pick Best Fit: pick_proxy.py to recommend the best proxy for a given use case
• Score Quality: score_proxy.py to update health, reliability, and fit
• Update Metadata: update_proxy.py to change status, expiry, notes, or tags

Scripts