Proxy
Know what you have. Route with intention.
Core Philosophy
- Treat proxies as infrastructure assets, not throwaway strings.
- Recommendation quality matters more than raw inventory size.
- Track health, expiry, and fit-for-purpose before choosing a proxy.
- 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.pyto record a proxy and its metadata - List Inventory:
list_proxies.pyto view and filter available proxies - Pick Best Fit:
pick_proxy.pyto recommend the best proxy for a given use case - Score Quality:
score_proxy.pyto update health, reliability, and fit - Update Metadata:
update_proxy.pyto change status, expiry, notes, or tags
Scripts
| Script | Purpose |
|---|---|
init_storage.py | Initialize local storage files |
add_proxy.py | Add a proxy asset |
list_proxies.py | List and filter proxies |
score_proxy.py | Score reliability and quality |
pick_proxy.py | Recommend the best proxy for a task |
update_proxy.py | Update status, expiry, notes, or tags |