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

# Installation

> Install and configure the Poku skill for OpenClaw.

<Card title="OpenClaw + Poku overview →" icon="rocket" href="/integrations/openclaw">
  See what's possible: use cases & examples.
</Card>

***

## Prerequisite

Sign in to the [Poku dashboard](https://dashboard.pokulabs.com) and generate an API key.

***

## Option 1: Clawhub (recommended)

Install the official skill via [Clawhub](https://clawhub.ai/emileindik/poku):

```bash theme={null}
npx clawhub@latest install poku
```

This downloads the published skill bundle — including reference documents and the latest best-practice prompts — into `~/.openclaw/workspace/skills`.

***

## Configuration

<Steps>
  <Step title="Retrieve your API key">
    Get it from [dashboard.pokulabs.com](https://dashboard.pokulabs.com).
  </Step>

  <Step title="Add your API key">
    Add your API key to `~/.openclaw/openclaw.json`:

    ```json theme={null}
    {
      "skills": {
        "entries": {
          "poku": {
            "enabled": true,
            "apiKey": "<your-poku-api-key>",
            "env": {
              "POKU_TRANSFER_NUMBER": "<your-transfer-number>" //optional
            }
          }
        }
      }
    }
    ```

    `POKU_TRANSFER_NUMBER` is the number the agent will use to transfer the call to you. Must be in E.164 format (e.g. `+12223334444`)
  </Step>

  <Step title="Reload OpenClaw">
    Run `openclaw gateway restart` so the new configuration takes effect.
  </Step>

  <Step title="Verify the skill loaded">
    ```bash theme={null}
    openclaw skills list --eligible
    ```

    You should see `poku` in the list. If it's missing, double-check that the install command completed and that the `enabled` flag is set in `openclaw.json`.
  </Step>
</Steps>

***

## Receiving inbound calls and texts

To receive inbound calls and texts, you need to register a webhook with Poku and configure OpenClaw to forward those events to your agent. See the [Webhook](/poku-skill/webhook) page for full setup instructions.

Once you have a webhook URL, add a Poku mapping to the `hooks` section of `~/.openclaw/openclaw.json`:

```json theme={null}
{
  "hooks": {
    "enabled": true,
    "token": "<openclaw-hooks-token>",
    "transformsDir": "~/.openclaw/hooks/transforms",
    "defaultSessionKey": "hook:ingress",
    "allowRequestSessionKey": false,
    "allowedSessionKeyPrefixes": [
      "hook:"
    ],
    "mappings": [
      {
        "match": {
          "path": "poku"
        },
        "action": "agent",
        "agentId": "main",
        "sessionKey": "hook:poku",
        "wakeMode": "now",
        "name": "Poku",
        "deliver": true,
        "channel": "telegram",
        "to": "<your-telegram-id>",
        "messageTemplate": "You received a message from {{payload.payload.from}}: \"{{payload.payload.body}}{{payload.payload.summary}}\""
      }
    ]
  }
}
```

For the full OpenClaw webhook reference, see the [OpenClaw webhook documentation](https://docs.openclaw.ai/automation/webhook).

***

## Option 2: Custom skill

**1. Download the skill package**

Go to [github.com/pokulabs/skills](https://github.com/pokulabs/skills) and download the repository.

**2. Edit the skill files**

Open the downloaded package and edit each `.md` file to customize the skill for your needs.

**3. Add the skill to OpenClaw**

Move the `poku` folder into your OpenClaw workspace skills directory:

```
~/.openclaw/workspace/skills
```

**4. Follow the Configuration steps above to add your Poku API key.**

**5. To enable inbound calls and texts, set up a webhook.** See the [Webhook](/poku-skill/webhook) page to get started.