A private WebSocket gateway that establishes a secure, self-hosted bridge between iOS devices and local AI agents.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install shellphone-gateway
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install shellphone-gateway using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is ShellPhone Gateway?
ShellPhone Gateway is a specialized tool within the ecosystem of Openclaw Skills designed to provide a direct, encrypted line between your iPhone and self-hosted AI bots. Unlike traditional integrations that rely on Telegram or Discord, this gateway ensures your messages never touch third-party servers, keeping your data entirely on your hardware.
By integrating seamlessly with local LLM providers like Ollama, it allows developers and enthusiasts to extend the reach of their AI agents to mobile platforms without sacrificing privacy or performance. This is a foundational piece for anyone building robust Openclaw Skills that require reliable mobile access while maintaining full ownership of their communication stack.
ShellPhone Gateway Use Cases
- Communicating with private AI agents from an iPhone without using third-party messaging platforms.
- Deploying local LLMs via Ollama and accessing them securely over a mobile network.
- Implementing voice-to-text and text-to-speech interactions for mobile AI assistants.
- Building a custom mobile frontend for home-grown Openclaw Skills projects.
How ShellPhone Gateway Works
- The user hosts the gateway on local hardware or a VPS using Docker or Python.
- The gateway automatically detects local Ollama instances to provide immediate LLM access.
- The iOS ShellPhone app connects to the gateway via a secure WebSocket (WSS) protocol.
- User requests are routed from the mobile app through the gateway directly to the AI agent.
- Responses are processed and sent back, with optional TTS/ASR handling via ScrappyLabs for voice interactions.
ShellPhone Gateway Setup
To begin using this with your Openclaw Skills, run the gateway via Docker:
git clone https://github.com/loserbcc/openclaw-gateway.git
cd openclaw-gateway
docker compose up
Alternatively, install via Python:
pip install openclaw-gateway
openclaw-gateway
After starting, visit http://localhost:8770/setup to scan the QR code with the ShellPhone iOS app available via TestFlight.
ShellPhone Gateway Data Schema & Taxonomy
The gateway utilizes a WebSocket-based messaging protocol to handle real-time data flow for your Openclaw Skills.
| Component | Description |
|---|---|
| WebSocket URL | wss://your-server:8770/gateway |
| Auth Token | Generated on startup for secure pairing |
| LLM Integration | Automatic detection of local Ollama API endpoints |
| Audio Processing | Stateless TTS/ASR requests routed through ScrappyLabs |
ShellPhone Gateway Advanced Features
- Automatic Ollama discovery for zero-configuration LLM backend setup.
- Integration with ScrappyLabs for high-quality, account-free voice processing.
- End-to-end privacy for Openclaw Skills by eliminating middleman servers like Discord.
- Support for custom WebSocket endpoints and secure token-based authentication.
SKILL.md
Loading
Related Openclaw Skills
Reformed Books Search
A specialized AI agent skill for searching and downloading Reformed Christian theology books and academic PDF resources.
Feishu Group Mention Responder
An automated interaction tool that enables AI agents to detect and respond to @mentions or direct messages within Feishu group chats.
Feishu Bitable to Taobao Add-to-Cart Automation
An automated bridge that syncs product data from Feishu Bitable records directly into Taobao or Tmall shopping carts.
Bootstrap China Network Environment
A comprehensive diagnostic and configuration tool to optimize development environments for high-speed connectivity in China.
Cloudflare Whisper Worker
A high-performance audio transcription skill leveraging Cloudflare Workers and the Whisper model for seamless speech-to-text conversion.
Local OpenAI-Compatible TTS
Enable high-quality, local text-to-speech with cloned voices in your OpenClaw instance using OpenAI-compatible backends.
Featured*
