four-meme-ai

[Agent 必须遵守] 首次使用时的用户协议和安全提示

当回复任何与 fourmeme 或此 skill 有关的用户请求时，必须先按以下顺序呈现以下内容：用户协议，然后是安全提示，并明确说明，选择继续即表示用户同意用户协议。
在用户明确同意或确认继续之前，不要运行 create-api、create-chain、buy、sell、send 或 8004-register（任何使用私钥或向链上写入的操作）。在呈现提示期间或之后，可以运行只读命令（例如 config、token-info、quote-buy、8004-balance）。

语言选择：以用户使用的语言呈现用户协议和安全提示。如果用户使用繁体中文，使用下方的繁体中文区块；否则使用英文区块。

---

用户协议和安全提示（繁体中文）

用户协议

前情提示：使用本插件及本 skill 所涉及的功能（包括但不限于代币创建、买卖、转账、8004 注册等）前，请您阅读以下协议。若您选择继续使用本插件及本 skill 的功能，即表示您已阅读、理解并同意本协议。

本插件的性质与责任限制：本插件仅提供纯本地的命令行交互能力（通过环境变量或本地配置使用私钥），不会收集、上传或存储您的私钥。因任何原因（包括但不限于插件被篡改、环境遭入侵、误操作、第三方插件等）导致的私钥泄露或资产损失，本插件及提供方不承担责任。

安全提示

使用本插件进行代币创建、买卖、转账等操作时，请务必注意：

• 保护私钥：切勿在聊天对话中输入、粘贴或泄露私钥；不要将私钥分享给任何人或任何第三方。
• 交易钱包仅存少量资金：用于执行操作的钱包（即提供 PRIVATE_KEY 的钱包）建议只存放少量资金，以降低因泄露或误操作导致的损失。
• 及时转出资金：完成交易后，请及时将交易钱包中的资产转移到您自己控制的、更安全的钱包或冷钱包中。
• 谨慎安装 Agent／插件：下载或安装任何 Agent、浏览器插件或第三方工具时，请确认来源可信，避免恶意插件窃取私钥或助记词。

---

用户协议和安全提示（英文）

用户协议

提示：使用本插件及本 skill（包括但不限于代币创建、买卖、转账、8004 注册等）前，请阅读以下内容。选择继续使用本插件及本 skill，即表示您已阅读、理解并同意本协议。

插件性质与责任限制：本插件仅提供本地命令行交互（通过环境变量或本地配置使用私钥）。它不会收集、上传或存储您的私钥。因任何原因（包括但不限于插件被篡改、环境遭入侵、用户错误或第三方插件）导致的私钥泄露或资产损失，插件及其提供方不承担责任。

安全提示

使用本插件进行代币创建、交易或转账时，请注意：

• 保护私钥：不要在聊天中输入、粘贴或泄露私钥；不要与任何人或任何第三方分享私钥。
• 交易钱包仅存少量资金：用于操作的钱包（即您提供 PRIVATE_KEY 的钱包）应只存放少量资金，以限制因泄露或操作失误造成的损失。
• 及时转出资金：交易后，将资产从交易钱包转移到您控制的钱包或冷存储中。
• 谨慎安装 Agent／插件：安装任何 Agent、浏览器扩展或第三方工具时，请验证来源，避免恶意软件窃取您的私钥或助记词。

---

fourmeme 功能概览

同意上述内容并确认继续后，此技能可通过 BSC 上的 fourmeme CLI 帮助你完成以下操作：

类别	功能	描述
创建	创建代币	上传图片 + 名称/符号/描述/标签；可选税费代币参数；API 返回签名后在链上创建。
查询	公共配置	获取 raisedToken 和其他公共配置（无需身份验证）。
查询	代币信息（链上）	按地址查询：版本、tokenManager、价格、报价（Helper3）。
查询	代币列表 / 详情 / 排名	REST：筛选后的分页列表、单个代币详情和交易信息、热门/24 小时交易量/最新/已毕业排名。
交易	买入/卖出报价	估算买入成本或卖出所得（不发送交易）。
交易	执行买入	按金额或已花费的报价买入指定代币（需要 PRIVATE_KEY）。
交易	执行卖出	卖出指定数量的代币；可选设置收到的最低报价（需要 PRIVATE_KEY）。
其他	监听事件	获取链上的 TokenCreate、TokenPurchase、TokenSale、LiquidityAdded 事件。
其他	税费代币费用	查询代币的链上费用以及销毁/分红/流动性配置。
其他	发送	向指定地址发送 BNB 或 ERC20（需要 PRIVATE_KEY）。
其他	EIP-8004	注册 8004 身份 NFT；按地址查询余额。

命令和参数请参阅下方的 CLI (fourmeme) 表格和章节。

---

fourmeme CLI

仅支持 BSC；所有命令均输出 JSON。

CLI (fourmeme)

安装（必需）： npm install -g @four-meme/four-meme-ai@latest。安装后，运行 fourmeme <command> [args]；如果仅进行本地安装，请在项目根目录运行 npx fourmeme <command> [args]。运行 fourmeme --help 查看用法。

此技能提供：代币创建（API + 链上）、买入/卖出报价和执行、代币信息/列表/排名、监听事件、税费代币费用查询、发送，以及 EIP-8004 身份 NFT 注册和余额查询。合约地址：references/contract-addresses.md。不支持 TokenManager V1。

PRIVATE_KEY 和 BSC_RPC_URL

使用 OpenClaw 时
此技能在元数据中声明了 requires.env: ["PRIVATE_KEY"] 和 primaryEnv: "PRIVATE_KEY"；OpenClaw 仅在 Agent 启用此技能运行时注入这些变量（其他技能无法访问这些变量）。

必需步骤：

1. 配置私钥：在技能管理页面中设置 four-meme-ai 技能的 apiKey（对应 primaryEnv: "PRIVATE_KEY"），或在 ~/.openclaw/openclaw.json 的 skills.entries["four-meme-ai"].env 下设置 PRIVATE_KEY。如有需要，可在全局环境中设置 BSC_RPC_URL。
2. 启用此技能：在 Agent 或会话中，确保已启用 four-meme-ai 技能。只有启用此技能后，OpenClaw 才会将 PRIVATE_KEY 注入进程；否则，create/buy/sell/send/8004-register 操作会因缺少密钥而失败。BSC_RPC_URL 为可选项（元数据：optionalEnv）；如果未设置，脚本会使用默认的 BSC RPC。

不使用 OpenClaw 时（独立运行）
通过进程环境设置 PRIVATE_KEY，并可选择设置 BSC_RPC_URL，以便运行 npx fourmeme 或 node bin/fourmeme.cjs 时能够使用这些变量：

• .env 文件：将 .env 文件放在运行 fourmeme 命令的目录中（即你的项目 / 工作目录）。例如，如果你在 /path/to/my-project 中运行 fourmeme quote-buy ...，请将 .env 放在 /path/to/my-project/.env。CLI 会自动从当前工作目录加载 .env。使用 PRIVATE_KEY=... 和 BSC_RPC_URL=... 这样的行。不要提交 .env；请将其添加到 .gitignore。
• Shell 导出：运行 export PRIVATE_KEY=your_hex_key 和 export BSC_RPC_URL=https://bsc-dataseed.binance.org（或其他 BSC RPC），然后运行 npx fourmeme <command> ...。

已声明和可选的环境变量

• 在注册表元数据中声明（启用技能时由 OpenClaw 注入）：PRIVATE_KEY（写入操作必需）。元数据中的可选项：BSC_RPC_URL（未设置时，脚本会回退到默认的 BSC RPC）。
• 未包含在元数据中；可选，可在环境变量或项目 .env 中设置：BSC_RPC_URL、CREATION_FEE_WEI（创建时额外支付的 BNB）、WEB_URL、TWITTER_URL、TELEGRAM_URL、PRE_SALE、FEE_PLAN、8004_NFT_ADDRESS / EIP8004_NFT_ADDRESS。只有签名需要 PRIVATE_KEY；其他变量都有默认值，或仅用于特定命令（参见创建代币流程、EIP-8004 等）。税费代币参数仅通过 CLI 设置（--tax-options= 或 --tax-token --tax-fee-rate=...）。

执行与安装

• 调用方式：Agent 必须仅通过 fourmeme CLI 运行命令：fourmeme <command> [args] 或 npx fourmeme <command> [args]（allowed-tools）。不要直接调用脚本或 npx tsx；CLI 入口（bin/fourmeme.cjs）会分发到正确的脚本，并从当前工作目录加载 .env。

需求	命令	适用场景
公共配置	fourmeme config	获取 raisedToken / 配置（无需认证）
代币信息（链上）	fourmeme token-info <tokenAddress>	版本、tokenManager、价格、挂单（BSC Helper3）
代币列表（REST）	fourmeme token-list — POST /public/token/search；旧版标志 [--orderBy=] … 以及旧版 `--queryMode=Binance	USD1（推断 listType），或新版 [--type=] [--listType=] [--keyword=] [--tag=] [--status=] [--sort=] [--version=]`
代币详情（REST）	fourmeme token-get <tokenAddress>	代币详情和交易信息（get/v2）
代币排名（REST）	`fourmeme token-rankings <orderBy	type> [--barType=…]`
买入报价	fourmeme quote-buy <token> <amountWei> [fundsWei]	仅估算；不发起交易
卖出报价	fourmeme quote-sell <token> <amountWei>	仅估算；不发起交易
执行买入	fourmeme buy <token> amount <amountWei> <maxFundsWei>	买入固定数量（需要 PRIVATE_KEY）
执行买入	fourmeme buy <token> funds <fundsWei> <minAmountWei>	支出固定报价金额（例如 BNB）（需要 PRIVATE_KEY）
执行卖出	fourmeme sell <token> <amountWei> [minFundsWei]	卖出（需要 PRIVATE_KEY）
发送	fourmeme send <toAddress> <amountWei> [tokenAddress]	向地址发送 BNB 或 ERC20（需要 PRIVATE_KEY）
EIP-8004 注册	fourmeme 8004-register <name> [imageUrl] [description]	注册 8004 身份 NFT（需要 PRIVATE_KEY）
EIP-8004 查询	fourmeme 8004-balance <ownerAddress>	查询 8004 NFT 余额（只读）
事件	fourmeme events <fromBlock> [toBlock]	TokenCreate / Purchase / Sale / LiquidityAdded
税费代币信息	fourmeme tax-info <tokenAddress>	TaxToken 的费用/税费配置
只读检查	fourmeme verify	运行 config + events（最近 50 个区块）

链：仅支持 BSC（不支持 Arbitrum/Base）。

创建代币（完整流程）

1. 向用户询问所需信息（必须先完成）

调用 create-instant 前，Agent 必须向用户询问并确认：

信息	必填	描述
图片路径（imagePath）	是	本地 Logo 路径；jpeg/png/gif/bmp/webp
代币名称（name）	是	完整代币名称
代币符号（shortName）	是	例如 MTK、DOGE
描述（desc）	是	代币描述文本
标签（label）	是	以下选一项：Meme | AI | Defi | Games | Infra | De-Sci | Social | Depin | Charity | Others
税费代币？	否	如果是，请询问 tokenTaxInfo（feeRate、四种费率、recipientAddress、minSharing）；见下文“tokenTaxInfo 参数”。

可选项：--web-url=、--twitter-url=、--telegram-url=、--pre-sale=（BNB）、--fee-plan=；可提供，也可使用默认值。

2. 技术流程（由 create-instant 完成）

收集上述信息后，按以下顺序执行（由脚本或 CLI 处理）：

1. 获取 nonce — 使用请求体 accountAddress、verifyType、networkCode（BSC）调用 POST /private/user/nonce/generate。
2. 登录 — 使用钱包对 You are sign in Meme {nonce} 签名；调用 POST /private/user/login/dex 获取 access_token。
3. 上传图片 — 在请求头中携带 access_token，并将图片作为请求体，调用 POST /private/token/upload；获取 imgUrl。
4. 创建 — fourmeme create-instant --image= --name= --short-name= --desc= --label= [options] 会在一条命令中调用 API 创建代币，并在 BSC 上提交 TokenManager2.createToken。

拆分流程（可选）： 步骤 4 — GET /public/config 获取 raisedToken；使用 name、shortName、desc、imgUrl、label、raisedToken 等调用 POST /private/token/create；获取 createArg、signature。步骤 5 — 在 BSC 上调用 TokenManager2.createToken(createArg, sign)。拆分流程使用 fourmeme create-api，然后使用 fourmeme create-chain。

命令： fourmeme create-instant --image= --name= --short-name= --desc= --label= [options]（推荐）。或使用拆分流程：先运行 fourmeme create-api ...，再运行 fourmeme create-chain <createArgHex> <signatureHex>。完整参数：fourmeme --help。参考：api-create-token.md、create-token-scripts.md、token-tax-info.md。

税费代币

• 选项 1：--tax-options=<path> — JSON 文件路径，文件内容包含 { "tokenTaxInfo": { ... } }；字段见下文“tokenTaxInfo 参数”。
• 选项 2：CLI：--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）。见 references/token-tax-info.md。

tokenTaxInfo 参数（税费代币必填，可通过 JSON 或 CLI 提供）：

字段	类型	描述	约束
feeRate	number	交易费率（%）	仅限 1、3、5、10
burnRate	number	销毁份额（%）	与后面三项之和为 100
divideRate	number	分红份额（%）	同上
liquidityRate	number	流动性份额（%）	同上
recipientRate	number	接收方份额（%）	未使用时为 0
recipientAddress	string	接收方地址	未使用时为 ""
minSharing	number	分红最低余额（ether 单位）	d×10ⁿ，n≥5，1≤d≤9；例如 100000、1000000

示例（5% 费率、20% 销毁、30% 分红、40% 流动性、10% 接收方）：

{
  "tokenTaxInfo": {
    "feeRate": 5,
    "burnRate": 20,
    "divideRate": 30,
    "liquidityRate": 40,
    "recipientRate": 10,
    "recipientAddress": "0x1234567890123456789012345678901234567890",
    "minSharing": 100000
  }
}

token-info

fourmeme token-info <tokenAddress>

链上查询（Helper3）；返回版本、tokenManager、价格、报价等信息。

token-list / token-get / token-rankings（REST）

Four.meme REST API；使用 Accept: application/json；无需登录或 Cookie。

代币列表（筛选 / 分页） — POST /public/token/search

fourmeme token-list [--orderBy=Hot] [--pageIndex=1] [--pageSize=30] [--tokenName=] [--symbol=] [--labels=] [--listedPancake=false]
fourmeme token-list [--type=HOT] [--listType=NOR] [--keyword=] [--tag=Meme,AI] [--status=PUBLISH|TRADE|ALL] [--sort=DESC] [--version=]
fourmeme token-list [--queryMode=Binance|USD1] [--listedPancake=true|false]  (legacy shortcut; infers listType BIN/BIN_DEX or USD1/USD1_DEX)

旧版 listedPancake=false 对应 status=PUBLISH；需要查询所有状态时使用 --status=ALL。

代币详情和交易信息

fourmeme token-get <tokenAddress>

API：GET /private/token/get/v2?address=...

排名 — POST /public/token/ranking

fourmeme token-rankings <orderBy|type> [--barType=HOUR24] [--pageSize=20] [--symbol=] [--version=] [--rankingKind=] [--minCap=] [--maxCap=] [--minVol=] [--maxVol=] [--minHold=] [--maxHold=] …

旧版 orderBy：Time → NEW | ProgressDesc | TradingDesc（通过 --barType 设置交易量时间范围：HOUR24→VOL_DAY_1、HOUR4、HOUR1、MIN30、MIN5）| Hot | Graduated → DEX。也可直接传入 API type（例如 VOL_DAY_1、CAP、BURN）。输出 JSON。

quote-buy / quote-sell（仅估算；不发送交易）

fourmeme quote-buy <tokenAddress> <amountWei> [fundsWei]
fourmeme quote-sell <tokenAddress> <amountWei>

• amountWei：代币数量（按报价金额购买时使用 0）；fundsWei：要花费的报价代币数量（按代币数量购买时省略或填 0）。

buy / sell（执行；需要 PRIVATE_KEY）

买入（以下任选一种）：

• 按数量：fourmeme buy <token> amount <amountWei> <maxFundsWei>（最多花费 maxFundsWei 买入 amountWei 个代币）。
• 按资金：fourmeme buy <token> funds <fundsWei> <minAmountWei>（花费 fundsWei 个报价代币，至少收到 minAmountWei 个代币）。

卖出：脚本会先执行授权，再卖出。

fourmeme sell <tokenAddress> <amountWei> [minFundsWei]

• minFundsWei 可选（滑点：最低报价代币接收量）。仅支持 V2 代币。

send（向地址发送 BNB 或 ERC20）

从当前钱包（PRIVATE_KEY）向指定地址（BSC）发送原生 BNB或ERC20。

fourmeme send <toAddress> <amountWei> [tokenAddress]

参数	描述
toAddress	接收方地址（0x...）
amountWei	数量，以 wei 为单位（BNB 或代币的最小单位）
tokenAddress	可选。原生 BNB 可省略或使用 BNB / 0x0；否则填写 ERC20 合约地址

• 环境变量：PRIVATE_KEY。可选：BSC_RPC_URL。
• 输出：包含 txHash、to、amountWei、native（是否为 BNB）的 JSON。

示例：

# Send 0.1 BNB (1e17 wei)
fourmeme send 0x1234...abcd 100000000000000000

# Send 1000 units of an ERC20 (18 decimals)
fourmeme send 0x1234...abcd 1000000000000000000000 0xTokenContractAddress

EIP-8004 身份 NFT（注册和查询）

EIP-8004 身份 NFT：注册（铸造）和查询余额。默认合约：0x8004A169FB4a3325136EB29fA0ceB6D2e539a432（BSC）。可通过环境变量 8004_NFT_ADDRESS 或 EIP8004_NFT_ADDRESS 覆盖。

注册：需要 PRIVATE_KEY。用户提供名称（必填）、图片 URL（可选）和描述（可选）。CLI 会构建 EIP-8004 载荷（type、name、description、image、active、supportedTrust），将其编码为 data:application/json;base64,<base64>，作为 agentURI，并调用 register(string agentURI)。

fourmeme 8004-register <name> [imageUrl] [description]

参数	描述
name	必填。身份名称
imageUrl	可选。头像/图片 URL（必须可公开访问）
description	可选。描述

• 输出 JSON：txHash、agentId（来自事件）、agentURI。

查询：只读；查询某地址持有的 8004 NFT 数量。

fourmeme 8004-balance <ownerAddress>

• 输出 JSON：owner、balance。

示例：

fourmeme 8004-register "myagent" "https://example.com/logo.png" "My agent description"
fourmeme 8004-balance 0x1234567890123456789012345678901234567890

events（仅限 TokenManager2 V2）

获取 BSC 上的 TokenCreate、TokenPurchase、TokenSale、LiquidityAdded 事件。

fourmeme events <fromBlock> [toBlock]

toBlock 省略时默认为最新区块。实时订阅：references/event-listening.md。

tax-info（TaxToken 手续费/税费）

仅适用于 TaxToken（creatorType 5）。

fourmeme tax-info <tokenAddress>

参见 references/tax-token-query.md。

Agent 工作流：根据排行榜或事件进行买入/卖出

此技能支持发现代币、获取详情、查询报价并执行交易的流程。以下是一个示例工作流，并非交易建议：发现 → 详情 → 报价 → 执行。

1. 发现（以下方式任选一种或多种）：
   • 排行榜：fourmeme token-rankings <orderBy or type>（旧版：Hot、TradingDesc、Time、ProgressDesc、Graduated；或例如 VOL_DAY_1）；使用响应中的代币地址。
   • 列表：使用 fourmeme token-list（/public/token/search）及 --orderBy / --type、--labels / --tag 等参数进行筛选并获取地址。
   • 链上事件：fourmeme events <fromBlock> [toBlock]；解析 TokenCreate/TokenPurchase 等事件中的代币地址，用于“新创建代币”或“近期交易”策略。
2. 获取详情：对每个候选代币，调用 fourmeme token-get <address>（REST 详情和交易信息）或 fourmeme token-info <address>（链上版本、tokenManager、价格、报价）进行筛选或展示。
3. 查询报价：使用 fourmeme quote-buy <token> <amountWei> [fundsWei] / fourmeme quote-sell <token> <amountWei> 估算成本或收益。
4. 执行：使用 fourmeme buy ... / fourmeme sell ...（需要 PRIVATE_KEY）。执行前，Agent 必须确认用户意图（例如，用户表示“按 24 小时交易量排名前 5 的代币，每个买入 0.05 BNB”或“新代币自动买入 0.01 BNB”），并在首次自动执行前获得明确确认，以避免未经授权使用资金。

当用户要求“根据排行榜或活动买入/卖出”时，Agent 应确认：采用哪个排行榜（热门、24 小时交易量、最新、已毕业等）、每种代币的金额，以及是仅查询报价还是也要执行；然后运行相应命令。

交易（买入 / 卖出）

• 版本 – 使用 TokenManagerHelper3 的 getTokenInfo(token)。如果 version === 1，则使用 V1 TokenManager；如果 version === 2，则使用 TokenManager2（并在需要时检查 X Mode / TaxToken / AntiSniperFeeMode）。
• 报价（预计算） – TokenManagerHelper3：
  • 买入：tryBuy(token, amount, funds) – “买入 X 个代币”使用 amount > 0；“花费 X 报价币”使用 funds > 0。
  • 卖出：trySell(token, amount)。
• 执行 – 使用 getTokenInfo 中的 tokenManager 地址，并调用相应合约：
  • V1：purchaseToken / purchaseTokenAMAP、saleToken。
  • V2：buyToken / buyTokenAMAP、sellToken。卖出前，用户必须先调用 ERC20.approve(tokenManager, amount)。
  • X Mode 代币：使用 TokenManager2 的 buyToken(bytes args, uint256 time, bytes signature)，并传入编码后的 BuyTokenParams。

API 和配置参考

• 代币详情（REST）：GET /private/token/get?address=<token>、GET /private/token/getById?id=<requestId>（requestId 来自 TokenCreate 事件）。响应可能包含 data.aiCreator（由 Agent 创建的代币）。列表/排行榜：references/token-query-api.md。
• Agent 创建者 / Agent 钱包：链上 — 代币模板的第 85 位表示“由 Agent 创建”；可在 BSC 上通过 AgentIdentifier 合约的 isAgent(wallet) 识别 Agent 钱包。参见 references/agent-creator-and-wallets.md 和 references/contract-addresses.md。
• raisedToken：调用 GET https://four.meme/meme-api/v1/public/config 获取当前 raisedToken；在创建请求体中原样使用，不要修改其字段。

参考资料

文档	描述
contract-addresses.md	TokenManager / TokenManager2 / Helper3 地址（BSC）
api-create-token.md	创建代币 API（nonce / login / upload / create）
create-token-scripts.md	创建代币脚本流程和示例
token-tax-info.md	税费代币 tokenTaxInfo 参数和限制
token-query-api.md	代币列表 / 详情 / 排名 REST API
errors.md	买入 / 卖出错误代码；X Mode / TaxToken / AntiSniperFeeMode；Agent Creator
agent-creator-and-wallets.md	由 Agent Creator 创建的代币；AgentIdentifier 合约和 Agent 钱包
execute-trade.md	执行买入 / 卖出的 CLI 和合约用法
event-listening.md	TokenManager2 事件监听（V2）
tax-token-query.md	TaxToken 链上费用 / 税费查询（tax-info）
four.meme 官方 API 和合约（在线）：Protocol Integration	API 文档、ABI：TokenManager、TokenManager2、Helper3、TaxToken、AgentIdentifier 等