# ClawDeFi Agent Skill：构建可扩展的 DeFi 智能代理系统

> 本文介绍 ClawDeFi Agent Skill 开源项目，一套专为 OpenClaw 兼容代理设计的模块化 DeFi 技能集。涵盖钱包管理、DEX 交易、永续合约、借贷、收益聚合、期权和预测市场等全栈 DeFi 功能，以及安全策略和预签名模拟机制。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-04-08T08:46:04.000Z
- 最近活动: 2026-04-08T08:53:50.269Z
- 热度: 167.9
- 关键词: DeFi, AI Agent, OpenClaw, ClawDeFi, DEX, 永续合约, Aave, Pendle, 智能合约, Web3, 区块链, 自动化交易
- 页面链接: https://www.zingnex.cn/forum/thread/clawdefi-agent-skill-defi
- Canonical: https://www.zingnex.cn/forum/thread/clawdefi-agent-skill-defi
- Markdown 来源: ingested_event

---

# ClawDeFi Agent Skill：构建可扩展的 DeFi 智能代理系统

随着去中心化金融（DeFi）协议的复杂度不断提升，AI 代理与区块链的深度融合成为新的技术热点。ClawDeFi Agent Skill 项目应运而生，为开发者提供了一套完整的、可安装的 DeFi 代理技能集，使 OpenClaw 兼容的本地代理能够安全、高效地与各类 DeFi 协议交互。

## 项目定位与核心能力

ClawDeFi Agent Skill 是一个分发式技能定义项目，版本 0.1.75，旨在教会本地代理如何与 DeFi 生态系统进行专业级交互。其核心能力覆盖 DeFi 投资的完整生命周期：

- **钱包全生命周期管理**：发现、创建、导入、选择钱包，查询余额与投资组合
- **风险画像与合规检查**：捕获用户风险偏好，执行免责声明与知情同意流程
- **协议智能查询**：通过 MCP/API 工具查询合约、ABI、操作规范和风险评分
- **跨品类 DeFi 操作**：支持兑换、永续合约、借贷、收益聚合、期权、预测市场等
- **交易前模拟验证**：所有涉及资金的操作必须通过预签名模拟
- **紧急退出机制**：提供一键平仓和资金回撤能力
- **技能自动更新**：支持定期检查和安装技能更新

## 模块化架构设计

项目采用高度模块化的脚本架构，每个 DeFi 品类都有独立的适配器实现，便于按需组合和独立维护。

### 去中心化交易（DEX）模块

DEX 模块以 0x Protocol 为主适配器，1inch 作为遗留支持。核心脚本包括：

- **swap-quote.js**：获取最优报价
- **swap-build.js**：构建交易数据
- **swap-simulate.js**：预签名模拟
- **swap-execute.js**：执行交易
- **swap-action-helpers.js**：共享工具函数

这种分层设计将报价、构建、模拟、执行四个阶段解耦，既保证了灵活性，又确保了每个环节都可独立测试和审计。

### 永续合约模块

永续合约模块适配 Avantis 协议（Base 链），功能最为完整，涵盖仓位管理的全生命周期：

**开仓流程**：perps-open-quote.js → perps-open-build.js → perps-open-simulate.js → perps-open-execute.js

**平仓流程**：perps-close-quote.js → perps-close-build.js → perps-close-simulate.js → perps-close-execute.js

**仓位管理**：perps-modify-position-build/simulate/execute.js（修改仓位）、perps-cancel-order-build/simulate/execute.js（取消订单）、perps-risk-orders-build/simulate/execute.js（风险管理订单）

**查询功能**：perps-position-list.js（持仓列表）、perps-pending-orders.js（待处理订单）

**推荐系统**：perps-referral-info.js、perps-referral-bind-build/simulate/execute.js

### 借贷模块

借贷模块适配 Aave V3 协议，提供标准化的存借还取流程：

- **lending-quote.js**：查询存借利率和额度
- **lending-build.js**：构建存借还取交易
- **lending-simulate.js**：模拟交易执行结果
- **lending-execute.js**：链上执行
- **lending-markets.js**：市场数据查询

### 收益聚合模块

收益聚合模块适配 Pendle 协议，支持收益代币化和固定收益策略：

- **yield-opportunities.js**：扫描收益机会
- **yield-quote.js**：获取投入/退出报价
- **yield-build/simulate/execute.js**：交易全流程

### 期权模块

期权模块适配 Thetanuts 协议，提供结构化期权策略：

- **options-market-data.js**：市场行情
- **options-orderbook.js**：订单簿查询
- **options-positions.js**：持仓查询
- **options-quote/build/simulate/execute.js**：交易全流程

### 预测市场模块

预测市场模块适配 Polymarket，支持事件预测和二元期权交易：

- **predictions-markets.js**：市场列表
- **predictions-quote/build/simulate/execute.js**：交易全流程

## 钱包与安全管理

### 钱包管理模块

钱包模块是 DeFi 代理的基础，提供以下功能：

- **wallet-discover.js**：发现本地已存在的钱包
- **wallet-create.js**：创建新钱包
- **wallet-import.js**：从私钥导入钱包
- **wallet-select.js**：选择活跃钱包
- **wallet-balance.js**：查询代币余额
- **wallet-total-portfolio.js**：聚合投资组合视图
- **wallet-transfer.js**：代币转账
- **wallet-sign.js / wallet-sign-broadcast.js**：交易签名与广播
- **wallet-token-allowance-check.js / wallet-token-allowance-set.js**：ERC-20 授权管理

### 安全策略与免责声明

安全是 DeFi 代理的首要考量。项目建立了多层防护机制：

**免责声明机制**：通过 wallet-disclaimer-status.js 查询用户的免责声明同意状态，wallet-register-consent.js 进行知情同意注册。这一流程要求用户显式确认，确保代理在法律和伦理框架内运行。

**预签名模拟**：所有涉及资金的操作必须通过 simulate-transaction.js 进行预签名模拟。该脚本执行 eth_call 和 estimateGas，并对 revert 错误进行解码，确保交易在提交前被充分验证。

**私钥本地存储**：签名凭证完全保存在本地，绝不向 clawdefi-core 传递私钥材料。这一设计原则确保了用户资产的终极控制权。

## 市场情报与数据服务

### 价格数据模块

- **query-coingecko.js**：CoinGecko 市场数据（价格、市值、排名、搜索）
- **query-pyth.js**：Pyth 预言机价格喂送
- **query-pyth-stream-open/poll/close/worker.js**：Pyth 实时价格流

### 协议与合约查询

- **query-protocol.js**：协议注册表智能查询
- **query-chain-registry.js**：链元数据注册表
- **query-contract-verification.js**：Etherscan 合约验证查询
- **query-address-info.js**：地址元数据查询
- **query-token-info.js**：代币元数据查询
- **query-token-audit.js**：代币安全审计检查

### 交易信号与分析

- **trading-signal.js**：交易信号生成
- **meme-rush.js**：Meme 代币分析
- **crypto-market-rank.js**：市场排名工具

## 安装与部署方式

项目提供三种安装方式，适应不同场景需求：

### ClawHub 安装（推荐）

```bash
npm i -g clawhub
clawhub install clawdefi-agent
```

ClawHub 是项目的首选分发渠道，提供版本管理和依赖解析。

### 原始安装（备用）

```bash
bash scripts/install-raw.sh
```

适用于无法访问 ClawHub 的环境，脚本会同步必要的运行时文件。

### 代理引导安装

代理可以通过以下命令获取安装指引：

```bash
curl "https://www.clawdefi.ai/skill.md"
```

然后按照返回的 SKILL.md 文件中的步骤完成安装。

## 更新机制

项目建立了完善的更新体系：

**ClawHub 更新**：
```bash
clawhub update clawdefi-agent
```

**原始 manifest 更新**：
```bash
bash scripts/update.sh
```

**平台特定更新**：
```bash
bash scripts/update-platform.sh
```

manifest.json 文件包含版本化的文件清单和 SHA-256 校验和，确保更新的完整性和安全性。

## 项目结构与设计原则

```
├── SKILL.md                    # 主要行为和流程说明
├── manifest.json               # 版本化文件清单
├── scripts/                    # 运行时模块
│   ├── install-raw.sh          # 原始安装脚本
│   ├── update.sh               # 便携更新脚本
│   ├── onboard.sh              # 首次运行引导
│   └── generate-skill-manifest.sh  # 清单生成工具
├── platform/                   # 平台特定代码
└── references/                 # 本地参考文件（git 忽略）
```

### 核心设计原则

1. **签名凭证本地保存**：私钥绝不离开本地环境
2. **钱包模块可替换**：不强制使用单一钱包提供商
3. **资金操作必模拟**：所有涉及资金的操作必须通过预签名模拟
4. **references/ 本地唯一**：该目录被 git 忽略，仅用于本地开发

## 推荐系统配置

Avantis 推荐模块默认使用推荐地址 `0x25Aa761B02C45D2B57bBb54Dd04D42772afdd291`，可通过环境变量 `CLAWDEFI_AVANTIS_REFERRER_ADDRESS` 覆盖。这一设计既提供了开箱即用的体验，又保留了定制化空间。

## 应用场景与价值主张

ClawDeFi Agent Skill 适用于以下场景：

**个人 DeFi 助手**：帮助用户监控投资组合、执行定投策略、捕捉套利机会

**机构交易代理**：为专业交易者提供自动化执行、风险管理和合规报告

**教育与研究**：作为 DeFi 协议交互的教学工具，帮助开发者理解各类协议的运作机制

**跨协议策略**：组合多个协议构建复杂策略，如循环借贷、收益耕作、Delta 中性仓位等

## 总结

ClawDeFi Agent Skill 项目代表了 AI 代理与 DeFi 协议深度融合的最新实践。通过模块化的脚本架构、严格的安全机制和灵活的安装部署方式，项目为开发者提供了一个坚实的基础，用于构建安全、高效、可扩展的 DeFi 智能代理系统。随着 DeFi 生态的持续演进，这类技能集将成为连接 AI 与区块链的关键基础设施。