国内应用接入
微信小店接入 Hermes Agent：查订单、商品与库存
用商家自研开发凭证连接自己的店铺，让 Hermes 整理待发货订单和商品库存。当前连接只读，订单详情会过滤买家联系方式与地址。
让店铺经营问题对应到实际订单
“今天有哪些订单待发货”“这个商品哪个规格库存少”适合交给查询工具处理。Hermes 可以先拿到订单号或商品 ID，再逐笔读取详情，按您指定的范围生成运营摘要。订单列表只提供订单号，不能跳过详情查询就编出销售额或商品明细。
这条路径使用微信小店后台的商家自研开发设置。它与公众号、小程序和微信支付商户是不同的连接：不要拿公众号 AppID、支付私钥或个人微信账号填入小店表单。
接入后可以做什么？
- 按时间与状态找订单：按创建时间或更新时间查订单号，可筛选待发货等状态，单次时间窗口最多 7 天，支持 next_key 分页。
- 读取单笔经营信息：根据订单号查询商品、金额、支付时间和物流状态；不返回买家姓名、电话、地址、openid 或订单备注。
- 查看商品与 SKU 库存：先查询上架或下架商品 ID，再读取线上商品标题、状态、最低价和 SKU 库存。
获取小店专用 AppID，并设置 IP 白名单
需要店铺管理员取得微信小店 AppID 和 AppSecret，并允许托管连接服务的出口 IP 调用接口。请使用小店后台“开发 → 开发设置”的凭证。
- 打开自己的店铺后台 — 登录 store.weixin.qq.com，找到开发设置与商家自研开发入口；若没有入口，先让店铺管理员确认当前账号权限。
- 取得小店凭证 — 复制小店 AppID，并按后台流程生成或获取 AppSecret。重置已有密钥前先确认是否有其他系统正在使用它。
- 添加连接服务出口 IP — 在小店 API IP 白名单添加 46.225.67.238。这里填托管连接服务的地址，不是自己电脑或机器人容器的地址。
- 选择 Hermes 并连接小店 — 在国内应用目录选择自己的 Hermes Agent，连接“微信小店”，填写 AppID 和 AppSecret。不要把密钥粘贴到对话中。
- 先核对短时间范围 — 查询最近一天的订单号，再取一笔详情，核对状态与金额。商品查询也先列 ID，再读具体商品，避免将部分页面当成全店数据。
连接后可以直接这样问
- “查最近 24 小时状态为 20 的待发货订单，逐笔读取详情，整理商品与金额，不展示买家信息。”
- “列出上架商品，再查询我指定的商品 ID，按 SKU 库存从少到多整理。”
- “查询这笔小店订单的支付时间和物流状态，金额按分除以 100 换算为元。”
使用前必须知道的限制
订单列表每页最多 100 个订单号、单次时间窗最多 7 天；商品列表每页最多 30 个 ID。翻页时要原样保留首次订单查询的时间、时间类型和状态，再传回 next_key。长订单号与商品 ID 应作为文本处理，金额单位为分。
IP 白名单错误常表现为 40164；凭证错误时先核对是否误用了公众号或小程序 AppID。当前连接不会发货、改库存、改价或处理退款，也不提供买家联系方式导出。库存与订单状态会变化，实际操作前请回店铺后台核对。
托管连接还是自己搭工具？
| 方案 | 适合谁 | 您需要负责什么 |
|---|---|---|
| OpenClaw Launch 托管 | 希望尽快让机器人持续在线并连接微信小店的用户 | 提供必要授权、确认敏感操作并管理自己的应用账户 |
| 自行部署 | 已有服务器、愿意维护 Hermes Agent 与兼容工具的开发者 | 为 Hermes 搭建小店只读工具，配置自己的服务端出口 IP，维护令牌缓存、分页、长整数 ID 与分单位金额处理，并过滤买家身份和备注字段。 |
自行部署是合理选择；托管方案省下的是服务器配置、运行监控和集成维护时间。OpenClaw Launch 的托管价格为首月 $3，续费 $6/月，支持支付宝和微信支付。应用自身的会员、API 配额或其他费用仍按应用方规则计算。
已经有机器人？前往国内应用一键接入查看连接状态；第一次部署可先阅读Hermes Agent 入门指南。
微信小店接入常见问题
能用公众号或小程序 AppID 连接吗？
不能替代小店专用凭证。请从微信小店后台的开发设置取得当前店铺 AppID 和 AppSecret。
Hermes Agent 能自动发货或修改库存吗？
当前工具只查询订单与商品，没有发货、改价、改库存或退款操作。
查询返回 40164 怎么办？
检查微信小店 API IP 白名单是否包含连接服务出口 46.225.67.238，并核对保存是否生效。
为什么订单详情没有买家地址？
托管连接会过滤买家姓名、电话、地址、openid 和备注，保留经营查询所需的商品、金额与物流状态。需要履约信息时，请使用商家后台。