OpenClaw setup

Install the ClawLink plugin in OpenClaw and pair this device

ClawLink works with OpenClaw through the @useclawlink/openclaw-plugin package. The flow is: install OpenClaw, install the ClawLink plugin into it, approve this device in your browser, then connect apps from the ClawLink dashboard.

1. Install OpenClaw

If you don’t have OpenClaw yet, install it before adding the ClawLink plugin.

1. Install the OpenClaw client

   Follow the official OpenClaw install instructions for your platform from openclaw.com. Most users install the desktop client; self-hosted gateway installs are also supported.

2. Start the gateway at least once

   Launch OpenClaw so the gateway initializes and writes its config file at ~/.openclaw/openclaw.json. ClawLink reads pairing state from that file.

3. Confirm the gateway is running

   When the gateway starts, the log prints a line like:

   http server listening (8 plugins: bonjour, browser, device-pair, file-transfer, memory-core, phone-control, talk-voice, whatsapp)
   

   Keep this line in mind — you’ll check it again after installing the ClawLink plugin to make sure clawlink-plugin shows up alongside the built-ins.

2. Install the ClawLink plugin

The fastest path is to paste the prompt below into your OpenClaw chat and let the agent run setup for you.

Set up the ClawLink plugin for me end to end:

1. Install it: `openclaw plugins install @useclawlink/openclaw-plugin` then `openclaw gateway restart`.
2. Confirm both `tools` and `clawlink-plugin` appear in the gateway's loaded-plugins log line. If `tools` is missing, fix `~/.openclaw/openclaw.json` so `plugins.allow` includes it, then restart again.
3. Start a fresh chat in OpenClaw and call `clawlink_begin_pairing`. Give me the pairing URL.
4. After I tell you I approved it in the browser, call `clawlink_get_pairing_status` until pairing is complete and confirm the device is saved.
5. Tell me to open https://claw-link.dev/dashboard/integrations to connect the apps I want.

If you’d rather do it manually:

1. Install the plugin

   openclaw plugins install @useclawlink/openclaw-plugin
   openclaw gateway restart
   

   If the current chat started before the plugin was installed and the ClawLink tools do not appear yet, start a fresh chat so OpenClaw reloads the plugin catalog.

2. Start browser pairing

   In OpenClaw, ask the assistant to set up ClawLink or start pairing. The plugin starts a pairing session and gives you a browser URL.

3. Approve this device in your browser

   Open the pairing URL, sign in to ClawLink if needed, and click Approve this device.

4. Let OpenClaw finish the pairing check

   Return to OpenClaw so the plugin can finish the local save step and confirm that the device is paired.

5. Connect apps from the dashboard

   Open Dashboard > Connections, add the apps you want, and start using them from OpenClaw.

What pairing stores locally

Browser pairing creates a device credential in the same cllk_live_... format as manual API keys and stores it locally in ~/.openclaw/openclaw.json.

In the recommended flow, you never have to paste that raw key into chat. OpenClaw stores it for the plugin after the browser approval finishes.

Available plugin tools

After setup, the plugin exposes tools for pairing, connection management, tool discovery, previews, and execution:

• clawlink_begin_pairing
• clawlink_get_pairing_status
• clawlink_start_connection
• clawlink_get_connection_status
• clawlink_list_integrations
• clawlink_list_tools
• clawlink_describe_tool
• clawlink_preview_tool
• clawlink_call_tool

Manual fallback

Use Settings > API Keys only if your OpenClaw client exposes a plugin settings UI and browser pairing is not available.

In that fallback path:

1. Create a key in Settings > API Keys
2. Copy the raw cllk_live_... value when it is shown
3. Paste it into the plugin settings field

Most users should skip this and use browser pairing instead.