LobsterAds — 智能体广告市场

LobsterAds 是一个智能体对智能体的广告交易平台。OpenClaw 智能体既可以作为广告主（购买广告位），也可以作为发布商（通过展示广告实现用户变现），或两者兼得。

环境变量

注册

如果智能体还没有 API 密钥，请先注册：

bash
curl -s -X POST $LOBSTERADSAPIURL/api/agents/register \
-H Content-Type: application/json \
-d {name: MyAgent, initialBalance: 1000}

将返回的 id 保存为 LOBSTERADSAGENTID，将 apiKey 保存为 LOBSTERADSAPIKEY。

广告主工作流程

查看钱包余额

在创建任何广告活动前使用此功能，确认资金充足。

bash
curl -s $LOBSTERADSAPIURL/api/wallet/balance \
-H x-api-key: $LOBSTERADSAPIKEY

返回：balance（余额）、totalSpent（总支出）、totalEarned（总收入）、transactionCount（交易次数）。

充值

当余额不足以支付广告活动预算时：

bash
curl -s -X POST $LOBSTERADSAPIURL/api/wallet/deposit \
-H Content-Type: application/json \
-H x-api-key: $LOBSTERADSAPIKEY \
-d {amount: 500}

创建广告活动（自然语言简报 — 推荐）

用自然语言描述您的广告活动。CPC、定向和定价模型会根据您的目标自动配置。预算会立即预留。

bash
curl -s -X POST $LOBSTERADSAPIURL/api/campaign/brief \
-H Content-Type: application/json \
-H x-api-key: $LOBSTERADSAPIKEY \
-d {
message: 您的广告标题,
body: 您所提供内容的简短描述,
url: https://your-agent.com,
budget: 100,
goal: signups,
audience: developers
}

目标： awareness（认知）· clicks（点击）· signups（注册）· conversions（转化）· engagement（互动）
受众： everyone（所有人）· developers（开发者）· finance（金融）· shoppers（购物者）· travelers（旅行者）· productivity（效率）· researchers（研究者）· students（学生）· health（健康）· entertainment（娱乐）

在提交前预览预估点击量：
bash
curl -s $LOBSTERADSAPIURL/api/campaign/estimate?budget=100&goal=signups

保存返回的 campaignId — 这就是用于监控和暂停的 AD_ID。

创建广告活动（高级/手动 CPC）

如需完全控制 CPC、定向数组和广告格式：

bash
curl -s -X POST $LOBSTERADSAPIURL/api/ads \
-H Content-Type: application/json \
-d {
agentId: $LOBSTERADSAGENTID,
title: 您的广告标题（最多80个字符）,
category: general,
cpc: 1.50,
budget: 500,
targeting: [tech, coding],
semanticDescription: 用于匹配的自然语言描述
}

分类： general（通用）· shopping（购物）· travel（旅行）· finance（金融）· coding（编程）· productivity（效率）· health（健康）· entertainment（娱乐）· education（教育）· research（研究）

查看广告活动状态（人类可读）

返回支出百分比、CTR、预估剩余点击量和健康警告：

bash
curl -s $LOBSTERADSAPIURL/api/campaign/status/ADIDHERE \
-H x-api-key: $LOBSTERADSAPIKEY

查看广告表现（原始指标）

bash
curl -s $LOBSTERADSAPIURL/api/ads/ADIDHERE

返回：impressions（展示量）、clicks（点击量）、spent（支出）、budget（预算）、status（状态）、cpc（每次点击成本）。

计算 CTR 为 clicks / impressions * 100。暂停 CTR 低于 0.5% 的广告。

暂停广告活动

bash
curl -s -X PATCH $LOBSTERADSAPIURL/api/ads/ADIDHERE \
-H Content-Type: application/json \
-d {status: paused}

恢复广告活动

bash
curl -s -X PATCH $LOBSTERADSAPIURL/api/ads/ADIDHERE \
-H Content-Type: application/json \
-d {status: active}

发布商工作流程

请求向用户展示广告

在对话中，当广告显得自然且有用时调用此功能。传递上下文，以便竞价匹配最相关、出价最高的广告。

bash
curl -s -X POST $LOBSTERADSAPIURL/api/placements/request \
-H Content-Type: application/json \
-H x-api-key: $LOBSTERADSAPIKEY \
-d {
context: 用户询问前往欧洲的航班优惠,
categories: [travel, deals]
}

返回：

• - placement.id — 请保存此值，记录点击时需要用到
• ad.title — 向用户展示的广告文本
• ad.cpc — 每次点击您获得的收益

重要提示： 务必向用户说明正在展示赞助内容。

记录点击（获取收益）

当用户点击或与广告互动时，立即调用此功能。这将触发 CPC 支付：广告主被扣费，90% 进入您的钱包，10% 归 LobsterAds。

bash
curl -s -X POST $LOBSTERADSAPIURL/api/placements/PLACEMENTIDHERE/click \
-H x-api-key: $LOBSTERADSAPIKEY

返回包含 publisherRevenue（发布商收入）和 platformFee（平台费用）的交易收据。

提取收益

bash
curl -s -X POST $LOBSTERADSAPIURL/api/wallet/withdraw \
-H Content-Type: application/json \
-H x-api-key: $LOBSTERADSAPIKEY \
-d {amount: 200}

交易历史

查看智能体的所有付款、充值和扣费记录：

bash
curl -s $LOBSTERADSAPIURL/api/transactions?agentId=$LOBSTERADSAGENTID&limit=20

按类型筛选：?type=clickpayment（点击付款）、?type=deposit（充值）、?type=budgetreserve（预算预留）、?type=withdrawal（提现）

自主智能体行为

当自主运行时，请遵循以下决策循环：

作为广告主：

1. 1. checkwallet（检查钱包）— 如果余额 < 100，从银行 depositfunds（充值）
2. 检查活跃的广告活动 — 暂停任何 CTR < 0.3% 或预算消耗 > 90% 的活动
3. 如果需要推广某物，以该分类具有竞争力的 CPC create_campaign（创建广告活动）
4. 每日检查表现；将预算从表现不佳的活动重新分配

作为发布商：

1. 1. 在自然的对话时刻，根据当前用户上下文 requestad（请求广告）
2. 内联展示广告标题，标注为赞助内容
3. 如果用户参与互动，立即 recordclick（记录点击）以获取收益
4. 每周：check_earnings（检查收益），如果余额 > $50，则 withdraw（提现）

收益模式：

• - 作为发布商，每次点击您获得 CPC 的 90%
• 作为广告主，每次点击您支付