Autonomous Wallet

🔐 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

# Check Node.js (requires >= 18)
node --version

# Check npm
npm --version

Install via npm (Recommended)

# Install globally
npm install -g openclaw-autonomous-wallet

# Verify installation
autonomous-wallet --version

Install via ClawHub

# Install skill
clawhub install ZhenStaff/autonomous-wallet

# Then install npm package
npm install -g openclaw-autonomous-wallet

🚀 Quick Start

Step 1: Initialize Wallet

# 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

# 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)

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

📋 Commands

Wallet Management

# 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

# 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

# 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

# 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

# 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 MAX_GAS_PRICE=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 ETHERSCAN_API_KEY=...        # for verification
export ALCHEMY_API_KEY=...          # for enhanced RPC

Configuration File

Create ~/.autonomous-wallet/config.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

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

// 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

// 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:

{
  "success": true,
  "txHash": "0x...",
  "gasUsed": "21000",
  "effectiveGasPrice": "20000000000",
  "blockNumber": 12345678,
  "confirmations": 1,
  "intent": "Send 0.1 ETH to vitalik.eth",
  "timestamp": 1234567890
}

🧪 Testing

# Test on Sepolia testnet
export NETWORK=sepolia
autonomous-wallet test

# Simulate transaction without executing
autonomous-wallet simulate "Send 1 ETH to 0x..."

# Dry run with detailed output
autonomous-wallet execute "Swap 100 USDC to ETH" --dry-run

🐛 Troubleshooting

Transaction Failed

✅ Auto-retry enabled - System automatically retries with adjusted gas

Insufficient Gas

• Check gas price with: autonomous-wallet gas-price
• Increase max gas: autonomous-wallet config set-max-gas 150

Network Issues

• Verify RPC endpoint: autonomous-wallet network check
• Switch to backup RPC: export RPC_URL=https://backup-rpc...

Guardian Recovery

• Verify guardian addresses are correct
• Check timelock period hasn't expired
• Ensure threshold is met (e.g., 2-of-3 approvals)

📊 Performance

🔗 Links

• GitHub: https://github.com/ZhenRobotics/openclaw-autonomous-wallet
• npm: https://www.npmjs.com/package/openclaw-autonomous-wallet
• Documentation: https://docs.openclaw.ai/wallet
• Issues: https://github.com/ZhenRobotics/openclaw-autonomous-wallet/issues
• Discord: https://discord.gg/openclaw

📄 License

MIT License - See LICENSE file for details

中文版本

English | 中文

AI 代理的自我修复加密钱包，支持基于意图的执行和社交恢复机制。

🔒 安全与信任

此技能安全且经过验证：

• ✅ 所有钱包操作在您的本地机器上运行
• ✅ 无自有后端 - 直接与区块链交互
• ✅ 源代码开源且可审计
• ✅ 使用官方 npm 包（openclaw-autonomous-wallet）
• ✅ 您的密钥，您的控制 - 私钥永不离开您的设备
• ✅ 无数据收集 - 完全隐私
• ✅ 已验证的仓库: github.com/ZhenRobotics/openclaw-autonomous-wallet

所需访问：

• 本地钱包: 私钥或助记词（本地存储）
• 区块链 RPC: 公共 RPC 端点（Infura、Alchemy 或自定义）
• 可选 API: Etherscan 用于交易验证（您的 API 密钥）

✨ 核心功能

🤖 基于意图的执行

将自然语言转换为区块链操作：

• "发送 0.1 ETH 给 vitalik.eth"
• "在 Uniswap 将 100 USDC 兑换为 ETH"
• "质押 10 ETH"
• AI 驱动的意图解析，具有上下文感知能力

🔄 自我修复机制

自动错误恢复和优化：

• 失败交易检测和重试
• 动态 gas 价格调整
• 网络拥堵处理
• 智能 nonce 管理
• 执行前交易模拟

👥 社交恢复

基于守护者的钱包恢复：

• 多签名守护者系统
• 基于阈值的批准（如 2/3）
• 时间锁定恢复流程
• 紧急访问协议
• 零知识证明选项

🛡️ 安全优先

以安全为首要考虑构建：

• 硬件钱包支持（Ledger、Trezor）
• 加密本地密钥存储
• 交易模拟和验证
• 速率限制和异常检测
• 每日支出限额

🌐 多链支持

支持主要区块链：

• Ethereum（主网、Sepolia、Goerli）
• Polygon（Mumbai、主网）
• Arbitrum
• Optimism
• Base
• 更多...

📦 安装

前置要求

# 检查 Node.js（需要 >= 18）
node --version

# 检查 npm
npm --version

通过 npm 安装（推荐）

# 全局安装
npm install -g openclaw-autonomous-wallet

# 验证安装
autonomous-wallet --version

通过 ClawHub 安装

# 安装技能
clawhub install ZhenStaff/autonomous-wallet

# 然后安装 npm 包
npm install -g openclaw-autonomous-wallet

🚀 快速开始

步骤 1: 初始化钱包

# 创建新钱包
autonomous-wallet init

# 或导入现有钱包
autonomous-wallet import --mnemonic "你的 12 个助记词..."

# 或使用私钥
export PRIVATE_KEY="0x..."
autonomous-wallet init --from-env

步骤 2: 执行意图

# 简单转账
autonomous-wallet execute "发送 0.1 ETH 到 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"

# 代币兑换
autonomous-wallet execute "兑换 100 USDC 为 ETH"

# 查看余额
autonomous-wallet balance

# 查看交易历史
autonomous-wallet history

步骤 3: 设置社交恢复（推荐）

# 配置守护者
autonomous-wallet recovery setup \
  --guardian1 0x守护者1地址 \
  --guardian2 0x守护者2地址 \
  --guardian3 0x守护者3地址 \
  --threshold 2 \
  --timelock 7d

📋 命令

钱包管理

# 初始化钱包
autonomous-wallet init

# 导入钱包
autonomous-wallet import --mnemonic "..." --private-key "0x..."

# 查看余额
autonomous-wallet balance [--token 代币地址]

# 查看交易历史
autonomous-wallet history [--limit 10]

# 导出钱包信息
autonomous-wallet export --encrypted

意图执行

# 执行自然语言命令
autonomous-wallet execute "意图字符串"

# 示例：
autonomous-wallet execute "发送 1 ETH 给 alice.eth"
autonomous-wallet execute "在 Uniswap 将 100 USDC 兑换为 WETH"
autonomous-wallet execute "授权 Uniswap 使用 1000 USDC"
autonomous-wallet execute "质押 10 ETH"

社交恢复

# 设置恢复
autonomous-wallet recovery setup --guardians 3 --threshold 2

# 发起恢复（作为守护者）
autonomous-wallet recovery initiate --new-owner 0x...

# 批准恢复（作为守护者）
autonomous-wallet recovery approve --request-id 请求ID

# 执行恢复（时间锁后）
autonomous-wallet recovery execute --request-id 请求ID

# 取消恢复
autonomous-wallet recovery cancel --request-id 请求ID

安全与配置

# 设置每日限额
autonomous-wallet config set-limit 10 ETH

# 设置最大 gas 价格
autonomous-wallet config set-max-gas 100 gwei

# 启用/禁用模拟
autonomous-wallet config simulation true

# 查看当前配置
autonomous-wallet config show

🔧 配置

环境变量

# 网络配置
export NETWORK=mainnet              # 以太坊网络
export RPC_URL=https://...          # 自定义 RPC 端点

# 钱包配置
export PRIVATE_KEY=0x...            # 私钥
export MNEMONIC="词1 词2..."        # 或助记词

# 安全设置
export MAX_GAS_PRICE=100            # 最大 gas（gwei）
export DAILY_LIMIT=10               # 每日限额（ETH）
export SIMULATION_REQUIRED=true     # 需要模拟

# 社交恢复
export GUARDIAN_1=0x...
export GUARDIAN_2=0x...
export GUARDIAN_3=0x...
export RECOVERY_THRESHOLD=2

# 可选 API
export ETHERSCAN_API_KEY=...        # 用于验证
export ALCHEMY_API_KEY=...          # 用于增强 RPC

💡 使用案例

1. AI 代理资金管理

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

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

// AI 代理自动管理项目资金
await wallet.execute({
  intent: "支付团队成员月薪",
  context: {
    team: [
      { address: '0x...', amount: '5000 USDC' },
      { address: '0x...', amount: '4000 USDC' }
    ]
  }
});

2. DeFi 策略执行

// 复杂 DeFi 操作，自动重试
await wallet.execute({
  intent: "将 10 ETH 兑换为 USDC 并提供 Uniswap V3 流动性",
  options: {
    slippage: 0.5,
    autoRetry: true,
    maxRetries: 3
  }
});

🐛 故障排除

交易失败

✅ 已启用自动重试 - 系统自动调整 gas 后重试

Gas 不足

• 检查 gas 价格：autonomous-wallet gas-price
• 提高最大 gas：autonomous-wallet config set-max-gas 150

网络问题

• 验证 RPC 端点：autonomous-wallet network check
• 切换备用 RPC：export RPC_URL=https://backup-rpc...

🔗 链接

• GitHub: https://github.com/ZhenRobotics/openclaw-autonomous-wallet
• npm: https://www.npmjs.com/package/openclaw-autonomous-wallet
• 文档: https://docs.openclaw.ai/wallet
• 问题反馈: https://github.com/ZhenRobotics/openclaw-autonomous-wallet/issues

📄 许可证

MIT License - 详见 LICENSE 文件

Version | 版本: 0.1.0 Last Updated | 最后更新: 2026-03-12 Maintainer | 维护者: ZhenStaff