Agents tab → Add Agent → enter your gateway URL (ws://your-ip:18789) and auth token → Save.
Tell your agent (via Telegram, Slack, or any channel): "Approve the OpenPot device." One-time step — after approval, OpenPot connects automatically.
Say: "Install the OpenPot Awareness Skill" then "OpenPot sync." Your agent configures itself for all supported features.
Add both a LAN route (home WiFi) and a Tailscale route (cellular/remote). OpenPot switches automatically based on which is reachable.
Tap and hold the mic button to speak. Transcribed on-device — audio never leaves your phone.
Your agent speaks back via ElevenLabs TTS. Set your API key in Settings, choose a voice per agent in the Agents tab.
Messages are stored locally. With a backend server, messages are also backed up to PostgreSQL — surviving reinstalls and working across devices.
Messages from the Calendar "Ask Agent" action, Terminal chat strip, and other tabs all appear in Chat. It's your complete conversation history.
Report cards (health checks, DCA signals, briefings) open into a full detail view with markdown formatting and action buttons.
Quick-triage cards you've seen. They're removed from the stream.
Cards are organized by category: briefing, system, finance, calendar, projects, health, entertainment. Your agent creates new categories as needed.
Year — 12-month overview with event dots. Tap a month to zoom in.
Month — day grid with colored indicators. Tap to expand, long-press to add an event.
Agenda — chronological list from today forward.
External calendars — Google Calendar, Apple Calendar, CalDAV, or any ClawHub calendar skill your agent uses. All feed into one unified display.
Agent calendar — events your agent creates in conversation, shown with a gold accent.
Your events — add events directly with the + button or long-press on a date.
Long press any event to: Ask your agent about it, edit (local events), delete (local events), or copy details.
Your agent creates calendar events using a special :::calendar format in chat messages. The event appears on your Calendar tab with a gold accent. Your agent always asks permission first — it never adds events silently.
If your agent doesn't create calendar events correctly at first, coach it: "When I ask you to remember a date, use the :::calendar format to put it on my OpenPot calendar." The agent learns the format from the OpenPot Awareness Skill, but a reminder helps.
Every time you interact with the Calendar tab, OpenPot quietly sends your today/tomorrow schedule to your agent. It absorbs this silently and uses it to answer schedule questions naturally.
Tell your agent what you need. It confirms the details, builds a self-contained HTML app, and it appears in your grid automatically.
Tap to open full-screen. Long press to move to the App Drawer (archive) or delete. Pull down to refresh and pick up new apps.
The rightmost page is your App Drawer — a holding area for less-used apps. Long press in the Drawer to move an app back to your main grid.
Tap the key icon in the Terminal status bar → Copy your SSH public key → Send it to your agent → It adds the key to authorized_keys. One-time step.
Terminal connects to whatever host your gateway is using — LAN at home, Tailscale away. It follows the active connection automatically.
SSH Terminal currently works on LAN connections. Tailscale SSH support is in development.
Each agent appears in the dock at the bottom. Tap to switch — the entire app context changes to that agent's chat, cards, apps, and calendar.
Each agent supports multiple connection routes (LAN + Tailscale). OpenPot tries routes in priority order. Swipe or long press to edit or delete routes.
Tap the OpenPot Sync button to refresh your agent's skill and reconfigure features. The agent uninstalls and reinstalls the latest skill version.
Each agent can have its own color theme. Pick from the swatches in the agent's detail view to personalize the chat appearance.
1. Get an API key at elevenlabs.io
2. Settings → Voice Output → enter the API key
3. Agents tab → tap agent → Voice → enter a Voice ID
Each agent can have its own voice. Browse voices at elevenlabs.io/voice-library.
ElevenLabs — high-quality, requires API key. System Voice — free Apple TTS, works offline. Off — text only.
Toggle which tabs appear: Pulse, Calendar, Apps, Terminal. Chat and Agents are always present. Customize the app to your workflow.
Direct connection to your server. No cloud relay, no third-party data handling. Your conversations stay between you and your hardware.
The more context you give your agent, the more useful OpenPot becomes. Tell it about your schedule, your interests, your routines. It learns and adapts.
Check your address starts with ws:// not http://. Confirm port is 18789. If using Tailscale, make sure the Tailscale app is running on your phone.
You need Tailscale for remote access. LAN addresses (192.168.x.x) only work on your home network. Install Tailscale on both your server and your phone.
Tell your agent: "Approve the OpenPot device." Or on the server: openclaw devices approve
Your agent needs an HTTP server on port 8000 with card endpoints. Tell your agent: "OpenPot sync" — it will check what's needed.
Your agent needs a calendar endpoint configured. Run "OpenPot sync". For Google Calendar, your agent will walk you through OAuth setup. Calendar skills from ClawHub also work — any skill that feeds events into the unified endpoint.
Some Google Calendar events contain HTML in the notes field. Your agent should strip HTML before serving events. Tell your agent about this issue and run "OpenPot sync" to update the skill.
Mic: Check iOS Settings → Privacy → Speech Recognition → enable OpenPot.
Playback: Check ElevenLabs API key in Settings. Check Voice ID is set per-agent in the Agents tab.
Verify your SSH public key is on the server (tap key icon → copy → send to agent). Terminal currently works on LAN. Tailscale SSH is in development.
OpenPot waits up to 8 seconds for a connection, then lets you in regardless. If you have no network at all, the app opens after the timeout with an offline indicator.
OpenPot connects directly to your server. No data passes through Anthropic, Apple, or any third party. Your conversations stay between you and your hardware.
Your phone authenticates with a cryptographic key pair generated on first launch. No passwords transmitted over the network.
Voice input is transcribed by Apple's on-device recognition. Audio never leaves your phone.
No tracking, no telemetry, no crash reporting services. Zero data collection by the app developer.