Why do AI agents need AiTun?

AI agents that build web pages or APIs locally have no way to share them publicly, and they hit walls at email or SMS verification. AiTun gives agents the three missing channels: a one-command public URL for local services, receive-only mailboxes for verification emails, and SMS-code phones readable via API.

Do I need to sign up for a basic tunnel?

No. pip install aitun, start your local service, then run aitun -p 8080 — you get a public URL like https://aitun.cc/abc123 valid for 24 hours, no account needed. Permanent subdomains and mailboxes require a free account.

What is an agent access key (aitagt_)?

An agent access key is an account-level token that lets an AI agent act on your behalf with scoped permissions: subdomain:read/create/delete/renew, mailbox:read/create/delete/renew, sms:read/create/delete/renew and token:read. Create one in Console → Agent access, set scopes and optional expiry, and pass it as a Bearer token to /aitun-api endpoints.

Is there a skill document my agent can load?

Yes. The complete usage guide for agents is published at https://aitun.cc/aitun-tunnel-skill.md — point your agent (OpenClaw, Claude, ChatGPT, or any tool-calling harness) at that URL and it can start creating tunnels immediately.

Which AI tools work with AiTun?

Any tool-calling agent or shell access works: OpenClaw, Claude Code, ChatGPT with code interpreter, Cursor, Aider, CI pipelines, cron jobs — if it can run a shell command or an HTTP request, it can use AiTun tunnels, mailboxes and SMS phones.

What does AiTun cost for agents?

Trial tunnels are free without an account. Every free account includes 5 subdomains, 5 mailboxes and 5 SMS phones; extra slots are $1.00 each via PayPal.

AiTun for AI Agents — One-Command Tunnels, Mail & SMS

AiTun for AI Agents

Let AI agents expose their locally-built web pages to the public internet with a single command. AiTun provides instant secure tunnels that give local services a public URL, making it easy for AI agents to share their work.

🤖 How It Works

When an AI agent (like OpenClaw, Claude, or ChatGPT) builds a web page locally, it typically has no way to share it publicly. AiTun solves this by creating an instant secure tunnel that gives the local page a public URL. The agent simply installs aitun, starts a tunnel, and shares the URL with the user. No configuration, no sign-up required for basic tunnels.

Quick Integration

# 1. Install aitun (pip recommended, cross-platform, bundles the binary)
pip install aitun

# Or one-line install script (Linux/macOS)
curl -fsSL https://aitun.cc/install.sh | bash

# Windows (PowerShell)
irm https://aitun.cc/install.ps1 | iex

# 2. Serve the local web page
python3 -m http.server 8080 --directory /path/to/site

# 3. Create a tunnel (no sign-up needed)
aitun -p 8080

# Result: Your site is live at https://aitun.cc/abc123

# TCP-only mode (SSH/RDP without HTTP port)
aitun -k TOKEN --tcp-ports 22
                

API Integration for AI Agents

AiTun provides a simple REST API that AI agents can use programmatically to check subdomain availability and register custom domains for permanent URLs.

# Check subdomain availability
curl https://aitun.cc/aitun-api/subdomain/check/myapp

# Register a custom subdomain (requires auth token)
curl -X POST https://aitun.cc/aitun-api/subdomain/register -H "Authorization: Bearer YOUR_TOKEN" -H "Content-Type: application/json" -d '{"name":"myapp","domain_base":"t.aitun.cc"}'
                

🌐 Custom Subdomain

myapp.t.aitun.cc

⚡ Free Tunnel

No sign-up needed. Instant proxy URL (path-based routing), valid for 24 hours, auto-renewed on restart.

aitun.cc/abc123

🔒 Token-Based Auth

Use -k TOKEN flag with your auth token. Tokens can be renewed from the dashboard.

aitun -k TOKEN -p 8080

🔌 TCP-Only Mode

Forward SSH, RDP, or databases without a local HTTP port. Omit -p and use --tcp-ports only.

aitun -k TOKEN --tcp-ports 22

🔄 P2P + Relay

Supports P2P direct connection with automatic relay fallback. Low latency, high reliability.

aitun -p 8080 --p2p

🤖

ClawHub Skills for AI Agents

AiTun publishes 9 specialized skills on ClawHub, the skill registry for OpenClaw AI agents. Install the skill matching your use case, and your AI agent can expose local services to the internet with a single command.

# Install any AiTun skill for your AI agent
clawhub install aitun-tunnel
clawhub install sendfile
clawhub install webhook-receiver
                

🚇 aitun-tunnel

Expose local web pages and HTTP services to the public internet. The core tunneling skill for sharing any local service.

View on ClawHub →

📁 sendfile

Send files to users in chat via temporary download links. P2P or relay delivery, no size limits, works in any browser.

View on ClawHub →

🔗 webhook-receiver

Receive external webhooks and callbacks in real time. GitHub, Stripe, OAuth, form submissions — all routed to your local handler.

View on ClawHub →

👀 live-preview

Share a live preview of a website under development with hot-reload support. Users see your changes as you iterate.

View on ClawHub →

🔌 remote-api

Expose a local API service for external testing and integration. Share REST, GraphQL, or any HTTP API instantly.

View on ClawHub →

✏️ collab-edit

Real-time collaborative editing and whiteboarding. Co-edit code, documents, or drawings with users in real time.

View on ClawHub →

📡 iot-bridge

Bridge IoT devices to the cloud. Expose local MQTT brokers, device dashboards, and HTTP APIs so remote devices can connect, report data, and receive commands.

View on ClawHub →

🖥️ sshtunnel

Expose local SSH servers for remote access via TCP tunnel. Provide SSH access to dev machines, servers, or containers behind NAT/firewall.

View on ClawHub →

💻 rdptunnel

Expose local RDP (Remote Desktop) servers for remote desktop access via TCP tunnel. Connect to Windows machines, xrdp Linux desktops, or VDI instances behind NAT/firewall from anywhere on the internet.

View on ClawHub →

⬇️ Download SKILL.md View All on ClawHub

📧

Agent Email Skill — One-Command Email for AI Agents

Agent Email is an open REST API for agents that need to receive sign-up / verification emails. Every xxx@aitun.cc mailbox has its own aitm_ key — with it, one command returns the latest 10 emails (or the latest n with ?n=N). Storage is text-only with attachments auto-purged, so verification codes are always machine-readable.

# ONE command: latest 10 emails (add ?n=N for the latest N)
curl -s -H "Authorization: Bearer aitm_XXX" "https://aitun.cc/aitun-api/mail/recent?n=10"

# Read the full text of one email
curl -s -H "Authorization: Bearer aitm_XXX" "https://aitun.cc/aitun-api/mail/message/{EMAIL_ID}"

# Mailbox create / delete / list (agent token, mailbox:* scopes):
# full reference at https://aitun.cc/api
                

🔑 aitm_ mailbox key

Per-mailbox token. Read-only: fetch the latest 10 (or n) emails and full message text. Manage it in the dashboard Mailboxes tab.

🤖 aitagt_ agent key

Account-level agent token. With mailbox:create / mailbox:delete / mailbox:read scopes, agents can register and manage mailboxes on your behalf.

🔒 Receive-only & safe

No outbound mail exists in the system. Latest 10 text emails kept per mailbox, attachments stripped automatically.

📱

Agent SMS Skill — Receive-Code Phones for AI Agents

Agent SMS lets an AI agent receive SMS verification codes through a real phone number you own. Register your number on the Agent SMS page, install the open-source aitunSMS Android app on the phone, and every incoming SMS is pushed to aitun.cc — deduplicated, rolling 10-message storage. Each phone gets its own atsms_ key: one command returns the latest verification texts, ready for sign-up flows that require a phone.

# ONE command: latest 20 SMS (dual-SIM: latest 10 per number, each tagged with its phone)
curl -s -H "Authorization: Bearer atsms_XXX" "https://aitun.cc/aitun-api/sms/recent?n=20"

# Read the full text of one SMS
curl -s -H "Authorization: Bearer atsms_XXX" "https://aitun.cc/aitun-api/sms/message/{SMS_ID}"

# SMS token create / list / delete (agent token, sms:* scopes):
# POST /aitun-api/sms/register {}   (numbers auto-classify from the app's pushes)
# full reference at https://aitun.cc/api
                

🔑 atsms_ phone key

Per-phone token. Fetch the latest 10 (or n) SMS and full message text. Also used by the aitunSMS Android app to push new messages.

🤖 aitagt_ agent key

Account-level agent token. With sms:create / sms:read / sms:delete scopes, agents can register phones and read received codes on your behalf.

📱 Your own number

This is NOT a virtual-number rental — it is your real SIM. The phone runs aitunSMS and pushes only what it receives; you can revoke the key anytime.

📱 Open the Agent SMS page ⬇️ Download aitunSMS.apk

What the Skill Does for AI Agents

1️⃣

Install & Detect

Agent downloads the aitun client binary and verifies it is available on the system PATH.

2️⃣

Start Local Server

Agent spins up a local HTTP server to serve the built web page or application.

3️⃣

Create Tunnel

Agent runs aitun -p 8080 to get an instant public URL. For TCP-only (SSH/RDP), use aitun -k TOKEN --tcp-ports 22. No registration required for free tunnels.

4️⃣

Share with User

Agent delivers the public URL to the user, who can open it in any browser on any device.

Common Use Cases

Web Development

Share locally built websites with clients for instant preview and feedback.

API Testing

Expose local APIs for webhook testing and third-party integration development.

AI Agent Demos

Let AI agents showcase their generated applications in real-time to users.

IoT & Devices

Access IoT device dashboards and services running on local networks remotely.

⚠️ Important: Free tunnels expire after 24 hours. For permanent URLs, register a custom subdomain at the homepage subdomain search.