蔡汉皋药房 · 双端共享 OpenClaw 业务 Agent

① 双端共享架构

分销员对话下单（飞书 / 企微 IM），管理员浏览器后台运维，双端共享同一份 SQLite WAL，状态实时一致。

flowchart LR
  D["分销员
90 人"] -->|"对话"| FE["飞书 IM
企微"]
  FE -->|"WebSocket"| GW["OpenClaw Gateway
token 鉴权"]
  GW -->|"call_skill"| MCP["pharmacy-mcp
9 工具 · FastMCP"]
  MCP <-->|"读写"| DB[("SQLite WAL
customers / products / orders")]

  ADMIN["管理员"] -->|"浏览器"| WEB["Next.js 16 Web 后台
pharmacy.caihangao.com"]
  WEB <-->|"Prisma"| DB

  DB -.->|"间接服务"| END["终端客户
3 万+"]

  classDef userNode fill:#fafafa,stroke:#a3a3a3,color:#0a0a0a
  classDef gwNode fill:#fff,stroke:#0a0a0a,color:#0a0a0a
  classDef appNode fill:#f5f5f5,stroke:#0a0a0a,color:#0a0a0a
  classDef dbNode fill:#0a0a0a,stroke:#0a0a0a,color:#fff
  class D,ADMIN,END userNode
  class FE,GW,WEB gwNode
  class MCP appNode
  class DB dbNode

技术栈：OpenClaw Skill · MCP (Python/FastMCP) · Next.js 16 App Router · Tailwind v4 · Prisma · SQLite WAL · JWT(jose) · PM2 / Nginx · Let's Encrypt

② 9 个 MCP Tool 矩阵

小皋（pharmacy）Agent 可调用的 9 个工具，覆盖商品 / 客户 / 订单 / 支付 / 身份解析全流程。

list_products

查询在售商品（53 SKU）+ 活动价

query_customers

客户搜索 / 详情 / 标签筛选

create_order

下单（分销员 ACL + 自动算价）

query_orders

订单查询（状态 / 客户 / 时间范围）

cancel_order

撤单（仅未发货状态可撤）

update_order_address

改地址（已下单未发货时支持）

order_stats

分销员业绩统计（日 / 周 / 月）

confirm_payment

收款确认（待付款 → 待发货）

resolve_identity

飞书 / 企微多通道身份解析

③ 订单状态流转

待付款 → 待发货 → 已发货 → 已签收 | 已关闭

5 种状态 · 任意阶段可关闭 · 已签收为正常终态

④ 分销员下单指南

项目自带 HTML 使用手册（共 468 行），覆盖飞书 / 企微对话下单全流程：商品列表、分销员注册、下单 / 改单 / 撤单、收款确认、客户管理等。

打开使用手册 ↗