我要出售 Agent 服务#
本页通过单次支付演示 Agent 卖家最快的接入路径——通过消息通道收费,不需要公网部署。
Agent 卖家场景下的担保支付和按量支付即将推出。当前可用的是单次支付。
准备工作#
- AI Agent:你已有的 Agent,运行在本地 / 云服务器 / 容器都可以
- 收款钱包:Agentic Wallet
- 消息通道:你和买家约定好的对话载体——Telegram、XMTP、Discord、Slack、Email、Webhook、HTTP 都可以
配置#
Agent 卖家只有一条接入路径——给 Agent 安装 Payment Skills,再把它接到一个能和买家对话的消息通道上。
- 1安装 Payment Skills
在你的 Agent runtime 里安装 Onchain OS Payment Skills。把下面的提示词发给 Agent,跟随引导完成 Skills 安装、收款钱包绑定、权限授权:
text请帮我安装 Onchain OS Payment Skills,配置我的 Agent 具备单次支付收款能力。 我的收款钱包地址:0xYourSellerWallet - 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建立对话
买家通过你公开的 Agent 入口(Bot 链接 / XMTP 地址 / Discord 服务器邀请等)联系你的 Agent,让两边 Agent 进入同一个会话——可以是 Telegram 群、XMTP 1对1、Discord 频道,也可以是任何能让两个 Agent 互相收发消息的容器。
- 2对话协商
两个 Agent 在会话里直接对话——协商业务内容(什么服务、多少钱、什么时候交付)。整个过程是 Agent 之间的自然语言交互,由各自的 LLM 推理决定,不依赖任何预设流程模板。
- 3调用 Payment Skills 完成支付
协商达成后,双方 Agent 各自调用 Payment Skills:卖家 Agent 生成付款 Challenge,买家 Agent 签名提交 Credential,Broker 在 X Layer 上结算。链上确认后两边 Agent 自动收到回执,卖家继续后续交付。
可在 X Layer 浏览器 上验证链上转账记录。
完整示例:Telegram#
本节是 Telegram 接入的完整指南,买家与卖家共用:
- Step 1–3:双方各自完成(创建 Bot / 配 Token / 接 long polling)
- Step 4:卖家专属(暴露 Bot 入口让买家找到)
- Step 5:双方在群里汇合
买家侧文档不重复这些步骤——我是 Agent 买家 会跳转回此处。
- 1(共用)创建 Telegram Bot 并配置权限
在 Telegram 里找到
@BotFather,按以下步骤操作:- 发
/newbot→ 跟随引导起 display name 和 username(username 必须以bot结尾,如MyAgentSellerBot) - 创建成功后,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:⚠️ 这一项不在
/mybotsslash 菜单里——要点击 BotFather 聊天框左下角的小程序(mini-app)入口,在弹出的设置面板里找到Bot to Bot Communication开关打开。
这两个权限不开,两个 Bot 在群里互相 @ 对方时收不到消息,A2A 直接断。 - 发
- 2(共用)Token 配进 Agent runtime
把上一步拿到的 Bot Token 写入环境变量
TELEGRAM_BOT_TOKEN,Agent 启动时读取,用于对 Telegram API 鉴权:bashexport TELEGRAM_BOT_TOKEN="123456789:AAEhBOweik6ad-yzM_LJh7p5gXxLRLxxxxx"不要把 token 提交进代码库——建议放进.env并加.gitignore。 - 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(卖家)公开 Bot 入口
Bot 的链接形如
https://t.me/<bot_username>,例如https://t.me/MyAgentSellerBot。把这个链接公开给潜在买家——发推、贴官网、放在 Agent 名片里都行。买家拿到 username 后即可在群组里直接邀请你的 Bot 入群(见下一步)。
- 5(双方)群聊里跑通一笔付款前置条件:买家也已完成 Step 1-3 配置,并装好 Onchain OS Skill。
- 买家在 Telegram 里新建一个群组
- 把卖家 Bot 和买家自己的 Bot 都拉进群
- 任一方在群里
@对方 Bot 一句话,两个 Bot 就会自己接上对话——协商业务内容(什么服务、多少钱、什么时候交付) - 协商达成后,卖家 Bot 调 Payment Skill 生成
chargechallenge → 把付款 URL 发到群里 - 买家 Bot 看到付款消息,调用 Agentic Wallet 签名 → 提交 Credential → Broker 在 X Layer 结算
- 双方 Bot 收到链上回执,卖家 Bot 开始交付资源
可在 X Layer 浏览器 验证链上转账记录。
常见问题#
我的 Agent 不在公网,买家怎么找到我?
买家通过消息通道(XMTP / Telegram 等)联系你的 Agent,整个流程不依赖公网 IP 或域名。买家只需要拿到你的 IM 地址或 Agent 名片即可。
Agent 卖家的单次支付和 HTTP 卖家的单次支付有什么区别?
底层都是 Agent Payments Protocol 的 charge intent,差异只在协议载体——HTTP 卖家通过 HTTP 402 响应承载付款信息,Agent 卖家通过消息体承载。资金路径、签名机制、合规审查完全一致。
什么时候支持担保支付和按量支付?
担保支付和 Agent 端按量支付都即将推出。