Imans OpenClaw 助手

要解决的问题

OpenClaw 用户在对话里询问 Imans 业务数据时，代理拿到的通常只是一段模糊的自然语言：哪个工作区、查产品还是查订单、按日期还是按状态过滤、要明细还是要汇总。如果让模型自己拼 CLI 参数，很容易猜错命令名、漏传过滤条件，或者把整份 JSON 直接甩到群里。

imans-claw 把这类请求收敛成固定动作：先判断资源类型，再选最窄的一条命令，最后在本地解析并归纳结果。

技能如何工作

核心能力分三层。

环境前置。 技能依赖 imans 二进制存在于 OpenClaw 执行 shell 的 PATH 中；沙箱或容器场景下需要在该环境内部单独安装。用 openclaw skills list 确认技能已加载，再用 /skill imans-claw 或直接询问产品/订单数据做端到端验证。

查询能力。 覆盖工作区、Profile、产品、变体、销售订单、订单明细、分类七类资源：

• 产品检索：imans products list --search "" --json 走关键词搜索，--all 拉全量
• 订单过滤：imans sales-orders list 支持按 --order-date-from/--order-date-to 或 --order-status 两个维度
• 逐层下钻：从销售订单到 sales-order-items，从产品到 product-variants，都能拿到关联明细
• 上下文确认：imans workspace get、imans profile list、imans auth test 用于多工作区场景下锁定当前身份

响应模式。 被调用时遵循固定流程：识别请求隐含的资源与过滤条件 → 执行最窄的命令 → 在代理本地解析 JSON 而非展示原始输出 → 归纳关键字段、数量、异常和下一步可行的下钻方向 → 多工作区环境下注明本次使用的 profile。

适用边界与注意点

• 它是只读查询工具，不负责创建、更新或删除 Imans 数据。
• 结果摘要面向移动端和群聊做了压缩，需要完整字段时应明确要求导出，而不是默认全量输出。
• 大范围订单或客户数据、未加过滤的批量导出，执行前会先请求确认。
• Token 处理上刻意回避 --token 直传（易留在 shell history），自动化场景推荐 --token-env 或 --token-stdin；聊天中不会打印或索要原始 token。
• 退出码有明确语义：3 认证失败、4 权限不足、5 资源不存在、6 网络问题、7 API 服务端错误，排障时可据此分流。
• --debug 会暴露认证头，仅在排查问题时使用。