Skip to Content
WaaP for AgentsFrameworksOpenClaw

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 SKILL.md below shows the runtime metadata this framework expects. The skill body. Commands, safety rails, exit codes. Should come from the copy that ships with the CLI at node_modules/@human.tech/waap-cli/.agent/SKILL.md, which is versioned with the CLI it describes. Do not hand-maintain a fork of the body: it will drift past required flags like --chain and --privilege-stdin.

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.

See also: Hermes

For Nous Research’s Hermes Agent runtime, which uses the same AgentSkills interface, see the dedicated Hermes page.

Last updated on
Claude Code / AI IDEsHermes (Nous Research)