> ## Documentation Index
> Fetch the complete documentation index at: https://docs.opensink.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenClaw Skills Pack

> A growing collection of OpenSink integrations for OpenClaw agents — starting with activity logging.

## Overview

The **OpenSink Skills** pack bundles multiple OpenSink integrations into a single [OpenClaw](https://openclaw.ai) skill. One install, multiple tools.

> **Looking for agent memory?** That's a separate skill — see [OpenClaw Memory Skill](/integrations/openclaw-memory).

## Activity Logger

Log significant agent actions to OpenSink as [Activities](/agents/activities). Creates an inspectable timeline visible in the OpenSink dashboard — perfect for audit trails, observability, and debugging.

### What gets logged

| Type                | When to use                              |
| ------------------- | ---------------------------------------- |
| `message`           | Agent produced output or progress update |
| `sink_item_created` | Agent wrote data to a Sink               |
| `state_updated`     | Session 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

<Tabs>
  <Tab title="ClawHub">
    ```bash theme={null}
    clawhub install opensink-skills
    ```
  </Tab>

  <Tab title="Manual">
    ```bash theme={null}
    git clone https://github.com/opensinkai/openclaw-skills.git
    cp -r openclaw-skills ~/.openclaw/skills/opensink-skills
    ```
  </Tab>
</Tabs>

## Setup

<Steps>
  <Step title="Get an API key">
    Sign up at [app.opensink.com](https://app.opensink.com) and create an API key.
  </Step>

  <Step title="Set your API key">
    ```bash theme={null}
    export OPENSINK_API_KEY="your-api-key"
    ```

    Add it to your agent's `TOOLS.md`:

    ```markdown theme={null}
    ## OpenSink
    - **API Key:** `osk_...`
    ```
  </Step>

  <Step title="Create an agent (first time only)">
    The skill can create an OpenSink agent for you by name:

    ```bash theme={null}
    bash scripts/agent.sh create "My Agent"
    ```

    This returns the agent ID — the skill stores it for future use.
  </Step>
</Steps>

## Usage

Once installed, the agent uses the skill automatically when it needs to log actions. You can also run the script directly:

```bash theme={null}
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:

| Integration        | Description                                       |
| ------------------ | ------------------------------------------------- |
| **Input Requests** | Structured human-in-the-loop approval workflows   |
| **Knowledge Base** | Read from curated Sinks as shared agent knowledge |
| **Session Sync**   | Log OpenClaw conversations to OpenSink Sessions   |

## OpenSink primitives used

| Primitive                           | Purpose                                |
| ----------------------------------- | -------------------------------------- |
| [Activities](/agents/activities)    | Structured event log for agent actions |
| [Sessions](/core-concepts/sessions) | Context for activity grouping          |

## Requirements

* `curl`
* An [OpenSink](https://opensink.com) account with API access

## Source

<CardGroup cols={2}>
  <Card title="GitHub" icon="github" href="https://github.com/opensinkai/openclaw-skills">
    Source code and contributions
  </Card>

  <Card title="ClawHub" icon="download" href="https://clawhub.ai">
    Install via ClawHub
  </Card>
</CardGroup>