Plugin Tools Reference - Agether Protocol

The Agether plugin exposes tools to the OpenClaw AI. Each tool is described with its purpose, inputs, and example natural language triggers.

Identity & Account

`agether_balance`

Check ETH and USDC balances for both the EOA wallet and the Safe account. Example prompts:

“What is my balance?”
“How much USDC do I have?”
“Show my wallet balances”

Returns:

EOA wallet:
  ETH: 0.234 ETH
  USDC: $150.00

Safe Account (0x1234...abcd):
  ETH: 0.001 ETH
  USDC: $100.00
  WETH: 0.1 WETH

`agether_register`

“Register me on Agether”
“Create my agent account”
“Set up my onchain identity”

Returns: Agent ID, Safe account address, KYA status.

After registration, the agentId is automatically saved to ~/.openclaw/openclaw.json for persistence across restarts.

`agether_set_agent`

Manually set the active agentId (persists to config file). Example prompts:

“Set my agent ID to 42”
“Use agent 17676”

Morpho Lending

`morpho_status`

Show all current Morpho Blue positions — collateral deposited, USDC borrowed, health factor, and debt across all markets. Example prompts:

“Show my Morpho positions”
“What is my health factor?”
“How much have I borrowed?”

Returns: Per-market breakdown with collateral, debt, health factor, and current APY.

`morpho_deposit`

Deposit collateral into a Morpho Blue market without borrowing. Supports any collateral token available on Morpho Blue (WETH, cbBTC, wstETH, cbETH, and many more). Example prompts:

“Deposit 0.5 WETH as collateral”
“Put my wstETH into Morpho”

Parameters:

token: Collateral token symbol (e.g. WETH, cbBTC, wstETH)
amount: Amount to deposit (e.g. "0.1")

`morpho_deposit_and_borrow`

Deposit collateral and borrow USDC in a single atomic transaction — the most common operation. Example prompts:

“Deposit 0.1 WETH and borrow $100 USDC”
“Use my ETH as collateral and borrow $50”
“I need $200 USDC — use my WETH”

Parameters:

collateralToken: Collateral to deposit
collateralAmount: How much to deposit
borrowAmount: USDC to borrow (in dollars)

Executes as a single ERC-4337 UserOp with batched execution:

WETH.transferFrom(EOA → Safe account)
WETH.approve(Morpho, amount)
Morpho.supplyCollateral(...)
Morpho.borrow(...)

`morpho_borrow`

Borrow additional USDC against already-deposited collateral. Example prompts:

“Borrow $50 more USDC”
“Draw another $100 from my Morpho position”

Parameters:

amount: USDC to borrow
token (optional): Specific collateral market to borrow from

Borrowing more reduces your Health Factor. Ensure it stays above 1.0 to avoid liquidation.

`morpho_repay`

Repay outstanding USDC debt. Supports full repayment with "all". Example prompts:

“Repay $50 USDC”
“Pay back all my debt”
“Repay everything”

Parameters:

amount: Amount to repay, or "all" for full repayment

`morpho_withdraw`

Withdraw collateral from Morpho Blue. Supports "all" for full withdrawal (only safe after full repayment). Example prompts:

“Withdraw my WETH”
“Take back 0.05 WETH from Morpho”
“Close my position and get my collateral back”

`morpho_sponsor`

Send collateral tokens to another agent’s account. Useful for funding other agents. Example prompts:

“Send 0.1 WETH to agent 42”
“Sponsor agent 0xAbcd…1234 with WETH”

`morpho_markets`

List all available Morpho Blue USDC borrow markets on Base, with LLTV and utilization. Example prompts:

“What markets are available?”
“Show me Morpho lending markets”

Returns: Market list with collateral token, LLTV %, utilization %, and current APY.

`morpho_max_borrowable`

Calculate the maximum additional USDC that can be borrowed given current collateral positions. Example prompts:

“How much more can I borrow?”
“What’s my max borrowable?”

Supply & Yield (Lending)

`morpho_supply`

Supply USDC to a Morpho Blue market as a lender to earn yield from borrowers. This is the lending side — your USDC earns interest. Unlike morpho_deposit (collateral for borrowing), this puts USDC to work earning APY. Example prompts:

“Supply $500 USDC to earn yield”
“Lend $100 USDC to the WETH market”
“Put my USDC to work”

Parameters:

amount: USDC amount to supply (e.g. "500")
market (optional): Collateral token of the market to supply to (auto-picks highest APY if omitted)

`morpho_supply_status`

Show all supply (lending) positions with earned yield. Tracks yield without any database — reads Morpho events directly from the blockchain. Example prompts:

“Show my yield positions”
“How much yield have I earned?”
“Check my supply positions”

Returns: Per-position breakdown with current value, net deposited, earned yield, and current APY.

`morpho_withdraw_supply`

Withdraw supplied USDC (principal + earned interest) from a Morpho Blue lending position. Use "all" to withdraw the full position. Different from morpho_withdraw which withdraws collateral. Example prompts:

“Withdraw my supplied USDC”
“Take out my yield earnings”
“Withdraw all from my lending position”

Parameters:

amount: USDC amount to withdraw (e.g. "100" or "all")
market (optional): Market collateral token (auto-detects if omitted)
toEoa (optional): Send to EOA wallet instead of keeping in Safe account (default: false)

Health & Diagnostics

`agether_health`

Comprehensive health check: balances, all Morpho positions with LTV & liquidation risk, borrowing headroom, and current market rates — all in one call. Use this as the first call in any session to get full context. Example prompts:

“Show my health”
“Give me a full status check”
“Am I at risk of liquidation?”

Returns: Combined balance, position, max borrowable, and rate data.

`agether_preflight`

Check that the agent is fully set up: private key present, RPC working, agent registered, balances non-zero. Returns a checklist of pass/fail items. Example prompts:

“Is everything set up correctly?”
“Run a preflight check”
“Why isn’t my agent working?”

Scoring & Payments

`agether_score`

Get the agent’s credit score. By default, reads the current onchain score for free. Can trigger a fresh ML computation (costs $0.01 USDC via x402). Example prompts:

“What is my credit score?”
“Refresh my Agether score”
“Show my credit tier”

Returns: Score (300–1000), tier (Excellent/Good/Fair/Poor/Very Poor), probability of default, and top contributing features.

`wallet_fund`

Transfer USDC from the EOA wallet into the Safe account. Example prompts:

“Move $50 USDC into my agent account”
“Fund my account with $100”

`x402_pay`

Make a paid HTTP request to an x402-enabled API. Handles the 402 payment flow automatically. With autoDraw, borrows from Morpho if the balance is insufficient. Example prompts:

“Call this API: https://api.example.com/resource”
“Make a paid request to compute something”

Parameters:

url: The x402-enabled endpoint
method (optional): HTTP method (default GET)
body (optional): Request body for POST requests

KYA (Know Your Agent)

`agether_kya_status`

Check KYA (Know Your Agent) validation status for the current agent. Example prompts:

“What’s my KYA status?”
“Am I code-approved?”

Returns: KYA approval status (approved/pending/not submitted), validation registry address, and audit details.

`agether_set_kya`

Set or update KYA validation configuration. Example prompts:

“Enable KYA”
“Set validation registry”

Returns: Confirmation of KYA configuration update.

Wallet Operations

`wallet_withdraw_token`

Withdraw ERC20 tokens from the Safe account to EOA or specified address. Example prompts:

“Withdraw my USDC from agent account”
“Send tokens back to my wallet”

Parameters:

token: Token symbol (e.g. USDC, WETH)
amount: Amount to withdraw (e.g. "100")
to (optional): Destination address (defaults to EOA)

`wallet_withdraw_eth`

Withdraw ETH from the Safe account to EOA or specified address. Example prompts:

“Withdraw ETH from agent account”

Parameters:

amount: ETH amount to withdraw (e.g. "0.1")
to (optional): Destination address (defaults to EOA)

Slash Commands

These commands execute immediately without AI processing:

Command	Description
`/balance`	Quick ETH + USDC balance check
`/morpho`	Quick position summary across all markets
`/health`	Comprehensive health check (balances + positions + risk)
`/rates`	Current supply/borrow APY for all markets

OpenClaw Plugin

​Identity & Account

​agether_balance

​agether_register

​agether_set_agent

​Morpho Lending

​morpho_status

​morpho_deposit

​morpho_deposit_and_borrow

​morpho_borrow

​morpho_repay

​morpho_withdraw

​morpho_sponsor

​morpho_markets

​morpho_max_borrowable

​Supply & Yield (Lending)

​morpho_supply

​morpho_supply_status

​morpho_withdraw_supply

​Health & Diagnostics

​agether_health

​agether_preflight

​Scoring & Payments

​agether_score

​wallet_fund

​x402_pay

​KYA (Know Your Agent)

​agether_kya_status

​agether_set_kya

​Wallet Operations

​wallet_withdraw_token

​wallet_withdraw_eth

​Slash Commands

Identity & Account

`agether_balance`

`agether_register`

`agether_set_agent`

Morpho Lending

`morpho_status`

`morpho_deposit`

`morpho_deposit_and_borrow`

`morpho_borrow`

`morpho_repay`

`morpho_withdraw`

`morpho_sponsor`

`morpho_markets`

`morpho_max_borrowable`

Supply & Yield (Lending)

`morpho_supply`

`morpho_supply_status`

`morpho_withdraw_supply`

Health & Diagnostics

`agether_health`

`agether_preflight`

Scoring & Payments

`agether_score`

`wallet_fund`

`x402_pay`

KYA (Know Your Agent)

`agether_kya_status`

`agether_set_kya`

Wallet Operations

`wallet_withdraw_token`

`wallet_withdraw_eth`

Slash Commands