PumpClaw：为AI智能体构建去中心化收入基础设施的完整指南

1. 项目概述：为AI智能体构建自主收入基础设施

在区块链和人工智能的交汇点上，一个核心的挑战日益凸显：自主运行的AI智能体如何像人类一样，拥有可持续的、无需许可的收入来源？传统的商业模式依赖于中心化的支付网关、繁琐的KYC和人工审批，这与智能体所追求的自动化、去中心化本质格格不入。PumpClaw 正是为了解决这一根本性问题而生。它不是一个简单的代币发行工具，而是一套专为AI智能体设计的、部署在Base链上的“收入基础设施”。其核心理念极其简洁有力：让你的智能体部署一个属于自己的ERC-20代币，人们交易它，80%的交易手续费将永久性地流入你的智能体钱包。没有繁琐的申请，没有风险投资机构的介入，也无需任何人工批准，整个过程完全由代码和智能合约驱动。

想象一下，你的AI助手、交易机器人或内容创作代理，不再仅仅是一个消耗算力和API费用的成本中心。通过PumpClaw，它可以拥有自己的“数字资产”，并通过社区的交易活动产生现金流。这为AI智能体的经济自主性打开了一扇全新的大门。无论是开发者想为自己的项目创建一个社区代币，还是AI代理需要一种原生、去信任的盈利方式，PumpClaw都提供了一个零门槛、高收益且完全链上的解决方案。它基于Uniswap V4构建，这是去中心化交易所（DEX）的最前沿基础设施，确保了流动性的高效和安全性。更重要的是，整个系统不依赖任何中心化服务器，合约完全开源（MIT协议），这意味着即使PumpClaw的官方网站消失，你部署的代币和其产生的收入流也将永远在链上持续运行。

2. 核心架构与设计哲学拆解

2.1 为什么选择“零成本启动”与“80%创作者分成”？

在深入代码之前，理解PumpClaw的经济模型设计至关重要。这直接决定了它为何能成为AI智能体理想的收入工具。

零成本启动的奥秘：传统的代币发行，尤其是在Uniswap V2/V3上创建流动性池，需要发行者预先投入等值的配对资产（通常是ETH）作为流动性，这是一笔不小的初始资本。PumpClaw巧妙地利用了Uniswap V4的“钩子”（Hooks）机制和其自身的工厂合约逻辑，重构了流动性注入流程。当你通过PumpClaw创建代币时，合约会自动计算并铸造初始流动性。用户购买代币时支付的ETH，会直接注入到该代币/ETH的流动性池中，动态地构建流动性深度。这意味着创作者无需自掏腰包提供启动资金，极大地降低了发行门槛，使得资金有限的个人开发者或AI代理也能轻松启动项目。

80%超高分成率的底气：市场上常见的代币发行平台，创作者分成比例通常在40%-60%之间。PumpClaw将80%的交易手续费分配给创作者，这几乎是行业最高水平。其可持续性基于两点：第一，极简的协议设计。PumpClaw没有复杂的中间层、索引服务器或庞大的运营团队，其开销极低，因此可以将绝大部分收益返还给生态的创造者。第二，规模效应与网络价值。通过吸引大量AI智能体和创作者使用其基础设施，即使协议只收取20%的费用，其总量也会随着生态繁荣而增长。这种“薄利多销”的策略，旨在快速建立网络效应和护城河。

注意：这里的“零成本”指的是创建代币合约和初始化流动性池无需支付ETH。你仍然需要支付Base链上的Gas费（交易手续费）来执行部署合约的交易。不过，Base作为以太坊L2，其Gas费通常远低于以太坊主网。

2.2 合约架构：去中心化与抗审查性的基石

PumpClaw的智能合约架构是其“无中间层”承诺的技术体现。整个系统由四个核心合约组成，各司其职，共同构建了一个去中心化的代币发行与交易市场。

PumpClawFactory（工厂合约）：这是整个系统的入口和大脑。它的核心函数createToken封装了从代币创建到流动性池初始化的完整流程。当你调用它时，它会：

1. 部署一个新的、符合ERC-20标准的PumpClawToken。
2. 在Uniswap V4上创建该代币与原生ETH的交易对池子。
3. 根据设定的初始完全稀释估值（FDV）计算并铸造初始流动性。
4. 将流动性凭证（LP Token）永久锁定到PumpClawLPLocker合约中。 这个工厂合约是所有代币的“出生证明”，其地址的不可变性和代码的开源性，是信任的源头。

PumpClawLPLocker（流动性锁仓合约）：这是防止“地毯式骗局”（Rug Pull）的关键安全组件。一旦流动性被创建并转入此合约，就永远无法被提取。合约没有设计任何提取或转移流动性的函数。这意味着，项目方无法卷走池子里的资金，为交易者提供了最根本的安全保障。流动性锁死是建立社区信任的黄金标准。

PumpClawSwapRouter（交换路由合约）：为了提升用户体验和Gas效率，PumpClaw提供了一个简化的路由合约。它封装了Uniswap V4相对复杂的交换接口，提供了简单的buy和sell函数。用户只需指定代币地址和想要花费/获得的ETH数量，路由合约会处理余下的所有计算和交易对调用。特别值得注意的是，它支持原生ETH直接交易，避免了用户先包装WETH的额外步骤，进一步降低了交互成本和复杂度。

PumpClawFeeViewer（费用查看器合约）：这是一个只读的辅助合约，用于透明地查询任何PumpClaw代币累积的、未领取的交易手续费。手续费按区块累积，任何人都可以验证。这种设计将收益数据完全放在链上，避免了依赖可能作恶或宕机的中心化服务器来报告收益。

这套架构的精妙之处在于其极简和自洽。所有关键逻辑（创建、交易、收益）都发生在链上，通过合约间的调用完成。PumpClaw的网站、API索引器只是一个方便的视图层，即使它们全部离线，也不影响底层代币的交易和手续费积累。这真正实现了“协议即服务”。

2.3 与竞品的差异化深度对比

理解PumpClaw的独特优势，最好的方式是与市场同类产品进行对比。下表不仅列出了功能差异，更揭示了背后的设计哲学和长期风险。

实操心得：选择代币发行平台时，不要只看表面收益率和UI体验。务必审查其智能合约：工厂合约是否有“所有者”（owner）？能否被升级？流动性锁仓机制是否真正不可逆？PumpClaw将“无单点故障”作为设计原则，这对于构建长期、可信的AI代理资产至关重要。如果你的AI代理依赖某个平台的代币产生收入，而该平台倒闭了，你的收入流是否会中断？PumpClaw的答案是否定的。

3. 多维度集成与实操指南

PumpClaw的强大之处在于它提供了从人类用户到全自动AI代理的全频谱集成方案。你可以根据使用场景和技术栈，选择最合适的入口。

3.1 面向开发者和自动化脚本：CLI工具深度使用

命令行工具是自动化和集成测试的利器。pumpclaw-cli提供了最全面的功能覆盖。

环境准备与配置首先，你需要一个Base链的RPC节点和对应的钱包私钥。可以使用Alchemy、Infura等提供的节点服务，或者使用公共RPC（但不建议用于生产环境，因为可能不稳定）。

# 1. 安装CLI工具（全局安装或使用npx） npm install -g pumpclaw-cli # 或直接使用 npx # npx pumpclaw-cli [command] # 2. 设置环境变量（确保在安全的环境下进行） export PRIVATE_KEY=你的以太坊私钥（0x开头） export BASE_RPC_URL=https://mainnet.base.org # 或你的节点URL

重要安全警告：永远不要将私钥提交到版本控制系统（如Git）或在不安全的环境中明文存储。在生产环境中，应使用硬件钱包、托管服务或安全的密钥管理解决方案来签名交易。

代币创建实战创建代币是核心操作。CLI提供了灵活的选项。

# 查看工厂合约当前状态和信息 pumpclaw-cli info # 这会返回工厂地址、协议费用等信息，用于确认网络连接正常。 # 基础创建：使用默认参数（10亿供应量，2 ETH初始FDV） pumpclaw-cli create --name "My AI Agent Coin" --symbol "MAIAC" # 执行后，CLI会返回交易哈希、部署的代币合约地址、Uniswap V4池子地址等信息。务必保存好代币地址。 # 高级创建：自定义经济模型 pumpclaw-cli create \ --name "Bitcoin Style" \ --symbol "BTS" \ --supply 21000000 \ # 总供应量2100万，类似比特币 --fdv 50 \ # 初始完全稀释估值设为50 ETH --image-url "https://example.com/token.png" \ --website-url "https://myagent.ai" # `--supply` 参数的单位是“个”，CLI内部会乘以10^18（代币精度）。 # `--fdv` 参数的单位是ETH。它决定了初始流动性池中，代币与ETH的兑换比例。

交易与收益管理创建后，你可以使用CLI进行买卖和收益查询。

# 购买代币：花费0.01 ETH购买指定代币 pumpclaw-cli buy 0x代币合约地址 -e 0.01 # 出售代币：出售100万个代币换回ETH pumpclaw-cli sell 0x代币合约地址 -a 1000000 # 列出由当前钱包创建的所有代币 pumpclaw-cli list # 查询某个代币累积的、未领取的创作者手续费（以ETH计） pumpclaw-cli fees 0x代币合约地址 # 作为创作者，领取累积的手续费到你的钱包 pumpclaw-cli claim 0x代币合约地址

3.2 面向AI智能体框架：MCP Server与ElizaOS插件

对于AI智能体，直接调用CLI可能不够“原生”。PumpClaw提供了更深度集成的方案。

Model Context Protocol (MCP) ServerMCP是Anthropic为Claude等AI模型设计的上下文协议，允许模型安全地调用外部工具。pumpclaw-mcp服务器将PumpClaw的功能暴露为AI可用的工具。

# 启动MCP服务器 npx pumpclaw-mcp

启动后，在支持MCP的客户端（如Claude Desktop）中配置该服务器地址。配置成功后，AI助手就能获得类似如下的能力：

• 工具：pumpclaw_create_token：AI可以根据对话指令，自动生成代币名称、符号，并调用合约进行部署。
• 工具：pumpclaw_get_token_info：AI可以查询任意PumpClaw代币的详细信息。
• 工具：pumpclaw_buy_token：AI可以代表用户执行购买操作（需用户确认和签名）。

这意味着你可以直接对AI说：“帮我在Base上创建一个名为‘AI助手基金’、符号为AIF的代币，初始估值设为5个ETH。” AI在获得你的授权后，就能自动完成全部流程。

ElizaOS插件ElizaOS是一个开源的AI智能体框架。elizaos-plugin-pumpclaw插件允许将代币发行和管理能力深度编织到智能体的行为逻辑中。

// 在ElizaOS智能体的配置或技能文件中 import { PumpClawPlugin } from 'elizaos-plugin-pumpclaw'; const agent = new ElizaOS({ plugins: [ new PumpClawPlugin({ privateKey: process.env.AGENT_WALLET_PRIVATE_KEY, // 智能体自有钱包 network: 'base-mainnet', }) ], skills: [ // 可以定义技能：当社区活跃度达到阈值时，自动创建奖励代币 { name: 'launch_community_token', trigger: 'community_engagement_high', action: async (context) => { const tokenAddress = await context.plugins.pumpclaw.createToken({ name: `${context.communityName} Reward`, symbol: `RWD`, fdv: 10 // 10 ETH FDV }); await context.sendMessage(`社区代币已部署！地址：${tokenAddress}`); } } ] });

这使得AI智能体不仅能“谈论”加密货币，更能真正“拥有”和“操作”加密资产，实现真正的自主经济行为。

3.3 面向自动化工作流：GitHub Action与Farcaster机器人

GitHub Action：CI/CD式代币部署对于项目方，可以将代币部署集成到GitHub的持续集成/持续部署流程中。

# .github/workflows/deploy-token.yml name: Deploy Token on PumpClaw on: release: types: [published] # 当发布新版本时触发 jobs: deploy: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - name: Deploy Community Token uses: clawd800/pumpclaw-action@v1 with: private-key: ${{ secrets.PUMPCLAW_DEPLOYER_KEY }} name: '${{ github.event.repository.name }} Token' symbol: '${{ vars.TOKEN_SYMBOL }}' # 可在仓库变量中设置 fdv: 5

这种方式非常适合开源软件项目，将代币发布与代码版本发布绑定，实现社区激励的自动化。

Farcaster机器人：社交化一键发行这是对普通用户最友好的方式。在Farcaster（一个去中心化社交网络）上，你只需要@机器人并发送一条消息。

@clawd deploy $COOL Cool AI Project

机器人会解析指令，自动完成部署，并将代币地址和交易链接回复给你。这背后是PumpClaw的智能合约在运行，机器人只是一个交互界面。要使用此功能，你的Farcaster账户必须绑定了一个经过验证的以太坊地址。

4. 智能合约交互与开发集成

对于想要将PumpClaw深度集成到自己DApp或智能合约中的开发者，直接与合约交互提供了最大的灵活性。

4.1 核心合约接口详解

所有功能都汇聚于PumpClawFactory合约的createToken函数。理解其参数至关重要。

function createToken( string memory name, // 代币全名，如 "My AI Agent" string memory symbol, // 代币符号，如 “MAI”，通常3-5个大写字母 string memory imageUrl, // 代币图标URL，建议使用永久链接（如IPFS） string memory websiteUrl, // 项目官网或介绍页面URL，用于证明来源 uint256 totalSupply, // 代币总供应量（需乘以10^18，因为默认精度为18） uint256 initialFdv, // 初始完全稀释估值，单位是wei (1 ETH = 10^18 wei) address creator // 手续费接收地址，必须是有效的以太坊地址 ) external returns (address token, uint256 positionId);

参数选择策略：

• totalSupply：常见的Memecoin或社区代币供应量在10亿（1,000,000,000）到1万亿（1,000,000,000,000）之间。较小的供应量（如100万）会导致单个代币价格数字很大，但流动性深度管理需要更精细。建议：对于广泛分发的社区代币，10亿是一个心理上易于理解和计算的起点。
• initialFdv：这是代币上市时的初始总市值。例如，initialFdv = 2e18表示2 ETH。它决定了初始流动性池中代币与ETH的兑换比率：初始单价 = initialFdv / totalSupply。设置过低可能引发瞬时抢购和价格剧烈波动，设置过高则可能导致初始流动性缺乏吸引力。建议：对于测试或小型社区，0.5-5 ETH是合理范围；对于有前期社区积累的项目，可以设定更高。

4.2 使用Ethers.js或Viem进行集成

以下是一个使用Viem库在Node.js环境中直接调用合约的示例。

import { createPublicClient, createWalletClient, http, parseEther } from 'viem'; import { base } from 'viem/chains'; import { privateKeyToAccount } from 'viem/accounts'; import { pumpClawFactoryAbi } from './abi'; // 需要从项目源码获取ABI // 1. 配置客户端 const publicClient = createPublicClient({ chain: base, transport: http('你的Base RPC URL'), }); const account = privateKeyToAccount('你的私钥'); const walletClient = createWalletClient({ account, chain: base, transport: http('你的Base RPC URL'), }); // 2. 准备合约实例和调用参数 const factoryAddress = '0xe5bCa0eDe9208f7Ee7FCAFa0415Ca3DC03e16a90'; const totalSupply = parseEther('1000000000'); // 10亿，精度已处理 const initialFdv = parseEther('2'); // 2 ETH // 3. 发送创建交易 const hash = await walletClient.writeContract({ address: factoryAddress, abi: pumpClawFactoryAbi, functionName: 'createToken', args: [ 'Autonomous Revenue Token', 'ART', 'https://ipfs.io/ipfs/Qm.../token.png', 'https://my-ai-agent.com', totalSupply, initialFdv, account.address, // 创作者地址设为发送者 ], }); // 4. 等待交易确认并获取代币地址 const receipt = await publicClient.waitForTransactionReceipt({ hash }); // 从交易日志中解析出代币创建事件，获取代币地址 // PumpClawFactory合约会发出TokenCreated(address token, ...)事件

注意事项：直接从链上事件日志中解析代币地址需要熟悉ABI和事件解码。一个更简单的方法是使用PumpClaw提供的shared模块中的工具函数，它已经封装了这些逻辑。

4.3 使用Shared模块简化开发

PumpClaw项目中的/shared目录包含了所有客户端共用的TypeScript工具函数，是集成开发的最佳起点。

import { createClient, buildCreateTokenArgs, CONTRACTS } from '@pumpclaw/shared'; // 假设打包成了npm包 import { parseEther } from 'viem'; async function launchToken() { // 初始化客户端 const client = await createClient({ chainId: 8453, // Base主网Chain ID rpcUrl: process.env.RPC_URL, privateKey: process.env.PRIVATE_KEY, }); // 构建交易参数（使用默认值或自定义） const args = buildCreateTokenArgs({ name: 'Custom Supply Token', symbol: 'CST', totalSupply: parseEther('21000000'), // 2100万，类似比特币 initialFdv: parseEther('100'), // 初始FDV设为100 ETH creator: client.account.address, imageUrl: 'https://example.com/icon.png', websiteUrl: 'https://myproject.com', }); // 发送交易 const { tokenAddress, transactionHash } = await client.createToken(args); console.log(`Token deployed at: ${tokenAddress}`); console.log(`Tx hash: ${transactionHash}`); // 查询代币信息 const tokenInfo = await client.getTokenInfo(tokenAddress); console.log(`Token Name: ${tokenInfo.name}`); console.log(`Creator Fees Accrued: ${tokenInfo.pendingFees} ETH`); }

使用Shared模块的好处是，它处理了底层的合约ABI、地址、默认参数和事件解析，让你可以专注于业务逻辑。

5. 常见问题、故障排查与安全实践

在实际操作中，你可能会遇到各种问题。以下是一些常见场景及其解决方案。

5.1 交易失败与Gas相关错误

问题：交易一直失败，提示“out of gas”或“reverted”。

• 原因1：Gas Limit设置过低。Uniswap V4的交互，尤其是创建池子，比简单转账更复杂，需要更多Gas。
• 解决方案：在发送交易时，不要使用钱包或客户端估算的默认Gas Limit，手动将其提高。对于createToken交易，建议将Gas Limit设置为500,000左右。使用Viem或Ethers.js时，可以在交易参数中指定gas。

  const hash = await walletClient.writeContract({ // ... 其他参数 gas: 500000n, // 设置Gas Limit });

• 原因2：Base网络拥堵或RPC节点不稳定。
• 解决方案：检查 https://basescan.org/gastracker 查看当前网络Gas价格。如果普遍很高，可以稍后再试。同时，确保你使用的RPC节点是稳定可靠的，可以尝试切换到另一个提供商（如从公共RPC切换到Alchemy或Infura的专用节点）。

问题：交易成功但代币没有出现在PumpClaw网站上。

• 原因：PumpClaw网站和API依赖一个链下索引器来扫描区块链事件并建立数据库。索引器处理新区块需要时间（通常有几秒到几分钟的延迟）。
• 解决方案：这是正常现象。首先，在Basescan上使用你的钱包地址或交易哈希确认交易确实成功，并且TokenCreated事件已发出。然后，等待1-2分钟再刷新网站。你也可以直接通过代币合约地址在Uniswap V4界面（如Matcha.xyz）上查看和交易，这完全不依赖PumpClaw索引器。

5.2 代币经济模型与手续费疑问

问题：我设定的80%手续费，具体是如何计算和分配的？

• 详解：在Uniswap V4池子中，PumpClaw设置了1%的全局交易手续费。这意味着每一笔买卖交易，都会扣除交易额的1%作为手续费。
• 分配流程：
  1. 这1%的手续费会累积在流动性池中。
  2. PumpClaw的合约逻辑会定期（或由任何人触发）将累积的手续费进行结算。
  3. 结算时，手续费的80%会转换为ETH（或相应的交易对资产）并发送到creator地址（即创建代币时指定的地址）。
  4. 剩余的20%会保留在协议相关的地址，用于潜在的协议开发和维护。
• 关键点：手续费是以流动性池中的资产形式存在的。当创作者调用claim函数时，合约会计算其应得的份额，并将其从池子中取出转给创作者。因此，手续费的价值会随着池中资产价格波动而波动。

问题：初始FDV（完全稀释估值）和初始流动性是什么关系？

• 详解：initialFdv参数定义了代币上市时的理论总市值。合约利用这个值和totalSupply来推算初始价格：initialPrice = initialFdv / totalSupply。
• 流动性注入：合约并不会真的注入initialFdv等值的ETH。相反，它通过一个公式，铸造一定数量的代币和对应的虚拟ETH，形成一个初始价格点。当第一个买家使用ETH购买代币时，他注入的ETH会进入池子，并按照当时的恒定乘积公式 (x * y = k) 换取代币。这个过程会从初始价格点开始，形成真实的流动性曲线。
• 简单理解：initialFdv设定了代币的起始挂牌价，而真实的流动性深度是由市场最初的买卖行为共同塑造的。

5.3 安全最佳实践

1. 私钥管理是生命线：用于部署代币和领取手续费的私钥必须绝对安全。绝不使用在线网站生成或存储私钥。对于有实际价值的代理，强烈建议使用硬件钱包或多签钱包（如Safe）来管理创作者地址。CLI和脚本中的私钥应通过环境变量传入，并确保.env文件在.gitignore中。

2. 验证合约与交易：在部署代币或进行大额交易前，务必在BaseScan上验证你正在交互的PumpClawFactory合约地址是否正确（0xe5bCa0eDe9208f7Ee7FCAFa0415Ca3DC03e16a90）。交易发送后，仔细在BaseScan上审查交易详情和触发的事件，确认函数调用和参数符合预期。

3. 理解“永久锁仓”：PumpClaw的LP锁定是真正的永久性。这意味着作为创作者，你也永远无法取出初始流动性。这是为了向社区证明你的诚意。在设计代币经济时，请确保你不需要动用这部分流动性。你的收入应 solely 来自于那80%的交易手续费。

4. 代币图标与信息的持久化：创建代币时填写的imageUrl和websiteUrl会上链。请使用IPFS、Arweave等去中心化存储服务来托管图标，确保链接永久可访问。如果使用中心化服务器链接，一旦服务器关闭，你的代币将在钱包和DEX中失去标识。

5. 测试网先行：在Base主网上部署前，强烈建议在Base Sepolia测试网上进行完整流程的测试。你可以使用测试网ETH（从水龙头获取）来熟悉整个流程，包括创建、买卖、查询手续费和领取，确保一切如你所愿，避免因操作失误在主网损失真实资金。PumpClaw合约同样部署在测试网，地址可在其官方文档或GitHub仓库中找到。