ClawPal Plugin for OpenClaw

An OpenClaw plugin that lets you manage ClawPal cloud gateway instances directly from your local OpenClaw agent.

Features

• OAuth Device Flow login — authenticate without leaving the terminal
• Gateway management — create, list, and delete cloud gateway instances
• Auto token refresh — expired access tokens are refreshed automatically
• Agent skill — OpenClaw agents can use ClawPal tools autonomously

Requirements

• OpenClaw >= 2026.3.22
• Node.js 22+

Installation

# Install from npm
openclaw plugins install @clawpal/openclaw-plugin

# Or install from local source
openclaw plugins install ./

Usage

Slash Commands

Command	Description
/clawpal-login	Log in via OAuth Device Flow
/clawpal-logout	Log out and revoke tokens
/clawpal-status	Show account status and quota

Tools (available to agents)

Tool	Description
clawpal_login	Authenticate via Device Flow
clawpal_logout	Revoke tokens and clear credentials
clawpal_status	Show login status and account info
clawpal_gateway_list	List cloud gateway instances
clawpal_gateway_create	Create a new gateway instance
clawpal_gateway_delete	Delete a gateway instance

Quick Start

> /clawpal-login
# Open the URL in your browser and enter the code shown

> /clawpal-status
# Verify you're logged in

> Ask the agent: "Create a gateway called my-gateway"
# The agent will call clawpal_gateway_create automatically

Configuration

Set the apiBase in OpenClaw's plugin config to point to a custom API server (e.g. for self-hosted or development environments):

{
  "plugins": {
    "clawpal": {
      "apiBase": "https://api.clawpal.com"
    }
  }
}

Project Structure

clawpal-plugin/
├── index.ts                 # Plugin entry point — registers tools and commands
├── src/
│   ├── auth.ts              # OAuth Device Flow + token management
│   ├── api-client.ts        # ClawPal API HTTP client
│   └── credentials.ts       # Local credential file I/O
├── skills/
│   └── clawpal/SKILL.md     # Agent skill definition
├── test/
│   └── test_plugin_e2e.sh   # End-to-end test script
├── openclaw.plugin.json     # Plugin manifest
├── package.json
└── tsconfig.json

Development

# Symlink into OpenClaw extensions for live development
ln -s $(pwd) ~/.openclaw/extensions/clawpal-plugin

# Run e2e tests
bash test/test_plugin_e2e.sh

License

MIT