OpenClaw Mobile Companion App
Manage your AI gateway anywhere, anytime.
🧪 Alpha Testing • Features • Screenshots • Roadmap
iClaw is currently in alpha testing phase.
The source code will be officially released after the first stable version is completed. During this alpha phase, we are:
- 🧪 Testing core features and stability
- 🐛 Identifying and fixing bugs
- 🎨 Refining the user experience
- 📱 Preparing for public release
Note: The source code is not yet available in this repository. It will be published once we reach a stable release.
iClaw is an open-source mobile companion app designed for OpenClaw - the powerful AI agent framework. It provides a seamless mobile experience to manage, monitor, and interact with your OpenClaw gateway instances.
Whether you're running OpenClaw locally or on a remote server, iClaw gives you full control from your pocket - no additional backend services required.
- 📱 iOS & Android Support: Native apps for both platforms with consistent experience
- 🔍 Gateway Auto-Discovery: Automatically discover local OpenClaw gateways via mDNS/Bonjour
- 🦞 Multi-Gateway Management: Connect and switch between multiple gateway instances
- 💬 Multi-Session Chat: Manage multiple chat sessions with history synchronization
- 🔐 Privacy First: Connect directly to your own OpenClaw instance - no cloud middleman
- 🚀 Native Performance: Built with React Native + Expo for smooth mobile experience
- 🎨 Beautiful UI: Carefully crafted dark theme with the signature lobster-red accent
- 🌍 i18n Ready: Full Chinese and English support
iClaw integrates with OpenClaw's core features:
| Feature | Description | Docs |
|---|---|---|
| Gateway Authorization | Secure device pairing with Ed25519 authentication | Gateway Auth |
| iOS Node | Use your iOS device as a gateway node | iOS Node |
| Android Node | Use your Android device as a gateway node | Android Node |
| Gateway Protocol | WebSocket-based communication protocol | Protocol |
- Add multiple OpenClaw instances (local/remote)
- Gateway auto-discovery via mDNS/Bonjour
- One-tap switching between gateways
- QR code pairing for easy setup
- Secure credential storage with device-level encryption
- Real-time token consumption monitoring
- Model usage statistics and cost estimation
- Gateway health status at a glance
- Session count and activity overview
- Full-featured chat with Markdown rendering
- Code syntax highlighting
- Image attachment support
- Stream responses with real-time updates
- Chat history synchronization
- Multi-session management - create, switch, and manage multiple conversations
- Model management and default model selection
- Channel configuration (WhatsApp, Telegram, Discord, etc.)
- Skills and plugins management
- Cron job scheduling
- Advanced settings access
- Gateway Authorization via Ed25519 device identity
- TLS certificate fingerprint verification (TOFU model)
- Secure token storage via Keychain/Keystore
- Device pairing approval workflow
- Core chat functionality
- Multi-gateway management
- Gateway auto-discovery
- Model management
- Channel configuration
- Multi-session chat
- QR code pairing
- iOS Widgets
- Push notifications
- Background sync
- Tablet optimization
- 📦 First Stable Release: Source code publication
- 📱 App Store & Google Play: Official app distribution
- 🌐 Community Contributions: Open for pull requests
During the alpha phase, installation is available through:
- TestFlight (iOS): Coming soon
- Internal Testing (Android): Coming soon
The source code will be available for:
- Building from source
- Self-hosting
- Community contributions
| Category | Technology |
|---|---|
| Framework | React Native 0.83 |
| Meta-framework | Expo 55 |
| Routing | Expo Router |
| State Management | Zustand |
| i18n | i18next |
| Styling | Custom Tailwind-like system |
| WebSocket | Custom native module |
| Crypto | TweetNaCl (Ed25519) |
We welcome contributions from the community! However, during the alpha phase:
- 🐛 Report Bugs: Open an issue with detailed reproduction steps
- 💡 Suggest Features: Share your ideas in discussions
- 📝 Feedback: Help us improve the user experience
Once the source code is released, we'll accept:
- Code contributions via pull requests
- Documentation improvements
- Translations
This project is licensed under GPL-3.0 with Additional Terms.
- ✅ Free for personal and non-commercial use
- ✅ Open source contributions welcome
⚠️ Commercial use requires separate license⚠️ Derivative works must attribute iClaw and remain open source
For commercial licensing inquiries, please contact the OpenClaw team.
- OpenClaw - The AI agent framework this app is built for
- OpenClaw Docs - Official documentation
- Expo - The platform that makes React Native development delightful
- React Native - The framework powering cross-platform mobile apps
Built with ❤️ by the iClaw community
🦞 iClaw - Your AI gateway in your pocket
