Agent Self-Setup Guide

Agent Self-Setup Guide

This guide describes how an autonomous AI agent can set up WAIaaS from scratch with zero human interaction using the auto-provision mode.

Prerequisites

• Node.js 22 LTS or later
• npm package manager (bundled with Node.js)
• No existing WAIaaS installation (first-time setup)

Auto-Provision Setup

1. Install CLI

npm install -g @waiaas/cli

2. Initialize with Auto-Provision

waiaas init --auto-provision

This creates the data directory (~/.waiaas/) with:

• config.toml -- default configuration with auto-generated master password hash
• recovery.key -- plaintext master password for autonomous access

The --auto-provision flag generates a cryptographically random master password, hashes it with Argon2id, and stores the hash in config.toml. The plaintext password is saved to recovery.key so that subsequent CLI commands can authenticate without human input.

3. Start Daemon

waiaas start

The daemon starts immediately using the auto-provisioned password. No interactive password prompt.

Verify:

curl -s http://localhost:3100/health

4. Create Wallets and Session

waiaas quickset

This reads the master password from recovery.key automatically and creates:

1. Solana + EVM wallets
2. Session tokens (wai_sess_...)
3. MCP configuration JSON

Capture the session token from the output:

export WAIAAS_BASE_URL=http://localhost:3100
export WAIAAS_SESSION_TOKEN=<token-from-quickset>

5. Verify Connection

curl -s http://localhost:3100/v1/connect-info \
  -H "Authorization: Bearer $WAIAAS_SESSION_TOKEN"

This returns accessible wallets, policies, capabilities, and an AI-ready usage prompt.

Next Steps

• Agent Skills Integration -- Install WAIaaS skill files to teach your agent wallet operations
• Claude Code Integration -- Claude Code specific skill setup
• OpenClaw Integration -- OpenClaw specific skill setup

Related

• Agent Skills Integration Guide - Install WAIaaS skill files for your agent
• Deployment Guide - WAIaaS deployment and configuration options
• The AI Agent Wallet Security Crisis - Why secure agent setup matters