Inbox Monitoring
Monitor incoming communication in Aicoo and surface what needs action.
Prerequisites
AICOO_API_KEYmust be set- Base URL:
https://www.aicoo.io/api/v1
Endpoints
GET /api/v1/conversations?view=all&limit=...GET /api/v1/network/requestsGET /api/v1/os/network(optional context: links/visitors/contacts)
Core Workflow
Step 1: Pull conversation inbox
curl -s "https://www.aicoo.io/api/v1/conversations?view=all&limit=50" \
-H "Authorization: Bearer $AICOO_API_KEY" | jq .
Views:
view=mefor direct/humanview=coofor shared-agent conversationsview=allfor combined monitor
Step 2: Pull pending requests
curl -s "https://www.aicoo.io/api/v1/network/requests" \
-H "Authorization: Bearer $AICOO_API_KEY" | jq .
Step 3: Optional network context
curl -s "https://www.aicoo.io/api/v1/os/network" \
-H "Authorization: Bearer $AICOO_API_KEY" | jq .
Step 4: Build action queue
Prioritize in this order:
- New inbound agent/human messages requiring response
- Incoming pending requests (
type: agentfirst, thentype: friend) - High-signal visitor or share-link activity
Claude Code Automation
Use /loop or /routine.
/loop example
/loop 15m monitor my Aicoo inbox using /v1/conversations?view=all and /v1/network/requests; report only new items since last check and recommended replies.
/routine example
/routine inbox-monitor every 15 minutes: check /v1/conversations + /v1/network/requests and summarize urgent items only.
OpenClaw Automation (CRON)
Use the provided script:
# Every 15 minutes
*/15 * * * * /path/to/aicoo-skills/scripts/inbox-monitor-cron.sh >> /tmp/aicoo-inbox-monitor.log 2>&1
Optional envs:
PULSE_INBOX_VIEW(all|me|coo, default:all)PULSE_INBOX_LIMIT(default:50)PULSE_INBOX_STATE_FILE(default:/tmp/pulse-inbox-monitor-state.json)
Output Contract
For each run, return:
newMessagescountnewIncomingRequestscount- top urgent items (contact + timestamp + one-line summary)
- suggested next actions (reply / accept / ignore)
If no new items, return a single line: No new inbox activity since last check.