Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
tpn-proxy 1.1.2 - Updated documentation to clarify that agents should use built-in HTTP tools (e.g., WebFetch) when fetching URLs through the proxy, rather than constructing shell commands. - Enhanced instructions on URL validation and proxy handling when performing web fetches. - Expanded and reworded some security and process notes in SKILL.md for clarity. - No functional/logic changes; update is documentation and guidance only.
What This Skill Does
Routes HTTP and HTTPS traffic through decentralized SOCKS5 proxies on the Tao Private Network, a Bittensor subnet (SN65) with exit nodes in 80+ countries. Supports datacenter and residential IP types. Authentication works via API key or x402 micropayments without an account.
x402 micropayment support lets autonomous agents generate proxies without an API key or account, paying per request in USDC on Base.
When to use it
- Checking what content a website serves to visitors in a specific country
- Verifying geo-restricted pricing or availability from a residential IP
- Testing regional CDN behavior and DNS routing
- Fetching public data that rate-limits by IP address
- Making anonymous web requests without a standing VPN subscription
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Fetch my IP address through a German exit node
- 1Validates country code as 'DE' and sets duration to 60 minutes (default)
- 2Calls POST /api/v1/proxy/generate with geo='DE', format='text', minutes=60
- 3Parses the returned socks5:// URI to extract host, port, username, and password
- 4Fetches https://ipv4.icanhazip.com through the proxy using socks5://
- 5Returns the German exit IP, full socks5h:// credential block, expiry time, and a ready-to-paste curl example
German exit IP address, structured SOCKS5 credential block with host/port/username/password/expiry, full socks5h:// URI, and curl example
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.