clankerkit

# ClankerKit - Autonomous Wallet for AI Agents on Monad

ClankerKit gives your AI agent autonomous financial capabilities on Monad blockchain. Deploy a smart contract wallet, set spending policies, swap tokens via Kuru DEX, stake MON, trade memecoins with strategies, and execute cross-chain swaps.

## Quick Start

```bash
# Install the skill
claw skill install clankerkit
```

## Environment Variables

| Variable | Required | Description |
|---|---|---|
| `AGENT_WALLET_ADDRESS` | Yes | Deployed AgentWallet contract address |
| `POLICY_ENGINE_ADDRESS` | Yes | Deployed PolicyEngine contract address |
| `AGENT_PRIVATE_KEY` | Yes | Agent's private key (with 0x prefix) |
| `OWNER_ADDRESS` | Yes | Human owner address |
| `MONAD_RPC_URL` | No | Monad RPC URL (default: testnet) |
| `MONAD_NETWORK` | No | `testnet` or `mainnet` (default: testnet) |
| `ZEROX_API_KEY` | No | 0x Swap API key (only for `zerox_swap`) |

## Tools (32 total)

### Wallet Management

#### `get_wallet_info`
Get wallet address, owner, agent, MON balance, and policy state.

#### `get_token_balance`
Get ERC-20 token balance of the agent wallet.
- **token**: Token symbol (WMON, USDC, CHOG, DAK, YAKI) or contract address

#### `send_tokens`
Send native MON tokens from the wallet.
- **to**: Recipient address
- **amount**: Amount in human-readable form (e.g. "0.5")

#### `send_token`
Send ERC-20 tokens from the wallet.
- **token**: Token contract address
- **to**: Recipient address
- **amount**: Amount in human-readable form

#### `execute_transaction`
Execute an arbitrary contract call via the wallet.
- **target**: Target contract address
- **value**: Native MON to send (wei, default "0")
- **data**: Encoded calldata (hex)

#### `ensure_gas`
Ensure the agent EOA has enough MON for gas fees. If the EOA balance is below the minimum threshold, automatically sends MON from the AgentWallet contract to the EOA. Users only need to fund the wallet contract — the agent tops up its own gas from there.
- **minBalance**...

# ClankerKit OpenClaw Skill

Autonomous wallet operations for AI agents on Monad — 32 tools for swapping, staking, trading memecoins, deploying wallets, and managing spending policies.

## Installation

```bash
claw skill add clankerkit
```

Or manually:

```bash
cd ~/.openclaw/skills
git clone <repo-url> clankerkit
```

## Configuration

Set the following environment variables in your OpenClaw config:

```bash
export AGENT_WALLET_ADDRESS=0x...
export POLICY_ENGINE_ADDRESS=0x...
export AGENT_PRIVATE_KEY=...  # Without 0x prefix
export OWNER_ADDRESS=0x...
export MONAD_RPC_URL=https://rpc.monad.xyz
export MONAD_NETWORK=mainnet  # or testnet
```

## Available Tools

See [SKILL.md](./SKILL.md) for the full list of 32 tools with parameters.

## Security

- Agent can only spend within policy limits
- Transactions above threshold require owner approval
- All operations are logged on-chain
- Owner can pause/withdraw at any time

## License

MIT