Shellphone Gateway
Skill by loserbcc
Why use this skill?
Connect your iPhone to your self-hosted AI agents securely with Shellphone Gateway. Enjoy encrypted, private, and local-first AI communication without third-party middleman servers.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/loserbcc/shellphone-gatewayWhat This Skill Does
The Shellphone Gateway is a privacy-focused WebSocket bridge that connects the OpenClaw AI framework directly to your iOS device. Unlike standard bot integrations that route your personal messages through third-party platforms like Telegram, Discord, or Slack, the Shellphone Gateway operates entirely on your local infrastructure. By establishing a direct, encrypted tunnel between your iPhone and your self-hosted AI agent, it ensures that your conversations, voice data, and context remain exclusively within your control. It features native support for local Ollama instances, meaning you can leverage LLMs running on your own hardware without external API fees, while also providing free, integrated text-to-speech and automatic speech recognition services via ScrappyLabs.
Installation
To begin, ensure you have Docker installed. Clone the official repository from the OpenClaw skill registry or the main project repository using git clone https://github.com/loserbcc/openclaw-gateway.git. Once inside the directory, execute docker compose up to initialize the gateway. Alternatively, for Python environments, you may install via pip install openclaw-gateway. After the service starts, access the setup page at http://localhost:8770/setup to generate the connection credentials. You will need to join the Shellphone TestFlight beta, download the iOS client, and scan the provided QR code to complete the pairing process. You can also install the skill directly to your agent environment by running clawhub install openclaw/skills/skills/loserbcc/shellphone-gateway.
Use Cases
- Personal Voice Assistant: Use your iPhone as a microphone and speaker interface for a local LLM, allowing you to ask questions, transcribe notes, or manage reminders while keeping the audio data local.
- Private Research: Perform deep analysis of sensitive data on your home server without ever uploading files to a cloud-based chatbot provider.
- Home Automation: Control local IoT devices or scripts through voice commands spoken into your iPhone, routed securely through the gateway to your home server.
- Journaling: Use the speech-to-text functionality to dictate thoughts directly into a self-hosted markdown or note-taking agent for complete privacy.
Example Prompts
- "Record a quick note about my meeting today: we decided to pivot the design to the dark theme and prioritize accessibility audits."
- "Summarize the last few messages from my work chat and tell me if there are any urgent actions required."
- "Start a voice session: I want to practice my Spanish conversation for my upcoming trip to Madrid."
Tips & Limitations
- Security: Since this bypasses traditional platforms, you are responsible for securing your own gateway port. Ensure your server is not exposed to the public internet without a VPN or authenticated tunnel (like Tailscale) if you plan to use it outside your home network.
- Performance: The speed of your agent responses depends heavily on your local hardware. If using Ollama, ensure your machine has sufficient VRAM to handle simultaneous requests.
- Connectivity: The mobile app requires a stable connection to your server; if the gateway is offline, the app will lose its connection until the service restarts.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-loserbcc-shellphone-gateway": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access