国内应用接入
有赞接入 Hermes Agent：整理店铺订单、物流与商品
通过有赞云商家自用型应用授权自己的店铺，让 Hermes 读取经营数据。连接需要应用凭证与店铺 ID，不需要把账号密码交给机器人。
把店铺查询变成可重复的工作流程
客服排查一笔订单、仓库整理待发货清单、运营查某类商品，都需要先找到店铺里的真实记录。有赞连接提供订单列表、订单详情、物流轨迹、商品列表和商品详情五类只读工具。Hermes 可以串联这些查询，再按您指定的格式整理。
这里使用“商家自用型无容器应用”。有赞的“无容器”描述应用的部署方式，与 Hermes 托管实例不是一回事；它也不等于服务商面向多个陌生店铺的通用 OAuth 授权。
接入后可以做什么？
- 筛选经营订单：按待发货等状态、订单号或成对的创建/更新时间范围查询；再读取指定订单的商品、金额与物流信息。
- 核对快递轨迹：从订单详情取得物流单号 express_no 与快递公司 express_id，查询物流轨迹。只提供单号通常不够。
- 查看商品信息：按关键词列出商品，区分网店与门店渠道，再读取指定商品详情。查询不会上架、改价或调整库存。
创建自用型无容器应用并绑定店铺
需要有赞云 client_id、client_secret 和已授权店铺的 kdt_id。连接表单把店铺 ID 标为 grant_id；它仍是您的有赞店铺 ID，不是应用编号。
- 确认店铺管理权限 — 以有权管理自己店铺的账号注册或登录有赞云。按平台提示完成团队认证；商家可查看是否适用共享店铺主体信息的认证路径。
- 创建商家自用应用 — 选择“我是有赞商家”，按场景选择部署在本地的自用型无容器应用。首次创建和额外店铺的要求不同，以控制台当前提示为准。
- 绑定店铺并取得凭证 — 核对应用已授权绑定目标店铺，复制 client_id、client_secret 和该店铺 kdt_id；检查订单、物流与商品 API 的可用权限和调用配额。
- 连接自己的 Hermes — 在国内应用目录选择“有赞”，填写应用凭证和店铺 ID。不要拿工具型应用的用户 Token 或另一家店铺 ID 替代。
- 验证查询结果 — 从少量待发货订单开始，核对一笔订单详情；查物流时同时提供详情中的快递公司 ID 和单号。
连接后可以直接这样问
- “查有赞待发货订单的第一页，每页 20 条，整理订单号、商品和状态，先不要发送给任何客户。”
- “读取这笔有赞订单的详情，取 express_no 和 express_id，再查询物流轨迹。”
- “在网店渠道搜索“蛋糕”，读取我指定商品的详情，列出当前可用信息，不修改商品。”
使用前必须知道的限制
订单与商品列表每页最多 50 条；订单时间筛选须成对提供，跨度最多 3 个月。商品 ID 应以字符串传入。API 的调用配额、能力包与费用按有赞规则计算，托管费不包含有赞付费 API 额度。
应用未绑定店铺、权限未开通或配额不足都会阻断查询。订单详情可能含收货信息，应限定查询范围，不把完整客户信息发到公开群聊。工具不发货、不退款、不改单，也不会替您确认客服承诺。
托管连接还是自己搭工具？
| 方案 | 适合谁 | 您需要负责什么 |
|---|---|---|
| OpenClaw Launch 托管 | 希望尽快让机器人持续在线并连接有赞的用户 | 提供必要授权、确认敏感操作并管理自己的应用账户 |
| 自行部署 | 已有服务器、愿意维护 Hermes Agent 与兼容工具的开发者 | 为 Hermes 封装有赞官方查询 API，管理自用型应用的店铺授权与令牌缓存，处理接口业务错误、调用限流和分页，并限制客户信息的返回范围。 |
自行部署是合理选择；托管方案省下的是服务器配置、运行监控和集成维护时间。OpenClaw Launch 的托管价格为首月 $3，续费 $6/月，支持支付宝和微信支付。应用自身的会员、API 配额或其他费用仍按应用方规则计算。
已经有机器人？前往国内应用一键接入查看连接状态；第一次部署可先阅读Hermes Agent 入门指南。
有赞接入常见问题
grant_id 和 kdt_id 是什么关系？
连接表单的 grant_id 填已授权店铺的 kdt_id，即店铺 ID。它不是 client_id，也不是订单号。
Hermes Agent 可以直接退款或发货吗？
当前有赞连接只提供订单、物流与商品查询，没有退款、发货或修改商品的动作。
为什么凭证正确还是查不到店铺？
先核对应用是否绑定该店铺、店铺 ID 是否正确，以及需要的 API 权限和配额是否可用。应用密钥正确不代表能访问任意店铺。
有赞 API 调用费用包含在托管费里吗？
不包含。有赞 API 的免费额度、能力包及超额调用费用按应用控制台和有赞当前规则计算。