OpenClaw

OpenClaw is a skill-based agent orchestration framework. WaaP integrates as a standard OpenClaw skill with a SKILL.md definition file that teaches the agent how to use the wallet.

Status: Production-ready.

Prerequisites

@human.tech/waap-cli installed globally
An active WaaP session (waap-cli signup or waap-cli login)
An OpenClaw workspace

Install the skill


# Add the WaaP skill to your OpenClaw workspace
openclaw skills add holonym-foundation/the-waap-skills

This places a SKILL.md in your workspace that the OpenClaw runtime discovers automatically.

SKILL.md structure

The WaaP skill definition follows the OpenClaw SKILL.md format with extended metadata:


---
name: waap-wallet
description: Signs messages and sends transactions with the local WaaP wallet
  via the waap-cli tool. Use when the user asks to check their WaaP wallet
  or sign a message.
compatibility: Requires @human.tech/waap-cli on PATH and an active WaaP
  session at ~/.waap-cli/session.json
metadata:
  author: holonym-foundation
  runtime: openclaw
---
 
# waap-wallet
 
Signs messages and sends transactions using the local WaaP wallet via `waap-cli`.
 
## Tools this skill shells out to
 
- `waap-cli whoami --json` — returns wallet addresses and email
- `waap-cli sign-message --message 0x<hex> --json` — returns a signature
- `waap-cli send-tx --to <addr> --value <amt> --chain <chain> --json` — returns a transaction hash
 
## Instructions
 
When the user asks to interact with their wallet:
 
1. Call `waap-cli whoami --json` to confirm the wallet is available.
2. For signing: hex-encode the user's message (UTF-8 to 0x-prefixed hex).
3. Call `waap-cli sign-message --message 0x<hex> --json`.
4. Return the `signature` field.
 
For transactions:
 
1. Call `waap-cli send-tx` with the appropriate flags and `--json`.
2. Return the `txHash` or `digest` field.
 
## Safety rails
 
- Refuse if `waap-cli whoami` fails; tell the user to run `waap-cli signup`.
- Never read `~/.waap-cli/session.json` directly.
- Never ask the user for their password in chat.

Configuration

OpenClaw skills are configured through the workspace. Set environment variables or defaults in your workspace config:


# openclaw.yaml
skills:
  waap-wallet:
    env:
      WAAP_DEFAULT_CHAIN: "evm:8453"
      WAAP_DEFAULT_RPC: "https://mainnet.base.org"

Using the skill with other skills

OpenClaw’s strength is composing multiple skills. WaaP works alongside other skills in the same agent:


skills:
  waap-wallet:
    env:
      WAAP_DEFAULT_CHAIN: "evm:8453"
  price-feed:
    source: my-org/price-feed-skill
  trading-strategy:
    source: my-org/trading-skill

The agent can check prices via the price feed skill, make trading decisions via the strategy skill, and execute trades via the WaaP skill — all in one conversation.