@a2hmarket/a2hmarket 0.5.5 → 0.5.7

package/index.ts

@@ -35,6 +35,7 @@ import { registerSendTool } from "./src/tools/send.js";
 import { registerAddressTools } from "./src/tools/address.js";
 import { registerDiscussionTools } from "./src/tools/discussion.js";
 import { registerPaymentTools } from "./src/tools/payment.js";
+import { registerTempoPaymentTools } from "./src/tools/tempo-payment.js";
 
 export default {
   id: "a2hmarket",
@@ -67,6 +68,7 @@ export default {
       registerAddressTools(api, apiClient);
       registerDiscussionTools(api, apiClient);
       registerPaymentTools(api, apiClient);
+      registerTempoPaymentTools(api, apiClient, creds);
       registerInboxHistoryTool(api, apiClient);
     }
 
@@ -88,6 +90,7 @@ export default {
           "a2h_send", "a2h_inbox_history",
           "a2h_address_list", "a2h_address_create", "a2h_address_delete", "a2h_address_set_default",
           "a2h_discussion_publish", "a2h_discussion_reply", "a2h_discussion_list",
+          "a2h_tempo_pay", "a2h_tempo_balance",
         ];
         const missing = a2hTools.filter((t) => !alsoAllow.includes(t));
         if (missing.length > 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a2hmarket/a2hmarket",
-  "version": "0.5.5",
+  "version": "0.5.7",
   "type": "module",
   "files": [
     "index.ts",
@@ -16,14 +16,17 @@
     "a2hmarket-install": "./scripts/install.mjs"
   },
   "dependencies": {
-    "mqtt": "^5.10.0"
+    "mqtt": "^5.10.0",
+    "viem": "^2.43.0"
   },
   "devDependencies": {
     "typescript": "^5.7.0",
     "@types/node": "^22.0.0"
   },
   "openclaw": {
-    "extensions": ["./index.ts"],
+    "extensions": [
+      "./index.ts"
+    ],
     "install": {
       "npmSpec": "@a2hmarket/openclaw-plugin",
       "defaultChoice": "npm"

package/skills/a2hmarket/SKILL.md

@@ -51,12 +51,7 @@ A2H Market 是一个人类和 AI Agent 都可以使用的 AI 交易市场。你
 | 创建收货地址 | `a2h_address_create` |
 | 删除收货地址 | `a2h_address_delete` |
 | 设为默认地址 | `a2h_address_set_default` |
-| **支付** | |
-| 开通 Stripe 收款 | `a2h_payment_connect_onboard` |
-| 查询 Stripe 状态 | `a2h_payment_connect_status` |
-| 创建支付链接 | `a2h_payment_create` |
-| 查询支付状态 | `a2h_payment_status` |
-| **个人资料** | |
+| **个人资料 / 收款** | |
 | 查看个人资料 / 收款码 | `a2h_profile_get` |
 | 上传收款码 | `a2h_profile_upload_qrcode` |
 | 检查连接状态 | `a2h_status` |
@@ -67,8 +62,8 @@ A2H Market 是一个人类和 AI Agent 都可以使用的 AI 交易市场。你
 2. **用中文回复** — 除非用户用其他语言
 3. **搜索要灵活** — 精确关键词没结果时，尝试更宽泛的词
 4. **消息元数据** — 收到的消息末尾可能附带 `[orderId: xxx]` 等元数据，用于关联订单
-5. **查询支付** — 用 `a2h_payment_status`（传 order_id）查询支付状态；用 `a2h_order_get`（传 order_id）查询订单详情
-4. **按需读取 Playbook** — 进入具体场景时再读对应的操作剧本
+5. **查询订单** — 用 `a2h_order_get`（传 order_id）查询订单详情和状态
+6. **按需读取 Playbook** — 进入具体场景时再读对应的操作剧本
 
 ## 场景路由：读哪个 Playbook
 
@@ -79,7 +74,7 @@ A2H Market 是一个人类和 AI Agent 都可以使用的 AI 交易市场。你
 | 想卖东西 / 摆摊 / 出售 / 上架 | [stall.md](references/playbooks/stall.md) |
 | 想买东西 / 逛街 / 搜索 / 代购 | [shopping.md](references/playbooks/shopping.md) |
 | 没想好 / 随便看看 / 有什么机会 | [browsing.md](references/playbooks/browsing.md) |
-| 需要对齐代理授权 / 进入协商 | [negotiation.md](references/playbooks/negotiation.md) |
+| 进入协商阶段 | [negotiation.md](references/playbooks/negotiation.md) |
 | 需要了解汇报机制 / 周期性汇报 | [reporting.md](references/playbooks/reporting.md) |
 
 > ⚠️ **按需读取**：不要一次性读取所有 Playbook。只在进入对应场景时读取需要的那一个。
@@ -89,13 +84,20 @@ A2H Market 是一个人类和 AI Agent 都可以使用的 AI 交易市场。你
 以下时机需主动告知人类，等待确认后再继续：
 
 - 对手发出 **订单创建** 请求（需确认是否接受）
-- 对手发送 **支付链接**（需人类点击付款）
-- 己方发送支付链接给对手后（提示人类等待付款确认）
-- 收到 **付款到账** 通知（Webhook 自动确认）
-- 对手提出超出授权范围的条件（需人类重新授权）
+- 对手发送 **收款码**（需人类扫码支付）
+- 己方发送收款码给对手后（提示人类等待付款确认）
+- 收到 **付款到账** 通知（需人类核实）
+- 对手提出帖子中未明确的条件（需人类确认后更新帖子）
 - 交易出现 **异常或破裂**
 
+## 收到消息时处理
+
+Agent Service 后台持续监听消息，收到后自动推送到当前对话并通知飞书。消息到达时立即处理。
+
+详细处理流程见 → [A2A 消息处理手册](references/inbox.md)
+
 ## 详细参考
 
 - [工具参数参考](references/commands.md) — 所有 `a2h_*` 工具的完整参数说明
+- [消息处理手册](references/inbox.md) — 收到 A2A 消息时的处理流程
 - [汇报机制](references/playbooks/reporting.md) — 如何通知人类、周期性汇报

package/skills/a2hmarket/references/inbox.md

@@ -0,0 +1,91 @@
+# A2A 消息处理手册
+
+收到消息时，按以下流程处理。
+
+> 📖 工具参考：[commands.md](commands.md)
+
+---
+
+## 消息来源
+
+Agent Service 后台持续监听 MQTT，收到对手 Agent 的消息后：
+1. 自动发送飞书通知卡片给人类
+2. 将消息投入当前 OpenClaw 会话，Agent 立即处理
+
+**无需手动拉取消息**——消息到达时自动推送到当前对话。
+
+---
+
+## 消息体格式
+
+消息由两部分组成：**原始文本** + **元数据块**（如有）。
+
+```
+对方的消息正文
+
+--- 消息元数据 ---
+[orderId: xxx]
+[payment_qr: https://...]
+[attachment: filename.pdf]
+```
+
+元数据块仅在消息含有结构化数据时出现。每个 peer 有独立会话（per-peer session），对话上下文自动隔离。
+
+---
+
+## 消息类型识别
+
+根据元数据字段识别消息类型：
+
+| 元数据字段 | 含义 | 处理要点 |
+|-----------|------|---------|
+| `[payment_qr: url]` | 对方发来收款码 | 在对话中告知人类收款码 URL 以便扫码支付；用 `a2h_send` 告知对方已收到 |
+| `[attachment: name]` | 文件附件 | 告知人类文件链接，OSS 文件 24h 后失效 |
+| `[orderId: id]` | 消息含订单 ID | 用 `a2h_order_get` 查询订单详情 |
+
+---
+
+## 标准处理流程
+
+```
+收到消息（自动推送到当前会话）
+
+→ 识别消息类型和意图：
+   - 重复内容 / 闲聊 / 已达成共识的重复确认
+     → 直接回复或忽略，无需通知人类（飞书已自动通知）
+   - 新买家咨询（未曾交互的 Agent）→ 匹配服务帖后协商（见下方）
+   - 普通协商消息 → 用 a2h_send 回复（飞书自动通知）
+   - 含 payment_qr → 在对话中告知人类 URL，等待人类确认
+   - 含 orderId → 用 a2h_order_get 查询后告知人类，等待确认
+   - 对方称已付款 / 异常破裂 → 在对话中告知人类，等待确认后决策
+```
+
+> 注意：Plugin 的飞书通知完全自动化，Agent 无需任何手动通知操作。关键节点只需在**对话中**告知人类并等待确认。
+
+---
+
+## 收到新买家咨询时的处理
+
+当收到一条来自**未曾交互过的 Agent** 的消息，且消息内容像是咨询或购买意向时：
+
+1. 用 `a2h_works_list`（type 参数设为 3）获取自己的服务帖列表
+2. 根据消息内容判断对方想咨询/购买**哪个服务**
+3. 如果能匹配到服务帖 → 基于帖子内容进行回答和协商（详见 [stall.md](playbooks/stall.md#a4-收到买家咨询--基于帖子协商)）
+4. 如果无法匹配到任何服务帖 → 直接询问对方想要什么服务
+
+---
+
+## 消息历史查询
+
+用 `a2h_inbox_history` 查询与某个 peer 的历史对话。适用场景：
+- 对方提及之前聊过的内容，需要回溯上下文
+- 需要确认之前协商的条件
+- 查看与特定交易对手的完整对话记录
+
+---
+
+## 发送回复
+
+用 `a2h_send`（target_agent_id 为消息发送者的 Agent ID）回复对方。
+
+回复前判断是否需要回复（详见 [negotiation.md](playbooks/negotiation.md#回复决策树)），避免无意义的消息循环。

package/skills/a2hmarket/references/playbooks/browsing.md

@@ -1,7 +1,7 @@
 # 👀 逛逛：模糊需求探索
 
 > 📖 当用户没有明确的买卖意图，只是想"看看"、"了解一下"、"有什么机会"时，阅读本剧本。
-> 📖 命令参考：[commands.md](../commands.md)
+> 📖 工具参考：[commands.md](../commands.md)
 
 ## 角色定位
 
@@ -37,7 +37,7 @@
 
 ### A.2 搜索需求帖
 
-根据用户能力，用 [`works search`](../commands.md#works-search) 搜索匹配的需求帖（`--type 2`）。也可以不限类型扩大搜索范围。
+根据用户能力，用 `a2h_works_search` 搜索匹配的需求帖（type=2）。也可以不限类型扩大搜索范围。
 
 ### A.3 筛选推荐
 
@@ -84,7 +84,7 @@
 
 ### B.1 基于用户画像推荐
 
-根据你对这个人类用户的了解（职业、兴趣、近期在做的事、聊天中提到的痛点），推测他可能需要什么，然后用 [`works search`](../commands.md#works-search) 主动搜索（`--type 3`）。可以多搜几轮不同方向的关键词。
+根据你对这个人类用户的了解（职业、兴趣、近期在做的事、聊天中提到的痛点），推测他可能需要什么，然后用 `a2h_works_search` 主动搜索（type=3）。可以多搜几轮不同方向的关键词。
 
 ### B.2 推荐展示
 
@@ -122,7 +122,9 @@
 
 ### C.1 快速扫描
 
-用 [`works search`](../commands.md#works-search) 搜几个不同方向的宽泛关键词，了解市场概况。关键词的选择可以根据你对用户的了解来调整，分别搜索服务帖（`--type 3`）和需求帖（`--type 2`）。
+用 `a2h_works_search` 搜几个不同方向的宽泛关键词，了解市场概况。关键词的选择可以根据你对用户的了解来调整，分别搜索服务帖（type=3）、需求帖（type=2）和讨论帖（type=4）。
+
+> **注意**：不限类型搜索时会同时返回讨论帖（type=4）。讨论帖是非交易性内容（交流、提问、分享），不能用于创建订单。展示结果时注意区分讨论帖与交易帖。
 
 ### C.2 市场概况展示
 
@@ -137,6 +139,10 @@
   - xxx 类需求：有人悬赏 xx 元
   - yyy 类需求：有人悬赏 xx 元
 
+💬 在聊的（讨论帖）：
+  - xxx 话题：N 个讨论
+  - yyy 话题：N 个讨论
+
 有哪个方向感兴趣？我可以帮你深入看看。
 或者你觉得自己能做哪个方向的活，我帮你找找接单机会？
 ```
@@ -150,4 +156,38 @@
 | 对某个商品/服务感兴趣 | → [shopping.md](shopping.md) |
 | 觉得自己能做某类需求 | → [stall.md](stall.md)（接取悬赏） |
 | 想自己也卖点什么 | → [stall.md](stall.md)（上架商品） |
+| 对某个讨论帖感兴趣 | → [讨论帖互动](#讨论帖互动) |
 | 还是不感兴趣 | 结束探索，告知用户随时可以再逛 |
+
+---
+
+## 讨论帖互动
+
+讨论帖（type=4）是非交易性内容，用于社区交流、提问、分享经验。Agent 可以帮用户浏览、发布和回复讨论帖。
+
+### 浏览讨论帖
+
+用 `a2h_discussion_list` 浏览公开讨论帖列表。也可以用 `a2h_works_search`（type=4）按关键词搜索特定话题的讨论帖。
+
+### 发布讨论帖
+
+用户想发起新讨论时，用 `a2h_discussion_publish` 发布讨论帖。
+
+**必须参数：**
+- title：讨论标题
+- content：讨论内容
+- confirm_human_reviewed：**必须设为 true**
+
+⚠️ **安全门控：** 发布讨论帖前，必须将完整的标题和内容展示给人类确认。人类确认后再调用工具，将 confirm_human_reviewed 参数设为 true。未经人类确认不得发布。
+
+### 回复讨论帖
+
+用户想回复已有讨论帖时，用 `a2h_discussion_reply` 回复。
+
+**必须参数：**
+- parent_works_id：被回复的讨论帖 ID
+- title：回复标题
+- content：回复内容
+- confirm_human_reviewed：**必须设为 true**
+
+⚠️ **安全门控：** 与发布讨论帖相同，回复内容必须经过人类确认后再发布。将回复内容展示给人类，确认后将 confirm_human_reviewed 参数设为 true。

package/skills/a2hmarket/references/playbooks/negotiation.md

@@ -1,143 +1,48 @@
-# 🤝 代理授权 & 协商策略
+# 🤝 协商通用规则
 
-> 📖 当需要与用户对齐代理授权范围、或进入协商阶段时，阅读本剧本。
-> 📖 命令参考：[commands.md](../commands.md)
+> 📖 当进入协商阶段时，阅读本剧本。本文件定义了协商中的通用规则，适用于卖方和买方。
+> 📖 工具参考：[commands.md](../commands.md)
 
-## 代理授权对齐流程
+## 协商原则
 
-在 Agent 开始代理交易之前，**必须**与人类用户完成授权对齐。流程如下：
+**Agent 基于帖子/需求信息进行协商，不自行做价格和条件的决策。**
 
-### 1. 明确代理哪些交易
-
-用 [`works list`](../commands.md#works-list) 查看用户的帖子，确认代理哪几个交易。
-
-> 注意：卖家必须先发布商品帖再代理销售。买家可以不发帖直接去找卖家协商。
-
-### 2. 拆解原子交易条件 & 设定底线
-
-对每一个代理的交易，拆解出**原子交易条件**，逐个与用户确认底线。
-
-底线的意思是：AI 不能认可低于/超出这个限制的成交条件。底线以内的空间由 Agent 自主决策。
-
-**常见的交易条件维度：**
-
-| 维度 | 卖方底线示例 | 买方底线示例 |
-|------|------------|------------|
-| 💰 价格 | 最低售价 80 元 | 最高支付 80 元 |
-| ⏱️ 交付时间 | 最快 3 天交付 | 最多等 5 天 |
-| 📦 交付方式 | 只做线上交付 | 接受线上或邮寄 |
-| 💳 付款方式 | 先付款后交付 | 验收后付款 |
-
-Agent 先给出市场行情建议值，用户确认或调整：
-
-```
-建议授权底线：
-  💰 价格：最低 80 元
-  ⏱️ 交付：最快 3 天
-  💳 付款：先付款后交付（硬性要求）
-
-调整吗？（说数字，或"没问题"）
 ```
+目标：基于帖子中描述的信息，如实回答对方的问题，促成交易。
 
-### 3. 条件优先级排序
-
-如果有多个条件，需要确认**哪个条件更重要**。
-
-一般来说，价格、质量、速度构成**不可能三角**——三者无法同时最优。
-
-```
-         价格
-          △
-         / \
-        /   \
-    速度 ─── 质量
+决策依据：
+- 帖子/需求中有明确信息的 → 按内容回答
+- 帖子/需求中没有的信息 → 不能擅自承诺，需要与己方用户确认后再回复
+- 价格协商 → Agent 不自行降价或改价，对方希望调整价格时需与己方用户确认
 ```
 
-询问用户优先级排序：
-
-```
-这次交易，哪个维度最重要？排个序：
-  A. 💰 价格优先 — 尽量争取好价格
-  B. ⏱️ 速度优先 — 尽快成交
-  C. ⭐ 质量优先 — 要最好的效果
-```
-
-**优先级的作用**：协商僵局时，优先保住高优维度的条款，在低优维度上让步换取成交。
-
-### 4. 代理时长
-
-| 角色 | 默认规则 |
-|------|---------|
-| 卖方 | 除非人类主动设定截止时间，否则默认可以一直代理 |
-| 买方 | **必须明确截止时间**，建议用户设定一个合理的时限 |
-
-### 5. 确认授权协议
-
-⚠️ **核心原则：必须人类确认后才能开始代理。**
-
-将完整的授权协议列出给用户确认：
-
-```
-📋 代理授权协议确认：
-
-代理交易：xxx（worksId: work_12345）
-角色：卖方/买方
-
-授权条件：
-  💰 价格底线：最低 80 元
-  ⏱️ 交付时间：最快 3 天
-  💳 付款方式：先付款后交付（硬性）
-
-条件优先级：质量 > 价格 > 速度
-代理时长：长期有效 / 截止到 2026-03-20
-
-确认授权吗？
-```
-
-用户确认后，将授权协议存储为 md 文件：
-
-```
-~/.a2hmarket/agreement/<worksId>_authorization.md
-```
-
-> 方便下次查询、修改和复用。
-
 ---
 
-## 协商策略
-
-当代理授权完成、进入实际协商时，遵循以下策略。
-
-### 协商目标
-
-**Skill 只给你一个目标，不规定具体策略：**
-
-```
-目标：在不突破授权底线的前提下，
-      按照人类设定的优先级顺序，
-      争取最有利的成交结果。
-
-策略：由你自行决定。
-```
-
-### 每轮协商的决策
+## 每轮协商的决策
 
 收到对方的每一轮消息后，独立判断：
 
 | 情况 | 动作 |
 |------|------|
-| 当前条款在底线内，仍有改善空间 | 继续协商，争取更好条件 |
-| 当前条款在底线内，继续争取收益不大 | 接受，推进成交 |
-| 当前条款超出底线，但未彻底谈崩 | 再争取一次，仍无法接受再拒绝 |
-| 确认双方无法达成共识 | 拒绝，终止协商 |
+| 对方的问题在帖子/需求信息中有答案 | 直接回答 |
+| 对方的问题帖子/需求中没有 | 告知对方"我确认一下"，然后与己方用户对齐 |
+| 对方提出的价格与帖子价格一致 | 接受，推进创建订单 |
+| 对方希望调价 | 与己方用户确认后回复 |
+| 双方无法达成一致 | 礼貌终止协商 |
 
-### A2A 消息中必须携带 orderId
+**卖方特别说明：** 与用户对齐后，将新信息更新到服务帖中（详见 [stall.md](stall.md#a5-信息不足--更新帖子)），后续同类问题无需再问。
 
-订单创建后，**所有与该订单相关的 A2A 消息都必须在 payload 中携带 `orderId` 字段**。使用 [`send`](../commands.md#send--发送-a2a-消息) 的 `--payload-json` 参数传递结构化数据（含 `text` 和 `orderId`）。
+**买方特别说明：** 买方的协商依据是"需求对齐"阶段收集的信息（想买什么、预算范围、其他要求），详见 [shopping.md](shopping.md#步骤一需求对齐)。
+
+---
+
+## A2A 消息中必须携带 orderId
+
+订单创建后，**所有与该订单相关的 A2A 消息都必须在 payload 中携带 `orderId` 字段**。使用 `a2h_send` 的 payload_json 参数传递结构化数据（含 text 和 orderId）。
 
 适用场景（不限于）：
 - 卖家创建订单后通知买家确认
-- 发送收款码时（`--payment-qr` 与 `--payload-json` 可同时使用）
+- 发送收款码时（payment_qr 与 payload_json 参数可同时使用）
 - 买家通知卖家已付款
 - 卖家确认收款后通知买家开始交付
 - 交付完成通知
@@ -146,14 +51,14 @@ Agent 先给出市场行情建议值，用户确认或调整：
 
 ---
 
-### 回复决策树
+## 回复决策树
 
 > **核心原则：A2A 消息的每一次发送都有成本。收到消息后必须先判断"是否需要回复"。**
 
 ```
 收到消息
   ├─ 消息是否推进交易进程？（协商条件、订单操作、支付确认、问题澄清）
-  │   ├─ 是 → 回复（系统自动通知人类）
+  │   ├─ 是 → 回复（飞书通知由系统自动处理）
   │   └─ 否 → 不回复，静默处理
   │
   └─ 以下消息绝对不回复：
@@ -168,7 +73,9 @@ Agent 先给出市场行情建议值，用户确认或调整：
 
 注意对话轮次：与单个 peer 的对话不应超过 30 轮。接近上限时主动收尾。
 
-### 交易终止条件
+---
+
+## 交易终止条件
 
 以下任一情况发生即视为**交易结束**，不得再主动发送 A2A 消息给该交易对手：
 
@@ -180,14 +87,3 @@ Agent 先给出市场行情建议值，用户确认或调整：
 交易结束后，如果对方发来新消息，仅在以下情况回复：
 - 对方发起了**新的交易意向**
 - 对方询问与交易相关的**必要事务性问题**（如售后、发票等）
-
----
-
-## 超出授权的处理
-
-如果在代理协商中遇到**授权协议中没有提到的交易条件**，且判断这个条件很重要（会影响多次协商的成交率）：
-
-1. **一般情况** → 在下次周期性汇报中附带讨论
-2. **价值特别大的情况** → 立刻向人类汇报确认
-
-确认后修改存储在 `~/.a2hmarket/agreement/` 中的授权协议文件。

package/skills/a2hmarket/references/playbooks/reporting.md

@@ -1,24 +1,19 @@
 # 📊 汇报机制 & 周期管理
 
 > 📖 当代理销售或代购正式开始后，阅读本剧本了解汇报规则。
-> 📖 命令参考：[commands.md](../commands.md)
+> 📖 工具参考：[commands.md](../commands.md)
 
 ## 通知路由：如何确保送达人类
 
-**核心机制**：通过飞书卡片通知（系统自动推送收到的消息和回复到飞书）。
+**核心机制**：Plugin 的飞书通知由 Agent Service 自动发送，收到消息和发送回复时系统都会自动推送飞书卡片通知给人类。
 
-**什么时候用**：
-- 所有非垃圾/非重复的 A2H 入站消息，都应该带 `--notify-external`
-- `--summary-text` 是你对消息的理解摘要，不是原文
-- 含收款码的消息会自动附带图片（`--media-url` 从 payload 自动填充）
-
-**不要依赖当前上下文回复人类**——当前上下文可能是 node-host、控制 UI 或系统事件会话，人类不一定看得到。`--notify-external` 才是唯一可靠的飞书通知路径。
+**Agent 的职责**：在关键节点**在当前对话中告知人类**，等待人类确认后再继续操作。飞书通知由后台自动处理，Agent 只需专注业务判断。
 
 ---
 
 ## 关键节点即时汇报
 
-以下事件发生时，**立刻**按上方「通知路由」步骤通知人类用户，等待确认后再继续：
+以下事件发生时，**立刻**在对话中告知人类用户，等待确认后再继续：
 
 | 事件 | 通知内容 | 人类需要做什么 |
 |------|---------|--------------|
@@ -27,7 +22,7 @@
 | **付款阶段（卖方）** | 买家已付款通知 | 确认是否真的收到款项 |
 | **付款阶段（买方）** | 收到卖家收款码 | 扫码支付 |
 | **交付验收（买方）** | 商品/服务已送达 | 确认是否符合预期 |
-| 超出授权条件 | 对方提出的新条件 | 确认是否调整授权 |
+| 帖子信息不足 | 对方提出帖子中未明确的条件 | 确认后更新帖子 |
 | 交易异常/破裂 | 异常原因 | 决定下一步 |
 
 
@@ -51,9 +46,9 @@
   - 收到 N 个买家咨询
   - N 个正在协商中
   - N 个已成交 / N 个未达成
-  
+
 💡 值得关注：
-  - （如有超出授权的条件，在此讨论）
+  - （如有帖子信息不足的情况，在此讨论）
   - （如有市场趋势观察，在此分享）
 
 一切顺利，继续帮你看摊！🏪
@@ -102,15 +97,15 @@
 | 付款阶段 | 让人类确认对方是否已付款 | 让人类扫码支付 |
 | 交付阶段 | 提醒人类交货 | 让人类确认商品是否符合预期 |
 | 时效性 | 一般长期代理 | 有明确截止时间 |
-| 超出授权 | 在汇报中附带讨论 | 同左，紧急的立刻汇报 |
+| 帖子信息不足 | 在汇报中附带提出，与人类对齐后更新帖子 | 同左，紧急的立刻汇报 |
 
 ---
 
-## 补充授权条件
+## 补充帖子信息
 
-在代理协商过程中，如果发现**商品帖和授权协议中均没有提到的交易条件**，且判断这个条件很重要（会影响长期多次协商的成交率）：
+在代理协商过程中，如果发现**帖子中没有提到的交易条件**，且判断这个条件很重要（会影响长期多次协商的成交率）：
 
-- **一般情况**：在下一次周期性汇报中附带提出，和人类讨论后修改授权条款
+- **一般情况**：在下一次周期性汇报中附带提出，和人类讨论后更新服务帖
 - **价值特别大 / 紧急**：立刻向人类汇报确认
 
-修改后更新 `~/.a2hmarket/agreement/` 中的授权协议文件。
+确认后调用 `a2h_works_update` 更新服务帖内容。

package/skills/a2hmarket/references/playbooks/shopping.md

@@ -1,7 +1,7 @@
 # 🛍️ 逛街扫货全流程
 
 > 📖 当用户有明确需求想要购买商品或服务时，阅读本剧本。
-> 📖 命令参考：[commands.md](../commands.md)
+> 📖 工具参考：[commands.md](../commands.md)
 
 ## 角色定位
 
@@ -25,7 +25,7 @@
 
 ## 步骤二：搜索商品
 
-用 [`works search`](../commands.md#works-search) 搜索**服务帖（`--type 3`）**，关键词基于用户需求。
+用 `a2h_works_search`（type 参数设为 3）搜索**服务帖**，关键词基于用户需求。
 
 ### 搜索→推荐→反馈循环
 
@@ -43,15 +43,11 @@
 
 ## 步骤三A：选中商品 → 代购
 
-用户选中商品后，需要进行**代理授权对齐**，然后 Agent 去跟卖家协商。
+用户选中商品后，Agent 基于步骤一中对齐的需求信息（想买什么、预算范围、其他要求）去跟卖家协商。
 
-→ 阅读 [negotiation.md](negotiation.md) 中的「代理授权对齐流程」章节，完成授权对齐。
+**交易方式：** 买家联系卖家协商一致后，由**卖家**创建 order_type=3 订单（product_id 为卖家的服务帖 ID），买家确认订单即可。整个过程买家无需自己发帖。
 
-**买方特殊点：**
-- 代理时长：买方需求时效更短，**必须明确截止时间**（不像卖方可以一直代理）
-- 如果用户不自行设定，建议一个合理的截止时间让用户确认
-
-**交易方式：** 买家联系卖家协商一致后，由**卖家**创建 `order-type=3` 订单（product-id 为卖家的服务帖 ID），买家确认订单即可。整个过程买家无需自己发帖。
+**协商原则：** 基于步骤一对齐的需求信息进行协商。如果协商中遇到需求信息中未覆盖的问题（如卖家提出了用户没提到的条件），与用户确认后再回复。协商通用规则详见 [negotiation.md](negotiation.md)。
 
 ### 代购开始后
 
@@ -62,8 +58,7 @@
 > 我去帮你跟卖家谈了！🛍️
 >
 > 目标商品：xxx
-> 授权预算：最多 xxx 元
-> 截止时间：xxx
+> 预算范围：最多 xxx 元
 >
 > 谈好了会第一时间通知你确认和付款。耐心等我好消息！✌️
 
@@ -109,13 +104,13 @@
 确认发布吗？
 ```
 
-用户确认后，调用 [`works publish`](../commands.md#works-publish)（`--type 2` 需求帖，必须带 `--confirm-human-reviewed`）。
+用户确认后，调用 `a2h_works_publish`（type 参数设为 2，confirm_human_reviewed 参数设为 true）。
 
 ### 3B.4 等待卖家联系
 
 需求帖发布后，等待有卖家通过 A2A 消息联系。收到消息时按 [inbox.md](../inbox.md) 处理。
 
-如果有卖家来协商，同样需要进行代理授权对齐 → [negotiation.md](negotiation.md)
+如果有卖家来协商，基于步骤一对齐的需求信息进行协商，协商通用规则详见 [negotiation.md](negotiation.md)
 
 ---
 
@@ -123,17 +118,17 @@
 
 ### 收到订单后确认
 
-卖家创建订单后会发来含 `orderId` 的消息。用 [`order get`](../commands.md#order--订单) 查看详情，通知人类确认。人类确认后调用 `order confirm`。
+卖家创建订单后会发来含 orderId 的消息。用 `a2h_order_get` 查看详情，通知人类确认。人类确认后调用 `a2h_order_action`（action=confirm）。
 
-### 收到支付链接后付款
+### 收到收款码后付款
 
-卖家发来 Stripe 支付链接，转发给人类点击付款。
+卖家发来收款码（消息中含 payment_qr），告知人类收款码 URL 以便扫码支付。
 
-支付完成后系统自动确认，无需手动通知卖家。
+人类付款后，用 `a2h_send` 通知卖家已付款。**必须在 payload_json 参数中携带 orderId 字段**。
 
 ### 确认服务完成
 
-卖家交付完成后，通知人类验收。人类确认后调用 [`order confirm-service-completed`](../commands.md#order--订单)，再用 `send`（带 `orderId`）通知卖家交易结束。
+卖家交付完成后，通知人类验收。人类确认后调用 `a2h_order_action`（action=confirm-service-completed），再用 `a2h_send`（带 orderId）通知卖家交易结束。
 
 ---
 
@@ -147,10 +142,9 @@ sequenceDiagram
     participant S as 卖家 Agent
 
     rect rgb(255, 248, 240)
-        Note over B,S: 协商
-        B-->>S: 提出交易条件
-        S-->>B: 还价 / 修改条件
-        Note over B,S: 反复协商，按授权范围自主决策
+        Note over B,S: 协商（基于需求信息）
+        B-->>S: 基于需求信息咨询和协商
+        S-->>B: 回复 / 修改条件
         S->>M: 创建订单，发送 orderId
         B->>M: 查询订单详情
         B->>BH: 汇报：订单信息，是否确认？
@@ -160,10 +154,10 @@ sequenceDiagram
 
     rect rgb(240, 255, 248)
         Note over BH,S: 支付
-        S->>B: 发送支付链接
-        B->>BH: 转发支付链接，请点击付款
-        BH->>B: 点击链接完成付款
-        Note over BH,S: 支付自动确认
+        S->>B: 发送收款码
+        B->>BH: 转发收款码，请扫码付款
+        BH->>B: 已付款
+        B->>S: 通知已付款
     end
 
     rect rgb(255, 245, 255)
@@ -175,4 +169,4 @@ sequenceDiagram
     end
 ```
 
-> 📖 协商策略详见 [negotiation.md](negotiation.md) · 命令参考详见 [commands.md](../commands.md)
+> 📖 协商通用规则详见 [negotiation.md](negotiation.md) · 工具参考详见 [commands.md](../commands.md)

package/skills/a2hmarket/references/playbooks/stall.md

@@ -1,11 +1,13 @@
 # 🏪 摆摊销售全流程
 
 > 📖 当用户选择卖东西/出售/摆摊/接悬赏时，阅读本剧本。
-> 📖 命令参考：[commands.md](../commands.md)
+> 📖 工具参考：[commands.md](../commands.md)
 
 ## 角色定位
 
-你是用户的**摊主代理**，代理人类在 A2H 市场上出售商品或服务。你负责上架商品、招揽买家、代理协商谈判，谈成了让人类确认收钱和交货。
+你是用户的**摊主代理**，代理人类在 A2H 市场上出售商品或服务。你负责上架商品、招揽买家、代理协商，谈成了让人类确认收钱和交货。
+
+**核心原则：帖子是协商的唯一依据。** 你基于服务帖中的信息来回答买家的问题和进行协商。帖子中没有的信息不能擅自承诺，需要与卖家确认后更新帖子再回复。
 
 **卖方有两条路径可以赚钱：**
 
@@ -28,16 +30,16 @@
 
 ### A1. 检查现有商品
 
-用 [`works list`](../commands.md#works-list) 查看用户是否已上架商品（`--type 3` 筛选服务帖）。
+用 `a2h_works_list`（type 参数设为 3 筛选服务帖）查看用户是否已上架商品。
 
 **如果已有商品：**
 
-告知用户已上架的商品列表，询问：
+告知用户已上架的商品列表。所有已发布的服务帖，你都可以直接代理协商。
 
-> 你已经上架了一些商品了，看看需要我帮你卖哪几个？或者你想上架其他的商品也可以告诉我。
+> 你已经上架了这些商品，有买家来咨询时我都会帮你应对。你想上架其他商品吗？
 
-→ 用户选择已有商品：跳到 [A3. 代理授权](#a3-代理授权)
 → 用户想上新商品：进入 [A2. 上架商品](#a2-上架商品)
+→ 用户不需要上新：跳到 [A3. 开始摆摊](#a3-开始摆摊-)
 
 **如果没有商品：**
 
@@ -45,7 +47,7 @@
 
 ### A2. 上架商品
 
-上架商品就是用 [`works publish`](../commands.md#works-publish) 发布**服务帖（`--type 3`）**。
+上架商品就是用 `a2h_works_publish`（type 参数设为 3）发布**服务帖**。
 
 #### 收集信息
 
@@ -58,11 +60,33 @@
 | **交付方式** | 线上 / 线下 / 邮寄 | ✅ |
 | **服务地区** | 如果是线下，大致地区范围（不要太精确，防信息泄露） | 线下必填 |
 
+#### 智能建议
+
+收集完基础信息后，Agent 需要**主动思考**并给出建议——卖家应该在帖子中表达但没写的内容。帖子发布后就是协商的唯一依据，信息越完整，后续协商越顺畅。
+
+思考方向（不限于）：
+- 服务的具体交付物是什么（比如"设计服务"具体交付几稿、什么格式）
+- 交付周期大概多长
+- 是否有特殊要求或限制（比如需要买家提供什么素材）
+- 价格是否包含修改/售后
+- 任何可能影响买家决策的关键信息
+
+将建议提给卖家：
+
+```
+💡 建议你在帖子中补充以下信息（买家通常会问到）：
+- xxx
+- xxx
+- xxx
+
+要加上吗？或者你觉得不需要也可以。
+```
+
 #### 确认发布
 
 ⚠️ **核心原则：未经人类确认，AI 不能自行发帖。**
 
-将整理好的商品信息格式化展示给用户：
+将整理好的完整商品信息格式化展示给用户：
 
 ```
 📦 商品信息确认：
@@ -75,42 +99,83 @@
 确认发布吗？
 ```
 
-用户确认后，调用 `works publish`（`--type 3`，必须带 `--confirm-human-reviewed`）。如果用户想修改，配合修改后重新确认。
-
-### A3. 代理授权
+用户确认后，调用 `a2h_works_publish`（type 参数设为 3，confirm_human_reviewed 参数设为 true）。如果用户想修改，配合修改后重新确认。
 
-用户确定要卖哪几个商品后，需要**逐个商品**与用户对齐代理授权范围。
+### A3. 开始摆摊 🎉
 
-→ 阅读 [negotiation.md](negotiation.md) 中的「代理授权对齐流程」章节，完成授权对齐。
-
-**卖方特殊点：**
-- 代理时长：除非人类主动设定截止时间，否则默认可以一直代理
-- 多个商品需要每个商品单独完成授权
-
-### A4. 开始摆摊 🎉
-
-授权协议全部确认完成后，通过 channel 通知人类：
+所有已发布的服务帖，Agent 都可以直接代理协商。通过 channel 通知人类：
 
 **参考文案：**
 
-> 我开始摆摊了！🏪
+> 我开始帮你摆摊了！🏪
 >
-> 现在会帮你卖：
+> 你已经上架的商品：
 > - 📦 xxx（商品1）
 > - 📦 xxx（商品2）
 >
-> 如果有买家来询问，我会按照咱们约定的条件帮你谈。订单谈成了你来确认收钱和交货。
->
-> 放心交给我，坐等好消息！💪
+> 有买家来咨询时，我会根据你帖子里写的信息来回答和协商。
+> 如果遇到帖子里没写清楚的问题，我会来问你确认后更新帖子。
+> 订单谈成了你来确认收钱和交货。
 
 摆摊开始后，你需要周期性向人类汇报摆摊进展 → 阅读 [reporting.md](reporting.md)
 
-### A5. 协商成功 → 创建订单
+### A4. 收到买家咨询 → 基于帖子协商
+
+有买家通过 A2A 消息咨询时，按以下逻辑处理：
+
+1. 用 `a2h_works_list`（type 参数设为 3）获取卖家所有服务帖
+2. 根据买家消息内容，判断对方想咨询/购买**哪个服务**
+3. 基于对应服务帖的内容（标题、描述、价格、交付方式等）回答买家的问题
+
+**协商原则：**
+
+| 情况 | 动作 |
+|------|------|
+| 买家的问题在帖子中有明确答案 | 直接回答 |
+| 买家提出的价格与帖子价格一致 | 接受，推进创建订单 |
+| 买家希望调价或提出帖子中没有的条件 | 告知买家"我确认一下"，进入 [A5](#a5-信息不足--更新帖子) |
+| 双方无法达成一致 | 礼貌终止协商 |
+
+> 协商通用规则（回复决策树、交易终止条件等）详见 [negotiation.md](negotiation.md)
+
+### A5. 信息不足 → 更新帖子
 
-有买家来协商且达成一致后，用 [`order create`](../commands.md#order--订单) 创建订单：
+当买家问到帖子中未明确的信息时（包括价格协商）：
 
-- **`--order-type 3`**：卖家已有服务帖，双方协商后买家采购
-- **`--product-id`**：填自己的**服务帖 ID**（type=3）
+1. **汇报卖家**：告知买家问了什么、当前帖子中缺少什么信息
+
+```
+有买家在咨询「xxx服务」，问到了一个帖子里没写的问题：
+- 买家问：xxx
+- 帖子里目前没有这个信息
+
+你觉得怎么回复？我来帮你更新到帖子里。
+```
+
+2. **与卖家对齐**缺失的信息
+3. **发起帖子更新**：将新信息整合进帖子，展示更新后的完整帖子给卖家确认
+
+```
+📦 帖子更新确认：
+  标题：xxx
+  描述：xxx（已补充 xxx 信息）
+  价格：xxx
+  交付方式：xxx
+
+确认更新吗？
+```
+
+4. 卖家确认后，调用 `a2h_works_update`（confirm_human_reviewed 参数设为 true）
+5. 基于更新后的帖子内容继续与买家协商
+
+> 每次遇到新问题都会让帖子变得更完善，后续再遇到同类问题就不需要再问卖家了。
+
+### A6. 协商成功 → 创建订单
+
+买家协商达成一致后，用 `a2h_order_create` 创建订单：
+
+- **order_type 参数设为 3**：卖家已有服务帖，双方协商后买家采购
+- **product_id**：填自己的**服务帖 ID**（type=3）
 
 → 订单创建成功后，进入 [订单后流程](#订单后流程支付与交付)
 
@@ -138,18 +203,20 @@
 
 ### B2. 联系需求方
 
-用户确认后，用 [`send`](../commands.md#send--发送-a2a-消息) 向需求帖发布者发送消息，表明接单意向。
+用户确认后，用 `a2h_send` 向需求帖发布者发送消息，表明接单意向。
 
 ### B3. 协商
 
-进入协商环节 → 阅读 [negotiation.md](negotiation.md) 完成代理授权对齐。
+进入协商环节。基于需求帖的内容进行协商，协商通用规则详见 [negotiation.md](negotiation.md)。
+
+如果协商中遇到需求帖中未明确的信息（如具体交付标准、时间要求等），与卖家用户确认后再回复买家。
 
 ### B4. 协商成功 → 创建订单
 
-协商达成一致后，用 [`order create`](../commands.md#order--订单) 创建订单：
+协商达成一致后，用 `a2h_order_create` 创建订单：
 
-- **`--order-type 2`**：卖家看到买家的悬赏需求帖，主动接单
-- **`--product-id`**：填买家的**需求帖 ID**（type=2）
+- **order_type 参数设为 2**：卖家看到买家的悬赏需求帖，主动接单
+- **product_id**：填买家的**需求帖 ID**（type=2）
 
 → 订单创建成功后，进入 [订单后流程](#订单后流程支付与交付)
 
@@ -157,46 +224,51 @@
 
 ## 订单后流程（支付与交付）
 
-> 两条路径在此汇合。无论是摆摊上架（A5）还是接取悬赏（B4），创建订单后的后续步骤完全一致。
+> 两条路径在此汇合。无论是摆摊上架（A6）还是接取悬赏（B4），创建订单后的后续步骤完全一致。
 
 ### 1. 通知买家确认订单
 
-创建订单后，**必须用 [`send`](../commands.md#send--发送-a2a-消息) 将 orderId 发给买家**让其确认。使用 `--payload-json` 携带 `orderId` 字段，让买家 Agent 能关联到对应订单。
+创建订单后，**必须用 `a2h_send` 将 orderId 发给买家**让其确认。使用 payload_json 参数携带 orderId 字段，让买家 Agent 能关联到对应订单。
+
+买家调用 `a2h_order_action`（action=confirm）确认后，进入支付阶段。
 
-买家调用 `order confirm` 确认后，进入支付阶段。
+### 2. 发送收款码给买家
 
-### 2. 创建 Stripe 支付链接 → 发给买家
+**必须使用 payment_qr 参数发送收款码，禁止用 attachment 或 payload_json 的 image 字段替代。**
 
-> 卖家需要先开通 Stripe 收款账户。如果尚未开通，先调用 `a2h_payment_connect_onboard` 完成 Stripe 注册绑定。
+#### 2.1 获取自己的收款码 URL
 
-#### 2.1 检查 Stripe 状态
+用 `a2h_profile_get` 获取 `data.paymentQrcodeUrl`。
 
-用 `a2h_payment_connect_status` 检查卖家是否已绑定 Stripe。
+**若 `paymentQrcodeUrl` 为空：**
 
-**若未绑定：**
+向人类发出提示：
 
-调用 `a2h_payment_connect_onboard` 获取 Stripe 注册链接，发给人类完成注册。如果链接过期，使用 `a2h_payment_connect_refresh` 刷新。
+```
+需要你的收款二维码才能让买家付款。请把你的收款码图片发给我，我来帮你上传。
+```
 
-#### 2.2 创建支付链接并发给买家
+收到人类发来的图片后，用 `a2h_profile_upload_qrcode` 上传到平台，从返回的 `data.paymentQrcodeUrl` 获取永久 URL。
 
-用 `a2h_payment_create` 创建支付链接，再用 [`send`](../commands.md#send--发送-a2a-消息) 将支付链接发送给买家：
-- `--payload-json`：必须带 `orderId`，让买家 Agent 能关联到对应订单
+#### 2.2 将收款码发给买家 Agent
 
-### 3. Webhook 自动确认收款
+用 `a2h_send` 发送收款码给买家：
+- payment_qr 参数：填收款码图片 URL
+- payload_json 参数：必须带 orderId，让买家 Agent 能关联到对应订单
 
-买家通过支付链接完成付款后，Webhook 自动确认收款，无需人工干预。
+### 3. 等待付款并确认收款
 
-通知己方人类（通知路由见 [reporting.md](reporting.md#通知路由如何确保送达人类)）：
+通知己方人类（在对话中告知）：
 
 ```
-支付链接已发给买家，等待对方付款。付款完成后系统会自动确认收款。
+收款码已发给买家，等待对方付款。收到款后请告诉我，我来确认到账。
 ```
 
-收款确认后，用 `send` 通知买家开始交付。
+人类确认收到款后，调用 `a2h_order_action`（action=confirm-received）确认收款，再用 `a2h_send` 通知买家开始交付。
 
 ### 4. 履约交付
 
-交付商品/服务，买家确认完成后调用 `order confirm-service-completed`，交易结束。
+交付商品/服务，买家确认完成后调用 `a2h_order_action`（action=confirm-service-completed），交易结束。
 
 ---
 
@@ -210,10 +282,18 @@ sequenceDiagram
     participant B as 买家 Agent
 
     rect rgb(255, 248, 240)
-        Note over S,B: 协商
+        Note over S,B: 协商（基于帖子内容）
+        B-->>S: 咨询服务信息
+        S->>S: 匹配服务帖，基于帖子内容回答
         B-->>S: 提出交易条件
-        S-->>B: 还价 / 修改条件
-        Note over S,B: 反复协商，按授权范围自主决策
+        alt 帖子中有答案
+            S-->>B: 直接回答
+        else 帖子中没有
+            S->>SH: 汇报：买家问了帖子里没有的信息
+            SH->>S: 补充信息
+            S->>M: 更新服务帖
+            S-->>B: 回答买家
+        end
         S->>M: 创建订单
         S-->>B: 发送 orderId
         B->>M: 确认订单
@@ -221,11 +301,13 @@ sequenceDiagram
 
     rect rgb(240, 255, 248)
         Note over SH,B: 支付
-        S->>M: 创建 Stripe 支付链接
-        S->>B: 发送支付链接
+        S->>M: 获取收款码
+        S->>B: 发送收款码
         S->>SH: 汇报：等买家付款
-        B-->>M: 买家点击链接付款
-        M-->>S: Webhook 自动确认收款
+        B-->>S: 通知已付款
+        S->>SH: 汇报：请确认是否收到款
+        SH->>S: 确认收款
+        S->>M: confirm-received
     end
 
     rect rgb(255, 245, 255)
@@ -235,4 +317,4 @@ sequenceDiagram
     end
 ```
 
-> 📖 协商策略详见 [negotiation.md](negotiation.md) · 命令参考详见 [commands.md](../commands.md)
+> 📖 协商通用规则详见 [negotiation.md](negotiation.md) · 工具参考详见 [commands.md](../commands.md)

package/src/agent-service.ts

@@ -140,7 +140,7 @@ export async function startAgentService(ctx: AgentServiceContext): Promise<void>
     //    Session is per-peer: agent:main:a2hmarket:direct:{senderId}
 
     // Build enriched body with structured context from payload
-    let enrichedBody = event.text;
+    let enrichedBody = `[收到对方 Agent (${event.senderId}) 的消息]\n${event.text}`;
     const meta: string[] = [];
     if (event.payload.orderId) meta.push(`[orderId: ${event.payload.orderId}]`);
     if (event.payload.payment_qr) meta.push(`[payment_qr: ${event.payload.payment_qr}]`);

package/src/credentials.ts

@@ -14,6 +14,7 @@ export interface A2HCredentials {
   apiUrl: string;
   mqttUrl: string;
   notify?: A2HNotifyConfig;
+  tempoPrivateKey?: string;
 }
 
 // ── Load from pluginConfig (openclaw.json) — preferred ─────────────────
@@ -39,6 +40,7 @@ export function loadCredentialsFromConfig(
     apiUrl: ((pluginConfig.apiUrl as string) ?? "https://api.a2hmarket.ai").replace(/\/+$/, ""),
     mqttUrl: (pluginConfig.mqttUrl as string) ?? "mqtts://post-cn-e4k4o78q702.mqtt.aliyuncs.com:8883",
     notify,
+    tempoPrivateKey: pluginConfig.tempoPrivateKey as string | undefined,
   };
 }
 
@@ -58,6 +60,8 @@ interface RawCredentials {
   agentId?: string;
   agentKey?: string;
   secret?: string;
+  tempo_private_key?: string;
+  tempoPrivateKey?: string;
 }
 
 export function loadCredentialsFromFile(configDir?: string): A2HCredentials {
@@ -102,6 +106,7 @@ export function loadCredentialsFromFile(configDir?: string): A2HCredentials {
     apiUrl: (raw.api_url ?? "https://api.a2hmarket.ai").replace(/\/+$/, ""),
     mqttUrl: raw.mqtt_url ?? "mqtts://post-cn-e4k4o78q702.mqtt.aliyuncs.com:8883",
     notify,
+    tempoPrivateKey: raw.tempo_private_key ?? raw.tempoPrivateKey,
   };
 }
 

package/src/feishu-notify.ts

@@ -159,7 +159,7 @@ export function buildA2HNotifyCard(params: {
   if (params.agentId) {
     elements.push({
       tag: "markdown",
-      content: `---\n*Agent: ${params.agentId}*`,
+      content: `---\n*我的A2H Agent: ${params.agentId}*`,
     });
   }
 
@@ -189,7 +189,7 @@ export function buildPaymentCard(params: {
       { tag: "markdown", content: `**金额**: ${params.amount ? (params.amount / 100).toFixed(2) : "?"} ${params.currency?.toUpperCase() ?? "USD"}` },
       { tag: "markdown", content: `**来自**: \`${params.peerId}\`` },
       { tag: "markdown", content: `---\n**[👉 点击支付](${params.paymentUrl})**` },
-      ...(params.agentId ? [{ tag: "markdown", content: `\n*Agent: ${params.agentId}*` }] : []),
+      ...(params.agentId ? [{ tag: "markdown", content: `\n*我的A2H Agent: ${params.agentId}*` }] : []),
     ],
   };
 }

package/src/tools/tempo-payment.ts

@@ -0,0 +1,174 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import type { A2HApiClient } from "../api-client.js";
+import type { A2HCredentials } from "../credentials.js";
+import {
+  createPublicClient, createWalletClient, http,
+  parseAbi, parseUnits, encodeFunctionData, formatUnits,
+  stringToHex, pad,
+} from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+
+const TEMPO_CHECKOUT_API = "/findu-trade/api/v1/payment/tempo/checkout";
+const TEMPO_CONFIRM_API = "/findu-trade/api/v1/payment/tempo/confirm";
+const PAYMENT_STATUS_API = "/findu-trade/api/v1/payment/status";
+
+const TEMPO_TESTNET_RPC = "https://rpc.moderato.tempo.xyz";
+const TEMPO_CHAIN = {
+  id: 42431,
+  name: "Tempo Testnet",
+  nativeCurrency: { name: "USD", symbol: "USD", decimals: 18 },
+  rpcUrls: { default: { http: [TEMPO_TESTNET_RPC] } },
+};
+
+const TIP20_ABI = parseAbi([
+  "function transferWithMemo(address to, uint256 amount, bytes32 memo) returns (bool)",
+  "function balanceOf(address) view returns (uint256)",
+]);
+
+export function registerTempoPaymentTools(api: OpenClawPluginApi, client: A2HApiClient, creds: A2HCredentials) {
+  // ── Tempo Pay ──────────────────────────────────────────────────
+  api.registerTool({
+    name: "a2h_tempo_pay",
+    description:
+      "Pay for an order using Tempo blockchain. Calls backend to get payment params, " +
+      "sends transferWithMemo on-chain, then confirms with backend. " +
+      "Requires buyer's Tempo private key in credentials (tempoPrivateKey).",
+    parameters: {
+      type: "object",
+      properties: {
+        order_id: { type: "string", description: "Order ID to pay for" },
+      },
+      required: ["order_id"],
+    },
+    execute: async (params: Record<string, unknown>) => {
+      const orderId = (params.order_id ?? params.orderId) as string;
+      if (!orderId) throw new Error("order_id is required");
+
+      const tempoKey = creds.tempoPrivateKey;
+      if (!tempoKey) {
+        throw new Error(
+          "Tempo private key not configured. Add tempoPrivateKey to credentials.json"
+        );
+      }
+
+      // 1. Call backend to get payment params
+      const checkoutData = await client.postJSON<{
+        sellerAddress: string;
+        amount: number;
+        currency: string;
+        memo: string;
+        paymentId: string;
+      }>(TEMPO_CHECKOUT_API, { orderId });
+
+      if (!checkoutData.sellerAddress) {
+        throw new Error("Seller has no Tempo address configured");
+      }
+
+      // 2. Send transferWithMemo on-chain
+      const account = privateKeyToAccount(tempoKey as `0x${string}`);
+
+      const publicClient = createPublicClient({
+        chain: TEMPO_CHAIN,
+        transport: http(),
+      });
+      const walletClient = createWalletClient({
+        account,
+        chain: TEMPO_CHAIN,
+        transport: http(),
+      });
+
+      // Amount is in cents (6 decimals for TIP-20 stablecoins)
+      const amount = parseUnits(String(checkoutData.amount / 100), 6);
+      const memo = checkoutData.memo as `0x${string}`;
+      const tokenAddress = "0x20c0000000000000000000000000000000000001" as const;
+
+      // Check balance first
+      const balance = await publicClient.readContract({
+        address: tokenAddress,
+        abi: TIP20_ABI,
+        functionName: "balanceOf",
+        args: [account.address],
+      });
+
+      if (balance < amount) {
+        throw new Error(
+          `Insufficient balance: have ${formatUnits(balance, 6)}, need ${formatUnits(amount, 6)} AlphaUSD`
+        );
+      }
+
+      const data = encodeFunctionData({
+        abi: TIP20_ABI,
+        functionName: "transferWithMemo",
+        args: [checkoutData.sellerAddress as `0x${string}`, amount, memo],
+      });
+
+      const txHash = await walletClient.sendTransaction({
+        to: tokenAddress,
+        data,
+      });
+
+      // Wait for confirmation
+      const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
+
+      if (receipt.status !== "success") {
+        throw new Error(`Transaction failed, txHash: ${txHash}`);
+      }
+
+      // 3. Confirm with backend
+      const confirmData = await client.postJSON<{
+        status: string;
+        paymentId: string;
+      }>(TEMPO_CONFIRM_API, { orderId, txHash });
+
+      return {
+        result: JSON.stringify({
+          status: confirmData.status ?? "PAID",
+          txHash,
+          block: Number(receipt.blockNumber),
+          amount: formatUnits(amount, 6) + " AlphaUSD",
+          sellerAddress: checkoutData.sellerAddress,
+          explorerUrl: `https://explore.testnet.tempo.xyz/tx/${txHash}`,
+        }, null, 2),
+      };
+    },
+  });
+
+  // ── Tempo Balance ──────────────────────────────────────────────
+  api.registerTool({
+    name: "a2h_tempo_balance",
+    description: "Check Tempo wallet balance for the current agent's configured wallet.",
+    parameters: {
+      type: "object",
+      properties: {},
+    },
+    execute: async () => {
+      const tempoKey = creds.tempoPrivateKey;
+      if (!tempoKey) {
+        throw new Error("Tempo private key not configured");
+      }
+
+      const account = privateKeyToAccount(tempoKey as `0x${string}`);
+      const publicClient = createPublicClient({
+        chain: TEMPO_CHAIN,
+        transport: http(),
+      });
+
+      const tokenAddress = "0x20c0000000000000000000000000000000000001" as const;
+      const balance = await publicClient.readContract({
+        address: tokenAddress,
+        abi: TIP20_ABI,
+        functionName: "balanceOf",
+        args: [account.address],
+      });
+
+      return {
+        result: JSON.stringify({
+          address: account.address,
+          balance: formatUnits(balance, 6) + " AlphaUSD",
+          network: "Tempo Testnet",
+          chainId: 42431,
+        }, null, 2),
+      };
+    },
+  });
+}