Agent Skills

four-meme-ai

CLI tool for creating and trading meme tokens on Four.Meme (BSC), with structured JSON outputs for config, token details, pricing quotes, on-chain events, and TaxToken fee configuration.

Instalação
CLI
npx skills add https://github.com/four-meme-community/four-meme-ai --skill four-meme-ai

Instale esta skill com a CLI e comece a usar o fluxo de trabalho SKILL.md em seu espaço de trabalho.

Última atualização em 6/14/2026

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): Use fourmeme create-instant ... for one-shot create (API + submit createToken in one command), or the two-step flow fourmeme create-api ... → fourmeme create-chain .... Both use the same args: --image=, --name=, --short-name=, --desc=, --label= (and optional --pre-sale=<BNB> in ether units, --web-url=, etc.). Creation is BSC only; value (launch fee + presale if any) is computed automatically for create-instant. See SKILL.md and references/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: npx fourmeme <command> [args]. Run npx fourmeme --help for the full list. See Commands and parameters below.

Commands and parameters

Command Parameters Description
config (none) Public config (raisedToken). No auth.
create-api --image= --name= --short-name= --desc= --label= [--web-url=] [--twitter-url=] [--telegram-url=] [--pre-sale=<BNB>] [--fee-plan=false] [--tax-options=<path>] or [--tax-token --tax-fee-rate=5 ...] Create token API only. Label: `Meme
create-chain <createArgHex> <signatureHex> [--value=<wei>] or -- (stdin JSON) Submit createToken on BSC. Env: PRIVATE_KEY.
create-instant --image= --name= --short-name= --desc= --label= [--web-url=] [--twitter-url=] [--telegram-url=] [--pre-sale=<BNB>] [--fee-plan=false] [--value=<wei>] [--tax-options=<path>] or [--tax-token --tax-fee-rate=5 ...] One-shot create (API + chain). Same options as create-api plus --value= override. Env: PRIVATE_KEY.
token-info <tokenAddress> On-chain token info (Helper3).
token-list Legacy query flags or [--type=] [--listType=] [--keyword=] [--tag=] [--status=] [--sort=] [--version=] … (also legacy `--queryMode=Binance USD1to inferlistType`)
token-get <tokenAddress> REST token detail + trading info.
token-rankings <orderBy or type> [--barType=] [--pageSize=] [--symbol=] [--version=] [--rankingKind=] [--minCap=] [--maxCap=] [--minVol=] [--maxVol=] [--minHold=] [--maxHold=] … POST /public/token/ranking; legacy orderBy or native type (e.g. VOL_DAY_1).
quote-buy <tokenAddress> <amountWei> [fundsWei] Estimate buy (no tx). Use 0 for amount or funds.
quote-sell <tokenAddress> <amountWei> Estimate sell (no tx).
buy <token> amount <amountWei> <maxFundsWei> Buy fixed amount. Env: PRIVATE_KEY.
buy <token> funds <fundsWei> <minAmountWei> Buy with fixed quote. Env: PRIVATE_KEY.
sell <tokenAddress> <amountWei> [minFundsWei] Execute sell. Env: PRIVATE_KEY.
send <toAddress> <amountWei> [tokenAddress] Send BNB or ERC20. Omit tokenAddress for BNB. Env: PRIVATE_KEY.
8004-register <name> [imageUrl] [description] EIP-8004 register NFT. Env: PRIVATE_KEY.
8004-balance <ownerAddress> EIP-8004 query balance.
events <fromBlock> [toBlock] TokenManager2 events (BSC).
tax-info <tokenAddress> TaxToken fee/tax config.
verify (none) Config + events (last 50 blocks). Read-only.

Create token optional (omit if empty): --web-url=, --twitter-url=, --telegram-url=. Presale: --pre-sale=<BNB> in ether (e.g. 0.001). Tax: --tax-options=<path> or --tax-token --tax-fee-rate=5 --tax-burn-rate=0 --tax-divide-rate=0 --tax-liquidity-rate=100 --tax-recipient-rate=0 --tax-recipient-address= --tax-min-sharing=100000 (burn+divide+liquidity+recipient=100).

Install (project)

cd four-meme-ai
npm install

Environment variables (without OpenClaw)

When you do not use OpenClaw, the CLI reads PRIVATE_KEY and BSC_RPC_URL from the process environment. Set them in one of these ways:

Option 1: .env file in the project root

Create a file named .env in the repo root (same directory as package.json):

# .env (do not commit this file)
PRIVATE_KEY=your_hex_private_key_with_or_without_0x_prefix
BSC_RPC_URL=https://bsc-dataseed.binance.org

Then run commands so that the shell loads .env before invoking fourmeme (e.g. use a tool that loads .env, or export $(cat .env | xargs) then npx fourmeme ...). The scripts themselves do not load .env; you must ensure the variables are in the environment when npx fourmeme runs.

Option 2: export in the shell

export PRIVATE_KEY=your_hex_private_key
export BSC_RPC_URL=https://bsc-dataseed.binance.org
npx fourmeme create-instant --image=./logo.png --name=MyToken --short-name=MTK --desc="Desc" --label=AI
  • PRIVATE_KEY: Required for any command that signs or sends a transaction (create-api, create-chain, buy, sell, send, 8004-register). Hex string; 0x prefix optional.
  • BSC_RPC_URL: Optional. BSC RPC endpoint; if unset, scripts use a default public BSC RPC.

Security: Do not commit .env or share your private key. Add .env to .gitignore if you use a .env file.

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-ai": {
        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