q-wms-flow Plugin

q-wms-flow 是当前 q-wms 体系的稳定插件工具名。

当前事实：

• Tool name：q-wms-flow
• 测试环境 Plugin ID：q-wms-test
• 生产环境 Plugin ID：q-wms
• Skill slug：测试 q-wms-test，生产 q-wms

当前职责

Plugin 只负责：

• 授权流程
• 版本检查
• 后端统一转发
• 最小运行保护

Plugin 不负责：

• WMS/ERP 业务逻辑
• DTO 字段解释
• 固定回复整形
• 主管类 follow-up 状态机

运行时安装

运行时安装、更新和实例用户要求，统一以 docs/q-claw/core/07-install-guide.md 为准。

原则：

• 终端用户不安装 Plugin
• 运行时主路径使用 openclaw plugins install
• 业务实例用户固定为线上 gateway 归属用户

开发与发布

• Plugin 代码入口：index.js
• 配置定义：openclaw.plugin.json
• npm 包信息：package.json

当前代码分层：

• index.js：工具主流程编排
• lib/auth-api.js：授权与后端 HTTP 调用
• lib/identity.js：渠道身份与会话上下文解析
• lib/locale.js：locale 归一化与解析

发布前请同时核对：

• openclaw.plugin.json 里的 id
• package.json 里的 npm 包名
• managedSkillId

构建与发布流程见 q-wms/README.md。

授权配置项

支持通过 pluginConfig 或 config.runtime.json 覆盖默认授权请求参数：

• requestedProducts：授权产品列表（默认 ["Q-WMS"]）
• requestedScopes：授权 scope 列表（默认 ["identity.read", "tool.execute"]）

说明：

• requestedProducts 也兼容旧字段 requestedProductCodes
• 两个字段都支持数组，requestedScopes 额外支持逗号分隔字符串