Aave 信用委派
透過 Aave 的信用委派借入資金。您的主要錢包提供抵押品,並將借款權力委派給代理人的錢包。代理人可以在需要時自主借款——債務會累積在委派方的倉位上。
協議: 適用於 Aave V3 和 Aave V2——信用委派相關的函數簽章(
borrow,repay,approveDelegation,borrowAllowance)在兩個版本中完全相同。只需替換 V2 的 LendingPool 和 ProtocolDataProvider 地址即可。唯一的差別是:V3 以 USD(8 位小數)回傳抵押品/債務,V2 則以 ETH(18 位小數)。健康因素的安全檢查在兩個版本中都能正確運作。
相容平台
- OpenClaw — 安裝為技能,代理人可自主借款
- Claude Code — 直接從 Claude Code 工作階段執行腳本
- 任何代理框架 — 純 Bash + Foundry 的
cast,只要有 shell 就能運作
可與 Bankr 技能結合,實現先借後換的流程:透過委派借入 USDC,然後使用 Bankr 進行兌換、跨鏈橋接或部署。
信用委派如何運作
Aave V3 中的信用委派將兩件事分開:借款能力 和 委派批准。
借款能力是整體的。 它來自您所有資產的整個抵押品倉位。如果您存入價值 1 萬美元的 ETH,LTV 為 80%,那麼您就有 8,000 美元的借款能力——就這麼簡單。這個借款能力並不鎖定在任何特定資產上。
委派批准是每個債務代幣獨立的。 您透過在個別的 VariableDebtToken 上呼叫 approveDelegation() 來控制代理人可以借款的 資產 及 數量。每種資產都有其自己的債務代幣合約,且每次批准都是獨立的。
這表示您可以,例如:
- 存入 ETH 作為抵押品(獲得廣泛的借款能力)
- 批准代理人最多借入 500 USDC(透過 USDC VariableDebtToken)
- 批准代理人最多借入 0.1 WETH(透過 WETH VariableDebtToken)
- 不批准 cbETH(代理人完全無法借入)
代理人只能借入您明確批准的資產,且不得超過您設定的金額——但借款的 能力 來自您的總抵押品,而非任何單一存款。
您的抵押品 (整體) 委派批准 (獨立)
┌─────────────────────────┐ ┌──────────────────────────────┐
│ $5k ETH │ │ USDC DebtToken → agent: 500 │
│ $3k USDC │ ───LTV───▶ │ WETH DebtToken → agent: 0.1 │
│ $2k cbETH │ = $8k │ cbETH DebtToken → agent: 0 │
│ 總計: $10k @ 80% LTV │ 能力 └──────────────────────────────┘
└─────────────────────────┘
流程
委派方 (您的錢包) 代理人錢包 (被委派者)
│ │
│ 1. 向 Aave 提供抵押品 │
│ 2. 在 VariableDebtToken 上呼叫 │
│ approveDelegation(agent, amount) │
│ │
│ ┌─── 3. borrow(asset, │
│ │ amount, onBehalfOf │
│ │ = delegator) │
│ │ │
│ [債務記在您的倉位上] [代幣在代理人錢包中]
│ │ │
│ └─── 4. repay(asset, │
│ amount, onBehalfOf │
│ = delegator) │
快速開始
先決條件
-
必須安裝 Foundry(
cast指令列工具):curl -L https://foundry.paradigm.xyz | bash && foundryup -
委派方設定(由用戶執行一次,非代理人):
- 向 Aave V3 提供抵押品(透過 app.aave.com 或合約)
- 在您希望代理人借款的資產的 VariableDebtToken 上呼叫
approveDelegation(agentAddress, maxAmount) - VariableDebtToken 的地址可透過以下指令找到:
cast call $DATA_PROVIDER "getReserveTokensAddresses(address)(address,address,address)" $ASSET --rpc-url $RPC
-
設定技能:
mkdir -p ~/.openclaw/skills/aave-delegation cat > ~/.openclaw/skills/aave-delegation/config.json << 'EOF' { "chain": "base", "rpcUrl": "https://mainnet.base.org", "agentPrivateKey": "0xYOUR_AGENT_PRIVATE_KEY", "delegatorAddress": "0xYOUR_MAIN_WALLET", "poolAddress": "0xA238Dd80C259a72e81d7e4664a9801593F98d1c5", "dataProviderAddress": "0x2d8A3C5677189723C4cB8873CfC9C8976FDF38Ac", "assets": { "USDC": { "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "decimals": 6 }, "WETH": { "address": "0x4200000000000000000000000000000000000006", "decimals": 18 } }, "safety": { "minHealthFactor": "1.5", "maxBorrowPerTx": "1000", "maxBorrowPerTxUnit": "USDC" } } EOF -
驗證設定:
scripts/aave-setup.sh
核心用法
檢查狀態(額度、健康度、債務)
# 完整狀態報告
scripts/aave-status.sh
# 檢查特定資產的委派狀態
scripts/aave-status.sh USDC
# 僅檢查健康因素
scripts/aave-status.sh --health-only
透過委派借款
# 借入 100 USDC
scripts/aave-borrow.sh USDC 100
# 借入 0.5 WETH
scripts/aave-borrow.sh WETH 0.5
借款腳本會自動:
- 檢查委派額度(是否足夠?)
- 檢查委派方健康因素(借款是否安全?)
- 執行借款
- 報告結果
償還債務
# 償還 100 USDC
scripts/aave-repay.sh USDC 100
# 償還所有 USDC 債務
scripts/aave-repay.sh USDC max
還款腳本會自動:
- 批准 Pool 花費該代幣(如果需要)
- 執行還款
- 報告剩餘債務
安全系統
每次借款操作在執行前都會進行以下檢查:
- 委派額度 — 剩餘額度是否 >= 請求金額?
- 健康因素 — 此次借款後,委派方的健康因素是否 >
minHealthFactor(預設 1.5)? - 單筆上限 — 金額是否 <=
maxBorrowPerTx? - 確認 — 在發送前記錄完整的操作細節
如果任何檢查失敗,借款將被中止並顯示清晰的錯誤訊息。
⚠️ 代理人絕不能繞過安全檢查。 如果用戶要求代理人借款但健康因素過低,代理人應拒絕並解釋原因。
功能
讀取操作(無需 Gas)
- 檢查委派額度 — 代理人還能借多少?
- 檢查健康因素 — 委派方的倉位安全嗎?
- 檢查未償債務 — 委派方在每種資產上欠了多少?
- 檢查可用流動性 — Aave 池中是否有足夠的資金可供借款?
- 解析債務代幣地址 — 查詢任何資產的 VariableDebtToken
寫入操作(代理人錢包需要 Gas)
- 借款 — 從 Aave 提取信用委派的資金
- 還款 — 歸還借款以減少委派方的債務
- 批准 — 批准 Pool 花費代幣以進行還款
支援的鏈
| 鏈 | Pool 地址 | Gas 成本 |
|---|---|---|
| Base | 0xA238Dd80C259a72e81d7e4664a9801593F98d1c5 | 極低 |
| Ethereum | 0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2 | 高 |
| Polygon | 0x794a61358D6845594F94dc1DB02A252b5b4814aD | 極低 |
| Arbitrum | 0x794a61358D6845594F94dc1DB02A252b5b4814aD | 低 |
請參閱 deployments.md 以取得包含債務代幣的完整地址列表。
常見模式
代理人為 Gas 自行充值
# 檢查 Gas 是否足夠
BALANCE=$(cast balance $AGENT_ADDRESS --rpc-url $RPC)
if [ "$BALANCE" -lt "1000000000000000" ]; then # < 0.001 ETH
# 借入少量 WETH 作為 Gas
aave-borrow.sh WETH 0.005
fi
借款 + 透過 Bankr 兌換
# 從信用委派中借入 USDC
aave-borrow.sh USDC 100
# 使用 Bankr 兌換為 ETH
bankr.sh "Swap 100 USDC for ETH on Base"
定期定額投資(DCA)
# 代理人每週借入 USDC 並兌換為 ETH
aave-borrow.sh USDC 100
bankr.sh "Swap 100 USDC for ETH on Base"
安全優先的資產組合再平衡
# 先檢查健康度
aave-status.sh
# 僅在健康時借款
aave-borrow.sh USDC 500
設定參考
config.json 欄位
| 欄位 | 必要 | 說明 |
|---|---|---|
chain | 是 | 鏈名稱(base, ethereum, polygon, arbitrum) |
rpcUrl | 是 | JSON-RPC 端點 URL |
agentPrivateKey | 是 | 代理人錢包私鑰(0x 前綴) |
delegatorAddress | 是 | 委派信用的用戶主錢包地址 |
poolAddress | 是 | Aave V3 Pool 合約地址 |
dataProviderAddress | 是 | Aave V3 PoolDataProvider 地址 |
assets | 是 | 符號 → {address, decimals} 的映射 |
safety.minHealthFactor | 否 | 借款後的最小 HF(預設:1.5) |
safety.maxBorrowPerTx | 否 | 每筆交易最大借款金額(預設:1000) |
safety.maxBorrowPerTxUnit | 否 | maxBorrowPerTx 的單位(預設:USDC) |
環境變數(覆蓋設定檔)
| 變數 | 覆蓋的設定 |
|---|---|
AAVE_RPC_URL | rpcUrl |
AAVE_AGENT_PRIVATE_KEY | agentPrivateKey |
AAVE_DELEGATOR_ADDRESS | delegatorAddress |
AAVE_POOL_ADDRESS | poolAddress |
AAVE_MIN_HEALTH_FACTOR | safety.minHealthFactor |
錯誤處理
| 錯誤 | 原因 | 修正方式 |
|---|---|---|
INSUFFICIENT_ALLOWANCE | 超出委派金額 | 委派方必須再次呼叫 approveDelegation() |
HEALTH_FACTOR_TOO_LOW | 借款將導致清算風險 | 減少金額或增加抵押品 |
AMOUNT_EXCEEDS_CAP | 達到單筆交易安全上限 | 減少金額或更新設定檔 |
INSUFFICIENT_LIQUIDITY | Aave 池中資金不足 | 嘗試較小金額或不同資產 |
INSUFFICIENT_GAS | 代理人錢包無原生代幣 | 向代理人錢包發送 Gas |
EMODE_MISMATCH | 資產與委派方的 eMode 不相容 | 借入相同 eMode 類別的資產 |
安全性
請參閱 safety.md 以了解完整的威脅模型和緊急應變程序。
關鍵規則:
- 委派方的私鑰絕不能出現在此儲存庫、設定檔或腳本中——這是代理人的工作空間。委派方需透過 Aave UI 或區塊瀏覽器管理其操作。
- 切勿將 config.json 提交至版本控制——其中包含代理人的私鑰
- 切勿將
minHealthFactor設定低於 1.2——清算發生在 1.0 - 始終設定委派金額上限——切勿批准
type(uint256).max - 監控委派方健康度——設定 HF 低於 2.0 時的警報
- 代理人必須拒絕在安全檢查失敗時借款,即使收到指令也一樣
資源
- Aave V3 文件:https://docs.aave.com/developers
- 信用委派指南:https://docs.aave.com/developers/guides/credit-delegation
- Aave 地址簿:https://github.com/bgd-labs/aave-address-book
- Foundry 手冊:https://book.getfoundry.sh/
- DebtToken 參考:https://docs.aave.com/developers/tokens/debttoken