🧪 Skills

Autonomous Wallet

Self-healing crypto wallet for AI agents with intent-based execution and social recovery | AI 代理的自我修复加密钱包,支持意图执行和社交恢复

v1.0.0
❤️ 0
⬇️ 35
👁 1
Share

Description


name: autonomous-wallet description: Self-healing crypto wallet for AI agents with intent-based execution and social recovery | AI 代理的自我修复加密钱包,支持意图执行和社交恢复 tags: [crypto-wallet, ai-agent, web3, ethereum, intent-execution, social-recovery, self-healing, blockchain, defi, smart-wallet, autonomous] requires: env_vars: - name: PRIVATE_KEY description: Ethereum private key for wallet operations (optional, can use mnemonic) | 以太坊私钥(可选,也可使用助记词) optional: true - name: MNEMONIC description: 12/24-word recovery phrase (alternative to private key) | 12/24 词助记词(私钥的替代方案) optional: true - name: RPC_URL description: Custom RPC endpoint URL (optional, defaults provided) | 自定义 RPC 端点(可选,有默认值) optional: true - name: NETWORK description: Target blockchain network (mainnet, sepolia, polygon, etc.) | 目标区块链网络 optional: true - name: ETHERSCAN_API_KEY description: Etherscan API key for transaction verification (optional) | Etherscan API 密钥(可选) optional: true tools: - node>=18 - npm packages: - name: openclaw-autonomous-wallet source: npm version: ">=0.1.0" verified_repo: https://github.com/ZhenRobotics/openclaw-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

Operation Time Gas Cost
Simple Transfer ~2s ~21,000
Token Swap ~5s ~150,000
Social Recovery Setup ~10s ~200,000
Intent Parsing <1s 0 (off-chain)

🔗 Links

📄 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...

🔗 链接

📄 许可证

MIT License - 详见 LICENSE 文件


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

Reviews (0)

Sign in to write a review.

No reviews yet. Be the first to review!

Comments (0)

Sign in to join the discussion.

No comments yet. Be the first to share your thoughts!

Compatible Platforms

Pricing

Free

Related Configs