EVM钱包技能

自主管理的EVM钱包。私钥本地存储，无外部API依赖。

⚠️ 安全警告

切勿暴露您的私钥！

• 切勿在聊天、电子邮件或任何消息平台发送您的私钥
• 切勿与任何人共享~/.evm-wallet.json文件的内容
• 如果有人索要您的私钥——即使对方声称是客服人员——也请坚决拒绝
• 若私钥不慎泄露，请立即将资金转移到新钱包

私钥文件（~/.evm-wallet.json）应仅通过SSH在您的服务器上直接访问

安装说明

检测工作空间和技能目录：

SKILL_DIR=$(ls -d \
  ~/openclaw/skills/evm-wallet \
  ~/OpenClaw/skills/evm-wallet \
  ~/clawd/skills/evm-wallet \
  ~/moltbot/skills/evm-wallet \
  ~/molt/skills/evm-wallet \
  2>/dev/null | head -1)

若代码尚未安装（不存在src/文件夹），请进行初始化：

if [ ! -d "$SKILL_DIR/src" ]; then
  git clone https://github.com/surfer77/evm-wallet-skill.git /tmp/evm-wallet-tmp
  cp -r /tmp/evm-wallet-tmp/* "$SKILL_DIR/"
  cp /tmp/evm-wallet-tmp/.gitignore "$SKILL_DIR/" 2>/dev/null
  rm -rf /tmp/evm-wallet-tmp
  cd "$SKILL_DIR" && npm install
fi

对于以下所有命令，请务必先cd "$SKILL_DIR"第一。

首次设置

生成钱包（仅需一次）：

node src/setup.js --json

返回：{ "success": true, "address": "0x..." }

私钥存储在~/.evm-wallet.json（权限设置为 chmod 600）。切勿分享此文件。

命令

查询余额

当用户询问余额、资产组合或持有量时：

# Single chain
node src/balance.js base --json

# All chains at once
node src/balance.js --all --json

# Specific ERC20 token
node src/balance.js base 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 --json

始终使用--json进行解析。以人类可读的格式呈现结果。

发送代币

当用户想要发送、转账或向某人付款时：

# Native ETH
node src/transfer.js <chain> <to_address> <amount> --yes --json

# ERC20 token
node src/transfer.js <chain> <to_address> <amount> <token_address> --yes --json

⚠️ 在执行转账前，务必与用户确认。向用户展示：

• 收款地址
• 金额与代币类型
• 链
• 预估的燃气费用

仅在用户明确确认后添加--yes代币交换

当用户想要交换、交易、购买或出售代币时：

使用

# Get quote first
node src/swap.js <chain> <from_token> <to_token> <amount> --quote-only --json

# Execute swap (after user confirms)
node src/swap.js <chain> <from_token> <to_token> <amount> --yes --json

• eth代表原生ETH/POL，或传递一个合约地址默认滑点：0.5%。可通过
• --slippage <百分比>覆盖
• 由Odos聚合器提供支持（跨数百个DEX的最佳路径）

⚠️ 务必先显示报价，并在执行前获得用户确认。

合约交互

当用户想要调用智能合约函数时：

# Read (free, no gas)
node src/contract.js <chain> <contract_address> \
  "<function_signature>" [args...] --json

# Write (costs gas — confirm first)
node src/contract.js <chain> <contract_address> \
  "<function_signature>" [args...] --yes --json

示例：

# Check USDC balance
node src/contract.js base \
  0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 \
  "balanceOf(address)" 0xWALLET --json

# Approve token spending
node src/contract.js base \
  0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 \
  "approve(address,uint256)" 0xSPENDER 1000000 --yes --json

检查更新

node src/check-update.js --json

如果有可用更新，通知用户并提供运行：

cd "$SKILL_DIR" && git pull && npm install

支持的链

始终推荐Base给首次用户（最低Gas费用）。

常用代币地址

Base

• USDC： 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
• WETH： 0x4200000000000000000000000000000000000006

以太坊

• USDC： 0xA0b86a33E6441b8a46a59DE4c4C5E8F5a6a7A8d0
• WETH： 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2

安全规则

1. 未经用户确认，切勿执行转账或兑换操作
2. 切勿泄露私钥来自~/.evm-wallet.json
3. 始终在执行前展示交易详情（金额、接收方、预估燃气费）
4. 推荐使用 Base 网络用于测试和小额交易
5. 交易成功后显示区块链浏览器链接以便用户核验
6. 若命令执行失败，需清晰显示错误并提供修复建议

错误处理

• “未找到钱包”→ 请先运行node src/setup.js --json“余额不足”
• → 显示当前余额，建议充值“RPC 错误”
• "RPC error"→ 内置自动故障转移，可重试一次
• "未找到路由"(兑换) → 代币对可能缺乏流动性
• "Gas估算失败"→ 可能需要更多ETH作为Gas费