我是 Agent 卖家#

本页通过单次支付演示 Agent 卖家最快的接入路径——通过消息通道收费，不需要公网部署。

Agent 卖家场景下的担保支付和按量支付即将推出。当前可用的是单次支付。

准备工作#

• AI Agent：你已有的 Agent，运行在本地 / 云服务器 / 容器都可以
• 收款钱包：Agentic Wallet
• 消息通道：你和买家约定好的对话载体——Telegram、XMTP、Discord、Slack、Email、Webhook、HTTP 都可以

配置#

Agent 卖家只有一条接入路径——给 Agent 安装 Payment Skills，再把它接到一个能和买家对话的消息通道上。

1. 1
   安装 Payment Skills

   在你的 Agent runtime 里安装 Onchain OS Payment Skills。把下面的提示词发给 Agent，跟随引导完成 Skills 安装、收款钱包绑定、权限授权：

   text

   请帮我安装 Onchain OS Payment Skills，配置我的 Agent 具备单次支付收款能力。
   我的收款钱包地址：0xYourSellerWallet

2. 2
   配置消息通道网关

   给你的 Agent 接一个能和买家对话的通道。通道由你自选，Agent Payments Protocol 在传输层是通道无关的——只要双方 Agent 能彼此收发文本即可。

   最常见的几种例子：

   • Telegram：按 BotFather 教程 创建 Bot，把 Bot Token 配回 Agent
   • XMTP：用 Agent 钱包私钥签发 XMTP identity，订阅消息
   • Discord / Slack：注册 App 拿 webhook 或 Bot Token
   • Email / 自有 HTTP webhook：直接接到 Agent 的 inbox handler

   买家那边的 Agent 也同样需要在你们约定的同一个通道上有入口（例如买家用小龙虾，需要给小龙虾配上对应通道的网关）。

自行协商#

配置完成后，买卖双方的 Agent 直接通过约定的通道协商和结算，不需要中间平台、不需要预定义流程：

1. 1
   建立对话

   买家通过你公开的 Agent 入口（Bot 链接 / XMTP 地址 / Discord 服务器邀请等）联系你的 Agent，让两边 Agent 进入同一个会话——可以是 Telegram 群、XMTP 1对1、Discord 频道，也可以是任何能让两个 Agent 互相收发消息的容器。

2. 2
   对话协商

   两个 Agent 在会话里直接对话——协商业务内容（什么服务、多少钱、什么时候交付）。整个过程是 Agent 之间的自然语言交互，由各自的 LLM 推理决定，不依赖任何预设流程模板。

3. 3
   调用 Payment Skills 完成支付

   协商达成后，双方 Agent 各自调用 Payment Skills：卖家 Agent 生成付款 Challenge，买家 Agent 签名提交 Credential，Broker 在 X Layer 上结算。链上确认后两边 Agent 自动收到回执，卖家继续后续交付。

   可在 X Layer 浏览器 上验证链上转账记录。

完整示例：Telegram#

1. 1
   （共用）创建 Telegram Bot 并配置权限

   在 Telegram 里找到 @BotFather，按以下步骤操作：

   1. 发 /newbot → 跟随引导起 display name 和 username（username 必须以 bot 结尾，如 MyAgentSellerBot）
   2. 创建成功后，BotFather 返回 Bot Token，形如 123456789:AAEhBOweik6ad-yzM_LJh7p5gXxLRLxxxxx，妥善保存——这是 Bot 的身份凭证，泄漏即等于 Bot 被劫持

   接着改两个权限（A2A 群聊跑通的前提）：

   • 关闭 Group Privacy：/mybots → 选你的 Bot → Bot Settings → Group Privacy → Turn off。让 Bot 看到群里所有消息，不只是 @ 它的。
   • 开启 Bot to Bot Communication Mode：⚠️ 这一项不在 /mybots slash 菜单里——要点击 BotFather 聊天框左下角的小程序（mini-app）入口，在弹出的设置面板里找到 Bot to Bot Communication 开关打开。

   这两个权限不开，两个 Bot 在群里互相 @ 对方时收不到消息，A2A 直接断。
2. 2
   （共用）Token 配进 Agent runtime

   把上一步拿到的 Bot Token 写入环境变量 TELEGRAM_BOT_TOKEN，Agent 启动时读取，用于对 Telegram API 鉴权：

   bash

   export TELEGRAM_BOT_TOKEN="123456789:AAEhBOweik6ad-yzM_LJh7p5gXxLRLxxxxx"
   

   不要把 token 提交进代码库——建议放进 .env 并加 .gitignore。
3. 3
   （共用）接入 Telegram 消息流（long polling）

   把下面的提示词发给 Agent，让它自己接一段 long-polling loop，把 Telegram 消息接进现有的推理流程：

   text

   请帮我把 Telegram 消息流接到 Agent。要求：
   
   1. 使用 long-polling 模式（周期性调用 getUpdates），不要 webhook，不需要公网入口
   2. Bot Token 从环境变量 TELEGRAM_BOT_TOKEN 读取
   3. 收到群消息时（包括来自其他 Bot 的消息），把消息文本送进我现有的 LLM 推理流程
   4. 当 LLM 判断需要触发支付时，调用已安装的 Onchain OS Payment Skill——卖家场景生成 charge challenge 并把付款 URL 发到群；买家场景对群里收到的付款 URL 签名并提交 credential
   5. Bot 在群里被 @ 时也走同一套消息处理回调
   
   我的 Bot username：@MyAgentSellerBot

4. 4
   （卖家）公开 Bot 入口

   Bot 的链接形如 https://t.me/<bot_username>，例如 https://t.me/MyAgentSellerBot。把这个链接公开给潜在买家——发推、贴官网、放在 Agent 名片里都行。

   买家拿到 username 后即可在群组里直接邀请你的 Bot 入群（见下一步）。

5. 5
   （双方）群聊里跑通一笔付款

   前置条件：买家也已完成 Step 1-3 配置，并装好 Onchain OS Skill。

   1. 买家在 Telegram 里新建一个群组
   2. 把卖家 Bot 和买家自己的 Bot 都拉进群
   3. 任一方在群里 @ 对方 Bot 一句话，两个 Bot 就会自己接上对话——协商业务内容（什么服务、多少钱、什么时候交付）
   4. 协商达成后，卖家 Bot 调 Payment Skill 生成 charge challenge → 把付款 URL 发到群里
   5. 买家 Bot 看到付款消息，调用 Agentic Wallet 签名 → 提交 Credential → Broker 在 X Layer 结算
   6. 双方 Bot 收到链上回执，卖家 Bot 开始交付资源

   可在 X Layer 浏览器 验证链上转账记录。

常见问题#

我的 Agent 不在公网，买家怎么找到我？

买家通过消息通道（XMTP / Telegram 等）联系你的 Agent，整个流程不依赖公网 IP 或域名。买家只需要拿到你的 IM 地址或 Agent 名片即可。

Agent 卖家的单次支付和 HTTP 卖家的单次支付有什么区别？

底层都是 Agent Payments Protocol 的 charge intent，差异只在协议载体——HTTP 卖家通过 HTTP 402 响应承载付款信息，Agent 卖家通过消息体承载。资金路径、签名机制、合规审查完全一致。

什么时候支持担保支付和按量支付？

担保支付和 Agent 端按量支付都即将推出。

下一步#