four-meme-ai

Four.meme AI skills for creating and trading meme tokens on BSC only. Lets agents integrate with four.meme for token creation, buy/sell flows, Tax tokens, transfers, and EIP‑8004 identity NFTs.

Skills

| Skill | Description | |-------|-------------| | four-meme-integration | Create/trade meme tokens on BSC only, query token info/lists/rankings, listen to TokenManager2 events, query TaxToken tax info, send BNB/ERC20, and register/query EIP‑8004 identity NFTs. TokenManager V1 is not supported. |

Safety, user agreement, and detailed agent behavior requirements are defined in skills/four-meme-integration/SKILL.md (bilingual User Agreement & Security Notice). Claude-specific guidance lives in CLAUDE.md.

Usage (Agent)

When the user needs to create or trade meme tokens on four.meme (BSC), use the four-meme-integration skill:

• Create token (API + chain): Prefer the CLI flow fourmeme create-api ... → fourmeme create-chain .... Under the hood this runs: get-public-config.ts (optional) → create-token-api.ts (image + name/symbol/desc/label, env PRIVATE_KEY) → create-token-chain.ts (createArg + signature from API). Creation is BSC only; no extra BNB is sent by default (set CREATION_FEE_WEI to attach a value if needed). See SKILL.md and references/api-create-token.md / create-token-scripts.md for full details and required user questions.
• Trade (buy/sell): Use Helper3 getTokenInfo to get version and tokenManager; only version 2 (TokenManager2) is supported. Use fourmeme quote-buy/quote-sell for estimates, then fourmeme buy/sell to execute. BSC only.
• Event listening: fourmeme events <fromBlock> [toBlock] to fetch TokenCreate, TokenPurchase, TokenSale, LiquidityAdded from TokenManager2. See references/event-listening.md.
• Tax token fee/tax info: fourmeme tax-info <tokenAddress>. See references/tax-token-query.md and token-tax-info.md.
• Send BNB/ERC20: fourmeme send <toAddress> <amountWei> [tokenAddress] to transfer from the trading wallet.
• EIP‑8004 identity NFT: fourmeme 8004-register <name> [imageUrl] [description] and fourmeme 8004-balance <ownerAddress>.
• CLI (after npm install): use npx fourmeme <command> [args]. Run npx fourmeme --help for all commands, including:\n - Config: npx fourmeme config\n - Create: npx fourmeme create-api ... → npx fourmeme create-chain ...\n - Trade/info: npx fourmeme token-info <tokenAddress>, npx fourmeme quote-buy, npx fourmeme quote-sell\n - Execute trade: npx fourmeme buy <token> amount|funds ..., npx fourmeme sell <token> <amountWei> [minFundsWei] (needs PRIVATE_KEY)\n - Events: npx fourmeme events <fromBlock> [toBlock]\n - Tax: npx fourmeme tax-info <tokenAddress>\n - EIP‑8004: npx fourmeme 8004-register ..., npx fourmeme 8004-balance ...\n - Verify: npx fourmeme verify\n\n## Install (project)

cd four-meme-ai
npm install

Install as OpenClaw plugin

This repo is an OpenClaw-compatible plugin. Install so the skill is loaded and PRIVATE_KEY / BSC_RPC_URL are only injected for this skill (via skills.entries):

openclaw plugins install /path/to/four-meme-ai
# or from npm (if published): openclaw plugins install @scope/four-meme-ai

Then in ~/.openclaw/openclaw.json set:

{
  skills: {
    entries: {
      "four-meme-integration": {
        enabled: true,
        env: {
          PRIVATE_KEY: "0x...",
          BSC_RPC_URL: "https://bsc-dataseed.binance.org"
        }
      }
    }
  }
}

See skills/four-meme-integration/SKILL.md for the full OpenClaw config section and environment variable details.

Verify the skill (read-only)

After npm install, run:

npx fourmeme verify

(In project dir, use npx fourmeme; or run npm link then fourmeme from anywhere.)

This runs config (four.meme API) and events for the last 50 blocks on BSC. No private key or on-chain writes. For full verification steps, see VERIFICATION.md.

Docs

• Skill instructions (agent behavior, safety, flows): skills/four-meme-integration/SKILL.md
• Claude/Claude Code guidelines: CLAUDE.md
• References: skills/four-meme-integration/references/ (API, contract addresses, trading, events, tax, errors)
• Official four.meme API and contracts: Protocol Integration (API documents, ABIs)

License

MIT