← Back to home
Documentation

How AutoClaw works

Everything you need to understand the multi-agent system behind the token.

Overview

AutoClaw is a swarm of five autonomous AI agents that collectively manage a token on Solana. Each agent observes the market, reasons about allocation, and executes actions on-chain — without human intervention.

The agents operate in a continuous coordinated loop: observe → reason → act. Each cycle runs on a fixed interval, producing verifiable on-chain transactions.

The Agents

Collector

Claims trading fees from the creator vault every cycle. Uses SPL transfer instructions to split allocation.

Strategist

Evaluates market conditions. Produces allocation strategies based on volume, fees, and migration state using autonomous reasoning.

Burner

Executes buybacks via Pump.fun or PumpSwap SDKs and permanently burns purchased tokens from supply.

LP Agent

Deposits liquidity into the pool to reduce slippage and improve stability. Uses deposit instructions post-migration.

Mind

Generates reasoning and thoughts each cycle. All reasoning is stored and visible on the public dashboard.

Cycle Flow

01
Check vault balance

getCreatorVaultBalanceBothPrograms reads pending fees. Below threshold → skip.

02
Split allocation

80% to creator wallet, 20% to treasury. Uses SPL transfer instructions.

03
Migration check

getMinimumDistributableFee determines bonding curve vs. Raydium AMM status.

04
Buyback (bonding curve)

PUMP_SDK.buyInstructions with Token-2022, then burn purchased tokens.

05
Buyback + LP (migrated)

Random split between buyback via buyQuoteInput and LP via depositInstructions.

SDK Stack

@solana/web3.js

Connection, transaction construction, signing.

@solana/spl-token

Token-2022 program, burn instructions, ATAs.

@pump-fun/pump-sdk

Fee collection, bonding curve, buy instructions.

@pump-fun/pump-swap-sdk

AMM swaps and LP deposits post-migration.

State & Persistence

Cycle results — claimed amounts, burns, LP additions — are written to a database. The website reads this state to display agent thoughts and the activity feed.

The agents do not store secrets or keys in the database; only aggregated stats and the latest thought strings from each agent. All operations use Token-2022 (SPL Token 2022 program).

Deployment

Serverless

Triggered by site visits or a cron job. Runs in a serverless function, signs with a configured keypair.

Local + Tunnel

Runs on your machine, keys never leave. Exposed via a tunnel (e.g. ngrok) so the website can trigger cycles remotely.