| name | clawnch-info |
| description | On-chain token information, portfolio discovery, vault claims, agent registration, and Clawnch platform data. Most actions are read-only. |
| metadata | {"openclaw":{"emoji":"🦞"}} |
Clawnch Info — Platform Data & Token Details
When to Use
- User asks about a specific Clawnch token's on-chain details
- User wants to discover what tokens a wallet holds
- User wants to check or claim vested vault allocations
- User wants to register as a verified Clawnch agent
- User asks about Clawnch platform stats (total tokens, agents, volume)
- User wants to browse tokens deployed on Clawnch
When NOT to Use
- Price lookups (use defi-trading skill)
- Token safety audits (use herd-intelligence skill)
- Launching new tokens (use clawnch-launchpad skill)
- Fee claiming (use clawnch-launchpad skill — clawnch_fees tool)
Tool: clawnch_info
Read-Only Actions
| Action | Params | Description |
|---|
token_info | token | On-chain token details via ClawnchReader: name, symbol, decimals, supply, creator, taxes, vault info |
portfolio | address? | Token discovery for a wallet via ClawnchPortfolio. Finds all tokens held, with values. |
agent_status | address? | Check if a wallet is a registered Clawnch agent. Shows agent ID, name, verification. |
platform_stats | — | Clawnch platform stats: total tokens, agents, volume, liquidity, active tokens. |
list_tokens | page?, page_size? | Paginated list of all Clawnch-deployed tokens with price, market cap, volume. |
Write Actions
| Action | Params | Description |
|---|
vault_claim | token | Check and claim vested vault allocation. Shows lockup status and claims if available. |
agent_register | agent_name, agent_description? | Register as a verified Clawnch agent. Requires CLAWNCH_API_KEY. |
Token Info Fields
For Clawnch-deployed tokens, token_info returns extra fields:
| Field | Description |
|---|
isClawnchToken | Whether this token was deployed via Clawnch |
creator | Deployer address |
launchDate | When the token was deployed |
liquidityLocked | Whether LP is locked |
taxBuy / taxSell | Buy/sell tax percentages |
maxWallet | Max wallet holding limit |
vault | Vault info: lockup end time, vesting duration, total allocation |
Vault Claim Flow
- Check vault status:
action: vault_claim, token: 0xTokenAddress
- If locked: shows lockup end time
- If unlocked but nothing available: shows vesting progress
- If tokens available: auto-executes the claim (goes through ClawnchConnect)
Portfolio Discovery
The portfolio action discovers tokens held by a wallet:
action: portfolio, address: 0xWalletAddress
If full portfolio data is available (via ClawnchPortfolio), returns:
- ETH balance + USD value
- Each token: address, symbol, balance, price, value, isClawnchToken
- Total portfolio value
If only addresses are available, returns token addresses for further lookup via token_info.
Platform Stats
The platform_stats action returns:
- Total tokens deployed
- Total registered agents
- Total trading volume (USD)
- Total liquidity (USD)
- Active tokens in last 24h
- Top 5 tokens by volume
Token Listing
Browse all Clawnch tokens with pagination:
action: list_tokens, page: 1, page_size: 20
Each token includes: address, name, symbol, creator, launch date, price, market cap, volume, holder count.
Environment Variables
| Variable | Required For | Description |
|---|
CLAWNCH_API_KEY | agent_register, agent_status | Agent API key |
CLAWNCHER_API_URL | platform_stats, list_tokens, agent_status | Custom API URL (default: https://clawn.ch) |
Important Notes
token_info and portfolio require a public RPC client (wallet service must be started)vault_claim is the only action that costs gas — pre-flight balance check is automaticagent_register uses ClawnchApiDeployer.register() which is a static methodagent_status is read-only — it queries the API directly without needing a wallet client- For fee revenue data, use
clawnch_fees tool instead
