/install check-messages
Check Messages — Review What Your Aicoo Received
See all messages people sent to your agent, organized by conversation with contact info and timestamps.
Prerequisites
AICOO_API_KEYenvironment variable must be set- Base URL:
https://www.aicoo.io/api/v1
Workflow
Step 1: Get your identity (for filtering)
IDENTITY=$(curl -s "https://www.aicoo.io/api/v1/identity" \
-H "Authorization: Bearer $AICOO_API_KEY")
CALLER_ID=$(echo "$IDENTITY" | jq -r '.profile.userId')
USERNAME=$(echo "$IDENTITY" | jq -r '.profile.username')
Step 2: Fetch conversations
# All conversations (both direct human messages and shared-agent chats)
curl -s "https://www.aicoo.io/api/v1/conversations?view=all&limit=50" \
-H "Authorization: Bearer $AICOO_API_KEY" | jq .
Views:
view=me— direct messages to you (human-to-human)view=coo— messages people sent to your shared agentview=all— everything combined
Step 3: Fetch pending network requests
curl -s "https://www.aicoo.io/api/v1/network/requests" \
-H "Authorization: Bearer $AICOO_API_KEY" | jq .
Step 4: Parse and present
For each conversation, extract:
- Contact: who sent the message (name, username, or "anonymous visitor")
- Channel: direct (
me) or via shared agent (coo) - Messages: timestamp + content, newest first
- Unread: messages where
senderId != CALLER_ID
Group by conversation and present as:
Messages for @username
── Via Shared Agent (COO) ──────────────────────
1. @alice (Alice Chen) — 3 messages, latest: 2h ago
"What's the timeline for Project Alpha?"
"Can you share the API documentation?"
"Thanks, one more question about pricing..."
2. Anonymous (share link: For Investors) — 1 message, latest: 5h ago
"What's your current ARR and growth rate?"
── Direct Messages ─────────────────────────────
3. @bob (Bob Martinez) — 2 messages, latest: 1d ago
"Hey, can we sync on the sprint tomorrow?"
"Also, did you see the security review?"
── Pending Requests ────────────────────────────
4. @carol wants to connect (friend request) — 2d ago
Summary: 6 new messages across 3 conversations, 1 pending request
Step 5: Offer actions
For each item, suggest available actions:
| Situation | Suggested Action |
|---|---|
| Unread COO message | "Want me to draft a reply?" |
| Pending friend request | "Accept or decline @carol's request?" |
| Pending agent request | "Grant agent access to @carol?" |
| Interesting question from visitor | "Want to save this as a contact note?" |
Filtering Options
The user can narrow results:
- By channel: "just COO messages" →
view=coo - By time: "messages from today" → filter by timestamp
- By contact: "messages from alice" → filter by contact name/username
- Unread only: filter where
senderId != CALLER_ID
Error Handling
| Error | Action |
|---|---|
401 from /identity |
API key invalid — guide to settings page |
| Empty conversations list | "No messages yet. Share an agent link to start receiving messages." |
| Empty requests list | "No pending network requests." |
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install check-messages - After installation, invoke the skill by name or use
/check-messages - Provide required inputs per the skill's parameter spec and get structured output
What is Check Messages?
Use this skill when the user wants to see messages their Aicoo agent received, check what people asked, review conversation history, or see agent inbox activ... It is an AI Agent Skill for Claude Code / OpenClaw, with 44 downloads so far.
How do I install Check Messages?
Run "/install check-messages" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Check Messages free?
Yes, Check Messages is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Check Messages support?
Check Messages is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Check Messages?
It is built and maintained by Awassi (@xisen-w); the current version is v1.0.0.