home / skills / openclaw / skills / anyone-proxy

anyone-proxy skill

needs review

/skills/ra3ka/anyone-proxy

This skill routes requests through the Anyone Protocol VPN via a local SOCKS5 proxy to mask your IP.

npx playbooks add skill openclaw/skills --skill anyone-proxy

Review the files below or copy the command above to add this skill to your agents.

Files (2)

SKILL.md

1.9 KB

---
name: anyone-proxy
homepage: https://anyone.io
description: This skill enables IP address masking and accessing hidden services on the Anyone Network. Route requests through the Anyone Protocol VPN network using a local SOCKS5 proxy.
metadata:
  clawdbot:
    requires:
      packages:
        - "@anyone-protocol/anyone-client"
---

# Anyone Protocol Proxy

This skill enables Clawdbot to route requests through the Anyone Protocol network.

## How It Works

The skill uses the `@anyone-protocol/anyone-client` NPM package to:
1. Start a local SOCKS5 proxy server (default port: 9050)
2. Create encrypted circuits through the Anyone Network
3. Route traffic through these circuits
4. Return responses while keeping the origin IP hidden

# Setup

## Install anyone-client
```bash
npm install -g @anyone-protocol/anyone-client
```

## Start the proxy
```bash
npx @anyone-protocol/anyone-client -s 9050
```

## Usage
Once the proxy is running, route requests through it:
```bash
# Using curl to verify IP
curl --socks5-hostname localhost:9050 https://check.en.anyone.tech/api/ip
```
```javascript
import { Anon } from "@anyone-protocol/anyone-client";
import { AnonSocksClient } from "@anyone-protocol/anyone-client";

async function main() {
    const anon = new Anon();
    const anonSocksClient = new AnonSocksClient(anon);

    try {
        await anon.start();
        // Wait for circuits to establish
        await new Promise(resolve => setTimeout(resolve, 15000));
        
        const response = await anonSocksClient.get('https://check.en.anyone.tech/api/ip');
        console.log('Response:', response.data);
        
    } catch(error) {
        console.error('Error:', error);
    } finally {
        await anon.stop();
    }
}

main();
```

## Notes

- First connection may take up to 30 seconds while circuits are established
- The proxy persists across requests once started

Overview

This skill enables IP address masking and access to hidden services by routing requests through the Anyone Protocol VPN network using a local SOCKS5 proxy. It provides a lightweight, programmatic way to create encrypted circuits and persist a local proxy for anonymized outbound traffic. The skill is designed to integrate with CLI tools or applications that support SOCKS5 proxying.

How this skill works

The skill starts a local SOCKS5 proxy and builds encrypted circuits through the Anyone Network to route outgoing connections. Traffic forwarded to the proxy is sent over those circuits so the origin IP is hidden and responses are returned to the client. A client library can also control the lifecycle of the proxy and wait for circuits to establish before sending requests.

When to use it

Testing or scraping third-party endpoints without exposing your server IP
Accessing services reachable only through the Anyone Network or hidden endpoints
Routing CLI tools (curl, git, package managers) through a local anonymizing proxy
Temporarily masking traffic from a development environment or CI job
Isolating network requests in an application that needs optional anonymity

Best practices

Start the proxy once per host and reuse it across requests to avoid repeated circuit establishment delays
Allow 15–30 seconds after starting the proxy for circuits to build before sending sensitive requests
Use host-level controls and logging to ensure only intended traffic is routed through the proxy
Limit long-running sessions when anonymity is not required to reduce attack surface
Test with a harmless endpoint (like a check-ip API) to confirm correct routing before production use

Example use cases

Run curl with --socks5-hostname localhost:9050 to verify external IP is masked
Start the proxy from a Node.js script, wait for circuits, then perform HTTP requests through the AnonSocks client
Configure development tools to use localhost:9050 so all tool traffic is routed through the Anyone Network
Use the proxy in a CI job to archive or fetch resources while hiding the runner's IP
Access internal or hidden services exposed only over the Anyone Network from a local workstation

FAQ

How long does it take for the proxy to be ready?

Initial circuit establishment can take 15–30 seconds; subsequent requests use persistent circuits and are faster.

What port does the local proxy use?

The default local SOCKS5 proxy port is 9050, but the port can be changed when starting the client.