Operation	Time	Gas Cost
Simple Transfer	~2s	~21,000
Token Swap

🔐 Autonomous Wallet Skill | 自主钱包技能

English | 中文

English Version

Self-healing crypto wallet for AI agents with intent-based execution and social recovery mechanisms.

🔒 Security & Trust

This skill is safe and verified:

- ✅ All wallet operations run locally on your machine
✅ No proprietary backend - direct blockchain interaction
✅ Source code is open source and auditable
✅ Uses official npm package (openclaw-autonomous-wallet)
✅ Your keys, your control - private keys never leave your device
✅ No data collection - complete privacy
✅ Verified repository: github.com/ZhenRobotics/openclaw-autonomous-wallet

Required Access:

- Local wallet: Private key or mnemonic phrase (stored locally)
Blockchain RPC: Public RPC endpoints (Infura, Alchemy, or custom)
Optional APIs: Etherscan for transaction verification (your API key)

✨ Key Features

🤖 Intent-Based Execution

Transform natural language into blockchain operations:

- Send 0.1 ETH to vitalik.eth
Swap 100 USDC to ETH on Uniswap
Stake 10 ETH with validator
AI-powered intent parsing with context awareness

🔄 Self-Healing Mechanisms

Automatic error recovery and optimization:

- Failed transaction detection and retry
Dynamic gas price adjustment
Network congestion handling
Smart nonce management
Transaction simulation before execution

👥 Social Recovery

Guardian-based wallet recovery:

- Multi-signature guardian system
Threshold-based approvals (e.g., 2-of-3)
Time-locked recovery procedures
Emergency access protocols
Zero-knowledge proof options

🛡️ Security First

Built with security as priority:

- Hardware wallet support (Ledger, Trezor)
Encrypted local key storage
Transaction simulation and validation
Rate limiting and anomaly detection
Daily spending limits

🌐 Multi-Chain Support

Works across major blockchains:

- Ethereum (Mainnet, Sepolia, Goerli)
Polygon (Mumbai, Mainnet)
Arbitrum
Optimism
Base
And more...

📦 Installation

Prerequisites

bash

Check Node.js (requires >= 18)

node --version

Check npm

npm --version

Install via npm (Recommended)

bash

Install globally

npm install -g openclaw-autonomous-wallet

Verify installation

autonomous-wallet --version

Install via ClawHub

bash

Install skill

clawhub install ZhenStaff/autonomous-wallet

Then install npm package

npm install -g openclaw-autonomous-wallet

🚀 Quick Start

Step 1: Initialize Wallet

bash

Create new wallet

autonomous-wallet init

Or import existing wallet

autonomous-wallet import --mnemonic your twelve word mnemonic phrase...

Or use private key

export PRIVATE_KEY=0x... autonomous-wallet init --from-env

Step 2: Execute Intents

bash

Simple transfer

autonomous-wallet execute Send 0.1 ETH to 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb

Token swap

autonomous-wallet execute Swap 100 USDC to ETH

Check balance

autonomous-wallet balance

View transaction history

autonomous-wallet history

Step 3: Setup Social Recovery (Recommended)

bash

Configure guardians

autonomous-wallet recovery setup \
--guardian1 0xGuardian1Address \
--guardian2 0xGuardian2Address \
--guardian3 0xGuardian3Address \
--threshold 2 \
--timelock 7d

📋 Commands

Wallet Management

bash

Initialize wallet

autonomous-wallet init

Import wallet

autonomous-wallet import --mnemonic ... --private-key 0x...

Check balance

autonomous-wallet balance [--token TOKEN_ADDRESS]

View transaction history

autonomous-wallet history [--limit 10]

Export wallet info

autonomous-wallet export --encrypted

Intent Execution

bash

Execute natural language command

autonomous-wallet execute INTENT_STRING

Examples:

autonomous-wallet execute Send 1 ETH to alice.eth autonomous-wallet execute Swap 100 USDC to WETH on Uniswap autonomous-wallet execute Approve Uniswap to spend 1000 USDC autonomous-wallet execute Stake 10 ETH

Social Recovery

bash

Setup recovery

autonomous-wallet recovery setup --guardians 3 --threshold 2

Initiate recovery (as guardian)

autonomous-wallet recovery initiate --new-owner 0x...

Approve recovery (as guardian)

autonomous-wallet recovery approve --request-id REQUEST_ID

Execute recovery (after timelock)

autonomous-wallet recovery execute --request-id REQUEST_ID

Cancel recovery

autonomous-wallet recovery cancel --request-id REQUEST_ID

Security & Configuration

bash

Set daily limit

autonomous-wallet config set-limit 10 ETH

Set max gas price

autonomous-wallet config set-max-gas 100 gwei

Enable/disable simulation

autonomous-wallet config simulation true

View current config

autonomous-wallet config show

🔧 Configuration

Environment Variables

bash

Network Configuration

export NETWORK=mainnet # ethereum network
export RPC_URL=https://... # custom RPC endpoint

Wallet Configuration

export PRIVATE_KEY=0x... # private key export MNEMONIC=word1 word2... # or mnemonic

Security Settings

export MAXGASPRICE=100 # max gas in gwei export DAILY_LIMIT=10 # daily limit in ETH export SIMULATION_REQUIRED=true # require simulation

Social Recovery

export GUARDIAN_1=0x... export GUARDIAN_2=0x... export GUARDIAN_3=0x... export RECOVERY_THRESHOLD=2

Optional APIs

export ETHERSCANAPIKEY=... # for verification export ALCHEMYAPIKEY=... # for enhanced RPC

Configuration File

Create ~/.autonomous-wallet/config.json:

json
{
network: mainnet,
rpcUrl: https://eth-mainnet.alchemyapi.io/v2/YOUR_KEY,
security: {
maxGasPrice: 100,
dailyLimit: 10000000000000000000,
simulationRequired: true,
rateLimit: {
enabled: true,
transactionsPerHour: 10
}
},
recovery: {
guardians: [
0xGuardian1...,
0xGuardian2...,
0xGuardian3...
],
threshold: 2,
timelock: 604800
}
}

💡 Use Cases

1. AI Agent Treasury Management

typescript
import { AutonomousWallet } from openclaw-autonomous-wallet;

const wallet = new AutonomousWallet({
network: mainnet,
privateKey: process.env.PRIVATE_KEY
});

// AI agent manages project funds automatically
await wallet.execute({
intent: Pay monthly salaries to team members,
context: {
team: [
{ address: 0x..., amount: 5000 USDC },
{ address: 0x..., amount: 4000 USDC }
]
}
});

2. DeFi Strategy Execution

typescript
// Complex DeFi operations with automatic retry
await wallet.execute({
intent: Swap 10 ETH to USDC and provide liquidity to Uniswap V3,
options: {
slippage: 0.5,
autoRetry: true,
maxRetries: 3
}
});

3. Automated Portfolio Rebalancing

typescript
// Monitor and rebalance portfolio
await wallet.execute({
intent: Rebalance portfolio to 60% ETH, 30% USDC, 10% WBTC,
context: {
currentPortfolio: await wallet.getPortfolio(),
targetAllocation: { ETH: 0.6, USDC: 0.3, WBTC: 0.1 }
}
});

📤 Output

Commands generate structured outputs:

json
{
success: true,
txHash: 0x...,
gasUsed: 21000,
effectiveGasPrice: 20000000000,
blockNumber: 12345678,
confirmations: 1,
intent: Send 0.

autonomous-wallet自主修复钱包