openpot-awareness
Teaches this agent how to serve content to the OpenPot iOS client — cards, apps, page captures, calendar, voice, chat persistence, and onboarding
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/almnotai/openpot-awarenessOpenPot Awareness Skill
You are connected to OpenPot — a native iOS app that serves as a command center for AI agents. OpenPot has configurable tabs: Chat (always on), Pulse (notification cards), Calendar, Apps, Terminal, and Agents (always on). Users choose which tabs to display in Settings — not every user will have all tabs visible.
Three Output Surfaces
| Surface | When to use | How |
|---|---|---|
| Chat | Default. Conversations, answers, follow-ups. | Normal chat response |
| Pulse cards | Proactive output: reports, alerts, briefs. | POST /api/cards |
| Web apps | Persistent tools the user returns to. | Build HTML, serve via /api/apps |
Default to chat. Use cards for output the user did not ask for in the current conversation. Use apps only when the user requests a persistent tool.
Decision Framework — Chat vs. Card vs. App
| Situation | Surface | Why |
|---|---|---|
| User asked a question | Chat | They're in a conversation. Answer there. |
| Cron job produced output | Card | User didn't ask. Push it to Pulse. |
| Alert threshold crossed | Card | Proactive. User needs to know. |
| User asked for a persistent tool | App | They want something that lives in their toolkit. |
| User asked about a previous card | Chat | They're referencing it in conversation. |
| Scheduled digest or rollup | Card | Proactive summary, not a conversation. |
When in doubt, use chat. Cards and apps are for specific use cases.
Triggers
Activate this skill when:
- User says "OpenPot sync" — run the sync process (see Sync section)
- User sends a page capture (message contains
---PAGE CAPTURE CONTEXT---) — see Page Captures section - User asks about setting up OpenPot — see Onboarding section
- User asks about calendar, voice, chat persistence, or building an app — see the relevant section below
- User asks "what OpenPot features do I support?" — check status
- User asks to "set up chat persistence" or "save my chats" — see Chat Persistence section
Pulse Cards
Pulse cards are proactive notifications you push to the user's OpenPot app. They appear in the Pulse tab as a card stream.
When to Create a Card
- Scheduled output (cron jobs): morning briefs, DCA signals, health checks
- Threshold alerts: a metric crossed a boundary the user cares about
- Proactive observations: something changed that the user should know
- Digests: summaries of activity over a time period
Do NOT create a card for content the user asked for in the current conversation. That belongs in chat.
Card API
Endpoint: POST /api/cards
Required fields:
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-almnotai-openpot-awareness": {
"enabled": true,
"auto_update": true
}
}
}