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

# OpenClaw Setup

> Install and configure the yoinkit skill

## Prerequisites

<Check>OpenClaw installed and configured</Check>
<Check>Active Yoinkit subscription</Check>
<Check>API token from Settings → OpenClaw</Check>

## Installation

<Steps>
  <Step title="Install the Skill">
    ```bash theme={null}
    # From ClawHub (coming soon)
    openclaw skill install yoinkit

    # Or from GitHub
    git clone https://github.com/seomikewaltman/yoinkit-openclaw-skill.git
    # Then add to your openclaw.json skills entries
    ```
  </Step>

  <Step title="Configure Your API Token">
    Add your Yoinkit API token to your OpenClaw configuration:

    ```bash theme={null}
    # Using the /config command in chat
    /config skills.yoinkit.env.YOINKIT_API_TOKEN "your-token-here"
    ```

    Or edit `~/.openclaw/openclaw.json` directly:

    ```json theme={null}
    {
      "skills": {
        "entries": {
          "yoinkit": {
            "path": "/path/to/yoinkit",
            "env": {
              "YOINKIT_API_TOKEN": "your-token-here"
            }
          }
        }
      }
    }
    ```
  </Step>

  <Step title="Verify Installation">
    Ask your assistant to test the connection:

    > "Test the yoinkit connection"

    Or run a simple command:

    > "What's trending on YouTube in tech?"
  </Step>
</Steps>

## Secure Token Storage

For enhanced security, use [openclaw-secure](https://github.com/seomikewaltman/openclaw-secure) to store your token in the system keychain:

```bash theme={null}
# Install openclaw-secure
npm install -g openclaw-secure

# Store your token securely
openclaw-secure store

# It will auto-discover and migrate your Yoinkit token
```

## Skill Configuration

The skill supports the following configuration options:

| Option                  | Default                              | Description                       |
| ----------------------- | ------------------------------------ | --------------------------------- |
| `YOINKIT_API_TOKEN`     | —                                    | Your Yoinkit API token (required) |
| `YOINKIT_API_URL`       | `https://yoinkit.ai/api/v1/openclaw` | API base URL                      |
| `YOINKIT_DEFAULT_LIMIT` | `10`                                 | Default result limit for searches |

## Talking to OpenClaw

You don't need to memorize commands. Just ask naturally:

<Tabs>
  <Tab title="Transcripts">
    > "Get me the transcript from this video: [https://youtube.com/watch?v=](https://youtube.com/watch?v=)..."

    > "Pull the transcript from that TikTok"

    > "What did MrBeast say in his latest video?"
  </Tab>

  <Tab title="Search">
    > "Find YouTube videos about AI tools for creators"

    > "What's Reddit saying about the fourth amendment lately?"

    > "Search Twitter for home automation discussions from this week"
  </Tab>

  <Tab title="Trending">
    > "What's trending on TikTok right now?"

    > "Show me today's hot tech videos on YouTube"

    > "What's viral on Twitter?"
  </Tab>

  <Tab title="Research">
    > "Do some research on productivity tools across YouTube, TikTok, and Reddit"

    > "What are creators saying about AI right now?"

    > "Find content gaps in the home automation niche"
  </Tab>
</Tabs>

<Tip>
  **OpenClaw figures out the commands.** The skill teaches your assistant what's possible — you just ask for what you want.
</Tip>

## Setting Up Scheduled Research

Ask OpenClaw to create cron jobs for you:

> "Set up a daily check for YouTube trending in tech at 9 AM"

> "Every Monday morning, research what's new in AI and summarize it for me"

> "Create an alert that checks Twitter every few hours for topics about privacy laws"

> "I want weekly competitor research on these creators: @mkbhd, @aliabdaal"

OpenClaw handles the cron syntax — you just describe what you want and when.

## Command Reference

If you prefer explicit commands:

```
# Get a transcript
yoinkit transcript https://youtube.com/watch?v=dQw4w9WgXcQ

# Search for content
yoinkit search youtube "AI tools for creators"

# Check what's trending
yoinkit trending tiktok --country US
```

## Troubleshooting

<AccordionGroup>
  <Accordion title="401 Unauthorized Error">
    Your API token is invalid or expired. Generate a new one in Yoinkit Settings → OpenClaw.
  </Accordion>

  <Accordion title="403 Forbidden Error">
    Your team's subscription is inactive. Renew your subscription to restore API access.
  </Accordion>

  <Accordion title="Skill Not Found">
    Make sure the skill is properly registered in your `openclaw.json`:

    ```json theme={null}
    {
      "skills": {
        "entries": {
          "yoinkit": {
            "path": "/path/to/yoinkit"
          }
        }
      }
    }
    ```
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Commands" icon="terminal" href="/openclaw/commands">
    Learn all available skill commands
  </Card>

  <Card title="Cron Examples" icon="clock" href="/openclaw/cron-examples">
    Set up automated research workflows
  </Card>
</CardGroup>