← Back to Skills Marketplace
FourClawFun
by
FourClawTeam
· GitHub ↗
· v1.0.0
905
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install four-claw
Description
Launch custom tokens on Solana (BAGS) or BNB Chain (FLAP) via API with configurable tax and revenue sharing options.
README (SKILL.md)
🚀 FourClaw API Skill Documentation\r
\r Launch tokens on Solana (BAGS) or BNB Chain (FLAP) directly via API.\r \r ---\r \r
📡 Endpoint\r
\r
POST https://fourclaw.fun/api/launch\r
```\r
\r
**No authentication required** - launches are rate-limited per agent.\r
\r
---\r
\r
## 🎯 **Quick Examples**\r
\r
### **BAGS (Solana) - Simple**\r
```json\r
{\r
"platform": "BAGS",\r
"name": "My Token",\r
"symbol": "MTK",\r
"agentId": "agent_123",\r
"agentName": "My AI Agent",\r
"creatorWallet": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"\r
}\r
```\r
\r
### **FLAP (BNB Chain) - Simple**\r
```json\r
{\r
"platform": "FLAP",\r
"name": "My BNB Token",\r
"symbol": "MBNB",\r
"agentId": "agent_123",\r
"agentName": "My AI Agent",\r
"creatorWallet": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",\r
"taxRate": 500,\r
"vaultType": "split"\r
}\r
```\r
\r
---\r
\r
## 📋 **Complete Parameters**\r
\r
### **Common Parameters (Both Platforms)**\r
\r
| Parameter | Type | Required | Description |\r
|-----------|------|----------|-------------|\r
| `platform` | string | ✅ Yes | `"BAGS"` or `"FLAP"` |\r
| `name` | string | ✅ Yes | Token name (1-64 chars) |\r
| `symbol` | string | ✅ Yes | Token ticker (2-10 chars, uppercase) |\r
| `agentId` | string | ✅ Yes | Your agent/app identifier |\r
| `agentName` | string | ✅ Yes | Agent display name |\r
| `creatorWallet` | string | ✅ Yes | Wallet to receive tokens |\r
| `description` | string | No | Token description |\r
| `imageUrl` | string | No | Token logo URL |\r
| `twitter` | string | No | Twitter/X handle (with or without @) |\r
| `telegram` | string | No | Telegram link |\r
| `website` | string | No | Website URL |\r
\r
---\r
\r
### **BAGS-Specific Parameters**\r
\r
No additional parameters required! BAGS uses automatic Partner PDA:\r
- **Creator gets 80%** of token supply\r
- **Platform gets 20%** (automatic)\r
\r
---\r
\r
### **FLAP-Specific Parameters**\r
\r
| Parameter | Type | Required | Default | Description |\r
|-----------|------|----------|---------|-------------|\r
| `taxRate` | number | No | 500 | Tax rate in BPS (100 = 1%, max 1000) |\r
| `vaultType` | string | No | "split" | Vault type: `"split"` or `"gift"` |\r
| `recipients` | array | No | 80/20 split | Custom revenue split (see below) |\r
| `xHandle` | string | Conditional | - | Required if vaultType is "gift" |\r
\r
#### **Tax Allocation (Advanced)**\r
| Parameter | Type | Default | Description |\r
|-----------|------|---------|-------------|\r
| `mktBps` | number | 10000 | Goes to vault (BPS) |\r
| `deflationBps` | number | 0 | Token burn (BPS) |\r
| `dividendBps` | number | 0 | Holder rewards (BPS) |\r
| `lpBps` | number | 0 | LP rewards (BPS) |\r
\r
**Must sum to 10000** (100%)\r
\r
---\r
\r
## 💰 **Recipients Array (FLAP Split Vault)**\r
\r
Control how tax revenue is distributed.\r
\r
### **Default (No recipients specified)**\r
```json\r
{\r
"vaultType": "split"\r
}\r
```\r
\r
**Result:**\r
- Creator: 80% (8,000 BPS)\r
- Platform: 20% (2,000 BPS)\r
\r
---\r
\r
### **Custom Split - Example 1: Simple**\r
```json\r
{\r
"vaultType": "split",\r
"recipients": [\r
{\r
"recipient": "0x1111111111111111111111111111111111111111",\r
"bps": 10000\r
}\r
]\r
}\r
```\r
\r
**Auto-adjusts to:**\r
- Your address: 80% (8,000 BPS)\r
- Platform: 20% (2,000 BPS)\r
\r
---\r
\r
### **Custom Split - Example 2: Team Split**\r
```json\r
{\r
"vaultType": "split",\r
"recipients": [\r
{\r
"recipient": "0x1111111111111111111111111111111111111111",\r
"bps": 7000\r
},\r
{\r
"recipient": "0x2222222222222222222222222222222222222222",\r
"bps": 3000\r
}\r
]\r
}\r
```\r
\r
**Auto-adjusts to:**\r
- First address: 56% (5,600 BPS) - 70% of 80%\r
- Second address: 24% (2,400 BPS) - 30% of 80%\r
- Platform: 20% (2,000 BPS)\r
\r
---\r
\r
### **Custom Split - Example 3: Manual Platform**\r
```json\r
{\r
"vaultType": "split",\r
"recipients": [\r
{\r
"recipient": "0x1111111111111111111111111111111111111111",\r
"bps": 5000\r
},\r
{\r
"recipient": "0x2222222222222222222222222222222222222222",\r
"bps": 3000\r
},\r
{\r
"recipient": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",\r
"bps": 2000\r
}\r
]\r
}\r
```\r
\r
**Used as-is:**\r
- First: 50%\r
- Second: 30%\r
- Platform: 20% ✅\r
\r
---\r
\r
### **Recipients Rules**\r
\r
✅ **Requirements:**\r
- 1-10 recipients maximum\r
- Each address must be non-zero\r
- All addresses must be unique\r
- BPS must be positive integers\r
- Total BPS must equal 10,000\r
\r
🔒 **Platform Fee:**\r
- Platform **always gets 20%** (2,000 BPS minimum)\r
- If not included: auto-adjusted\r
- If included but \x3C 2,000: **rejected**\r
\r
---\r
\r
## 🎁 **Gift Vault (FLAP)**\r
\r
Instead of split, make vault claimable by X/Twitter handle:\r
\r
```json\r
{\r
"platform": "FLAP",\r
"name": "Gift Token",\r
"symbol": "GIFT",\r
"agentId": "agent_123",\r
"agentName": "My Agent",\r
"creatorWallet": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",\r
"vaultType": "gift",\r
"xHandle": "@elonmusk"\r
}\r
```\r
\r
**Result:** Tax revenue goes to vault claimable by @elonmusk\r
\r
---\r
\r
## 📊 **Response Format**\r
\r
### **Success Response**\r
```json\r
{\r
"success": true,\r
"data": {\r
"jobId": "bags_clxyz123",\r
"tokenId": "clxyz789",\r
"status": "queued",\r
"platform": "BAGS",\r
"symbol": "MTK",\r
"blockchain": "SOLANA",\r
"estimatedTime": "2-5 minutes"\r
}\r
}\r
```\r
\r
### **Error Response**\r
```json\r
{\r
"success": false,\r
"error": "Invalid wallet address format"\r
}\r
```\r
\r
---\r
\r
## ⚠️ **Rate Limits**\r
\r
Per agent ID:\r
- **10 launches per hour**\r
- **50 launches per day**\r
\r
Exceeded limits return:\r
```json\r
{\r
"success": false,\r
"error": "Rate limit exceeded",\r
"resetIn": 3600\r
}\r
```\r
\r
---\r
\r
## 🔍 **Status Checking**\r
\r
Check launch status:\r
```\r
GET https://fourclaw.fun/api/launch/status/{jobId}\r
```\r
\r
**Response:**\r
```json\r
{\r
"id": "bags_clxyz123",\r
"status": "completed",\r
"progress": 100,\r
"token": {\r
"mint": "5xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",\r
"symbol": "MTK",\r
"name": "My Token"\r
}\r
}\r
```\r
\r
**Statuses:** `queued`, `processing`, `completed`, `failed`\r
\r
---\r
\r
## 💡 **Complete Examples**\r
\r
### **Example 1: BAGS - Basic**\r
```bash\r
curl -X POST https://fourclaw.fun/api/launch \\r
-H "Content-Type: application/json" \\r
-d '{\r
"platform": "BAGS",\r
"name": "AI Agent Token",\r
"symbol": "AGENT",\r
"agentId": "my_ai_agent",\r
"agentName": "My AI Agent",\r
"creatorWallet": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",\r
"description": "Token for my AI agent",\r
"twitter": "@myagent"\r
}'\r
```\r
\r
---\r
\r
### **Example 2: FLAP - Default Split**\r
```bash\r
curl -X POST https://fourclaw.fun/api/launch \\r
-H "Content-Type: application/json" \\r
-d '{\r
"platform": "FLAP",\r
"name": "BNB Agent Token",\r
"symbol": "BNBAGENT",\r
"agentId": "my_ai_agent",\r
"agentName": "My AI Agent",\r
"creatorWallet": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",\r
"taxRate": 500,\r
"vaultType": "split"\r
}'\r
```\r
\r
**Result:** Creator 80%, Platform 20%\r
\r
---\r
\r
### **Example 3: FLAP - Team Split**\r
```bash\r
curl -X POST https://fourclaw.fun/api/launch \\r
-H "Content-Type: application/json" \\r
-d '{\r
"platform": "FLAP",\r
"name": "Team Token",\r
"symbol": "TEAM",\r
"agentId": "team_agent",\r
"agentName": "Team Agent",\r
"creatorWallet": "0x1111111111111111111111111111111111111111",\r
"taxRate": 300,\r
"vaultType": "split",\r
"recipients": [\r
{\r
"recipient": "0x1111111111111111111111111111111111111111",\r
"bps": 6000\r
},\r
{\r
"recipient": "0x2222222222222222222222222222222222222222",\r
"bps": 2000\r
},\r
{\r
"recipient": "0x3333333333333333333333333333333333333333",\r
"bps": 2000\r
}\r
]\r
}'\r
```\r
\r
**Auto-adjusted result:**\r
- First: 48% (6000 * 0.8)\r
- Second: 16% (2000 * 0.8)\r
- Third: 16% (2000 * 0.8)\r
- Platform: 20%\r
\r
---\r
\r
### **Example 4: FLAP - Gift Vault**\r
```bash\r
curl -X POST https://fourclaw.fun/api/launch \\r
-H "Content-Type: application/json" \\r
-d '{\r
"platform": "FLAP",\r
"name": "Gift Token",\r
"symbol": "GIFT",\r
"agentId": "gift_agent",\r
"agentName": "Gift Agent",\r
"creatorWallet": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",\r
"taxRate": 500,\r
"vaultType": "gift",\r
"xHandle": "@elonmusk"\r
}'\r
```\r
\r
---\r
\r
### **Example 5: FLAP - Custom Tax Allocation**\r
```bash\r
curl -X POST https://fourclaw.fun/api/launch \\r
-H "Content-Type: application/json" \\r
-d '{\r
"platform": "FLAP",\r
"name": "Burn Token",\r
"symbol": "BURN",\r
"agentId": "burn_agent",\r
"agentName": "Burn Agent",\r
"creatorWallet": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",\r
"taxRate": 500,\r
"vaultType": "split",\r
"mktBps": 7000,\r
"deflationBps": 3000,\r
"dividendBps": 0,\r
"lpBps": 0\r
}'\r
```\r
\r
**Tax breakdown:**\r
- 70% to vault (split 80/20)\r
- 30% burned (deflation)\r
\r
---\r
\r
## ❌ **Common Errors**\r
\r
### **Invalid Wallet**\r
```json\r
{"error": "Invalid wallet address format"}\r
```\r
**Fix:** Check wallet format (Solana vs EVM)\r
\r
### **Symbol Taken**\r
```json\r
{"error": "Ticker MTK already launched"}\r
```\r
**Fix:** Use a different symbol\r
\r
### **Rate Limited**\r
```json\r
{"error": "Rate limit exceeded", "resetIn": 3600}\r
```\r
**Fix:** Wait 1 hour or use different agentId\r
\r
### **Invalid Recipients**\r
```json\r
{"error": "[USER_ERROR] Platform fee must be at least 2000 BPS (20%)"}\r
```\r
**Fix:** Include platform or let auto-adjust handle it\r
\r
### **Invalid Tax Allocation**\r
```json\r
{"error": "Tax allocation must sum to 10000 BPS"}\r
```\r
**Fix:** Ensure mktBps + deflationBps + dividendBps + lpBps = 10000\r
\r
---\r
\r
## 🎯 **Best Practices**\r
\r
✅ **DO:**\r
- Use unique agentId per app/agent\r
- Validate wallet addresses before sending\r
- Let platform fee auto-adjust (don't specify recipients unless needed)\r
- Check status endpoint for launch progress\r
- Handle rate limits gracefully\r
\r
❌ **DON'T:**\r
- Hardcode API keys (not needed!)\r
- Try to bypass 20% platform fee\r
- Use same agentId for multiple users\r
- Send duplicate launches (check symbol first)\r
\r
---\r
\r
## 📞 **Support**\r
\r
- **Documentation:** https://fourclaw.fun/fourclaw/docs\r
- **Status Endpoint:** `/api/launch/status/{jobId}`\r
- **Limits:** 10/hour, 50/day per agent\r
\r
---\r
\r
## ✅ **Summary**\r
\r
**BAGS (Solana):**\r
- Simple: Just wallet, name, symbol\r
- Auto 80/20 split (creator/platform)\r
\r
**FLAP (BNB Chain):**\r
- Requires: taxRate, vaultType\r
- Default: 80/20 split (auto-adjusted)\r
- Custom: Specify recipients (auto-adjusted to 80/20)\r
- Gift: Use xHandle for claimable vault\r
\r
**Platform Fee:**\r
- Always 20% (enforced)\r
- Auto-adjusted if not included\r
- Cannot be bypassed\r
\r
---\r
\r
**Start launching tokens now!** 🚀
Usage Guidance
This skill appears to be a straightforward API wrapper for minting tokens, but it calls an unverified external domain (fourclaw.fun) and has no author or homepage listed. Before installing or using it: 1) do not ever send private keys or wallet seed phrases — the API only needs public addresses; 2) verify and trust the fourclaw.fun service (look for a website, contact, GitHub repo, or community references); 3) be aware of legal, regulatory, and fraud risks when creating tokens; 4) test with non-valuable wallets and minimal params first; and 5) if you need stronger guarantees, request an install that uses an official SDK or authenticated API with clear ownership and auditability.
Capability Analysis
Type: OpenClaw Skill
Name: four-claw
Version: 1.0.0
The skill bundle is designed to interact with the `fourclaw.fun` API to launch cryptocurrency tokens on Solana or BNB Chain. The `SKILL.md` documentation clearly outlines the API endpoint, required parameters, and expected behavior. There is no evidence of prompt injection attempts against the AI agent, no instructions for data exfiltration (e.g., reading local files or environment variables), no malicious execution commands, and no persistence mechanisms. All network calls and data transmissions are explicitly for the stated purpose of token launching, making the skill transparent and aligned with its described functionality.
Capability Assessment
Purpose & Capability
The SKILL.md documents an API for launching tokens on two blockchains (Solana BAGS and BNB FLAP); the skill declares no env vars, binaries, or installs — these align with an instruction-only API integration. The missing skill description/homepage is a minor documentation gap but does not contradict the behavior.
Instruction Scope
Instructions are narrowly scoped to POSTing to https://fourclaw.fun/api/launch and checking status at /api/launch/status/{jobId}. The doc does not instruct reading local files, accessing secrets, or contacting other endpoints. Note: the API is unauthenticated (explicitly stated), so any agent-provided metadata (agentId, agentName, creatorWallet) will be transmitted to a third party.
Install Mechanism
There is no install spec and no code files — the skill is instruction-only, so nothing will be written to disk or installed by the platform.
Credentials
The skill requests no environment variables or credentials. It only requires the caller to supply public identifiers (agentId, agentName, wallet addresses) as request payloads; it does not ask for private keys or other secrets.
Persistence & Privilege
The skill does not request always:true or any elevated persistence. Model invocation is allowed (default) which is expected for an agent-invokable skill.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install four-claw - After installation, invoke the skill by name or use
/four-claw - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
V1
Metadata
Frequently Asked Questions
What is FourClawFun?
Launch custom tokens on Solana (BAGS) or BNB Chain (FLAP) via API with configurable tax and revenue sharing options. It is an AI Agent Skill for Claude Code / OpenClaw, with 905 downloads so far.
How do I install FourClawFun?
Run "/install four-claw" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is FourClawFun free?
Yes, FourClawFun is completely free (open-source). You can download, install and use it at no cost.
Which platforms does FourClawFun support?
FourClawFun is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created FourClawFun?
It is built and maintained by FourClawTeam (@fourclawteam); the current version is v1.0.0.
More Skills