OpenClaw Integration Guide

2026-02-10

OpenClaw Integration Guide

This guide walks you through connecting WAIaaS to OpenClaw, an open-source AI agent bot that follows the Agent Skills open standard.

Quick Setup

1. Initial Setup

If WAIaaS is not yet installed, follow the setup skill (waiaas-setup/SKILL.md) for CLI installation, daemon startup, wallet creation, and session configuration.

2. Install WAIaaS Skills

npx @waiaas/skills openclaw

This installs 8 WAIaaS skill files to ~/.openclaw/skills/:

~/.openclaw/skills/
  waiaas-setup/SKILL.md
  waiaas-quickstart/SKILL.md
  waiaas-wallet/SKILL.md
  waiaas-transactions/SKILL.md
  waiaas-policies/SKILL.md
  waiaas-admin/SKILL.md
  waiaas-actions/SKILL.md
  waiaas-x402/SKILL.md

3. Configure OpenClaw

Add the WAIaaS environment variables to your ~/.openclaw/openclaw.json:

{
  "skills": {
    "entries": {
      "waiaas-quickstart": {
        "env": {
          "WAIAAS_BASE_URL": "http://localhost:3100",
          "WAIAAS_SESSION_TOKEN": "<your-session-token>"
        }
      }
    }
  }
}

The agent no longer needs the master password. Provide only the session token from step 1.

4. Agent Self-Discovery

On startup, the agent should call GET /v1/connect-info with the session token to discover available wallets, policies, and capabilities:

curl -s http://localhost:3100/v1/connect-info \
  -H 'Authorization: Bearer <session-token>'

This returns an AI-ready prompt describing the environment, eliminating the need for manual configuration.

Verification

Ask OpenClaw to check your wallet balance:

"Check my WAIaaS wallet balance"

OpenClaw will use the waiaas-quickstart skill to query the daemon and return your balance.

Available Skills

Skill Description
waiaas-setup Zero-state daemon setup: install CLI, initialize, start daemon, create wallet, configure session
waiaas-quickstart End-to-end quickset: create wallet, session, check balance, send first transfer
waiaas-wallet Wallet CRUD, asset queries, session management, token registry, MCP provisioning
waiaas-transactions All 5 transaction types (TRANSFER, TOKEN_TRANSFER, CONTRACT_CALL, APPROVE, BATCH)
waiaas-policies Policy engine: 12 policy types for spending limits, whitelists, rate limits
waiaas-admin Admin API: daemon status, kill switch, notifications, settings management
waiaas-actions Action Provider framework: DeFi actions through the transaction pipeline
waiaas-x402 x402 auto-payment protocol: fetch URLs with automatic cryptocurrency payments

Updating Skills

To update to the latest skill files:

npx @waiaas/skills openclaw --force

See Also

Troubleshooting

Skills not detected by OpenClaw

Verify the skill files are in the correct location:

ls ~/.openclaw/skills/waiaas-*/SKILL.md

Connection refused

Make sure the WAIaaS daemon is running:

curl http://localhost:3100/health

If not running, start it:

waiaas start

Authentication errors

Check that your session token is correct in openclaw.json. You can verify with:

curl -H "Authorization: Bearer <session-token>" http://localhost:3100/v1/connect-info

Related