Skip to main content

​
Overview

The OpenSink Skills pack bundles multiple OpenSink integrations into a single OpenClaw skill. One install, multiple tools.
Looking for agent memory? That’s a separate skill — see OpenClaw Memory Skill.

​
Activity Logger

Log significant agent actions to OpenSink as Activities. Creates an inspectable timeline visible in the OpenSink dashboard — perfect for audit trails, observability, and debugging.

​
What gets logged

TypeWhen to use
messageAgent produced output or progress update
sink_item_createdAgent wrote data to a Sink
state_updatedSession state changed
Think of activities as a captain’s log — milestones, not a transcript. If someone asks “what did the agent do today?”, your activities should tell the full story without the noise. Log these:
  • Task completed (“Generated weekly report for Q1”)
  • External interactions (“Sent deployment notification to Slack”)
  • Decisions made (“Escalated ticket #42 to engineering”)
  • Errors and recoveries (“API rate limited, retried 3x, succeeded”)
  • State changes (“Order #456 moved to shipped”)
Skip these:
  • Every chat message or reply
  • File reads and internal reasoning
  • Routine tool calls
  • Intermediate steps that don’t matter on their own
Rule of thumb: If you’d mention it in a daily standup, log it. If not, skip it.

​
Install

clawhub install opensink-skills

​
Setup

1

Get an API key

Sign up at app.opensink.com and create an API key.
2

Set your API key

export OPENSINK_API_KEY="your-api-key"
Add it to your agent’s TOOLS.md:
## OpenSink
- **API Key:** `osk_...`
3

Create an agent (first time only)

The skill can create an OpenSink agent for you by name:
bash scripts/agent.sh create "My Agent"
This returns the agent ID — the skill stores it for future use.

​
Usage

Once installed, the agent uses the skill automatically when it needs to log actions. You can also run the script directly: 
export OPENSINK_API_KEY="your-key"

# Create an agent (first time only)
AGENT_ID=$(bash scripts/agent.sh create "Mars")
export OPENSINK_AGENT_ID=$AGENT_ID

# Start a session
SESSION_ID=$(bash scripts/session.sh start)
export OPENSINK_SESSION_ID=$SESSION_ID

# Log activities
bash scripts/activity.sh log "Processed 12 emails, flagged 3 as urgent" "message"
bash scripts/activity.sh log "Daily report complete" "message" '{"emails_processed": 12, "flagged": 3}'

# List recent activities
bash scripts/activity.sh list

# Complete the session
bash scripts/session.sh status $SESSION_ID completed

​
Coming soon

More integrations are planned for this skill pack:
IntegrationDescription
Input RequestsStructured human-in-the-loop approval workflows
Knowledge BaseRead from curated Sinks as shared agent knowledge
Session SyncLog OpenClaw conversations to OpenSink Sessions

​
OpenSink primitives used

PrimitivePurpose
ActivitiesStructured event log for agent actions
SessionsContext for activity grouping

​
Requirements

  • curl
  • An OpenSink account with API access

​
Source

GitHub

Source code and contributions

ClawHub

Install via ClawHub