ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified data analysis Safety 4/5

ttpos-agent

通过 ttpos-agent API 查询 TTPOS 餐饮系统营业数据，生成报表。使用前必须访问 GET /api/v1/query/guide 获取数据查询指南。Use when: 今日营业额、订单统计、支付方式、菜品排行、会员分析、班次汇总、时段分析等。NOT for: 与 TTPOS 数据无关的问题。

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/bendaye/ttpos-agent
Or

What This Skill Does

ttpos-agent 是一款专为 TTPOS 餐饮管理系统设计的 AI 数据分析与报表生成工具。它通过与 LIGHT_BRIDGE 后端 API 集成，允许用户通过自然语言直接查询复杂的营业数据，例如日营业额、菜品销量排行、订单状态分布及会员分析等。该技能的核心在于将人类问题转换为精准的 SQL 查询，并自动将数据库字段翻译为易于理解的中文报表。

Installation

  1. 确保您的 OpenClaw 环境已安装 ttpos-agent 依赖：clawhub install openclaw/skills/skills/bendaye/ttpos-agent。
  2. 前往 ttpos-agent Web 面板 注册并获取 API Key。
  3. 在 OpenClaw 技能配置面板中，将获取到的 API Key 填入 LIGHT_BRIDGE_API_KEY 字段并保存。
  4. 保存后即可开始使用，建议首次使用前查阅内置的数据查询指南。

Use Cases

本技能主要用于餐饮经营者的日常决策支持：

  • 营业复盘：分析过去一段时间的累计营业额、净利润及支付渠道占比。
  • 菜品优化：查询最畅销的菜品与退单率较高的单品，指导菜单优化。
  • 时段分析：统计各营业时段（如早高峰、午市、晚市）的订单密度，辅助排班。
  • 平台表现：横向对比不同外卖平台（如 Grab, LINE MAN）的订单量与完成情况。

Example Prompts

  1. "查询上个月每个平台的营业额统计，并按完成金额从高到低排序。"
  2. "统计过去一周内最受欢迎的 10 道菜品，仅统计已送达的订单。"
  3. "我想知道今天的餐厅总营业额是多少，以及使用移动支付和现金支付的比例各占多少？"

Tips & Limitations

  • 指南先行：执行任何复杂查询前，必须通过 GET /api/v1/query/guide 获取当前环境的 schema 和约束，这是保证查询准确性的基石。
  • 时间约束：建议查询范围控制在 3 个月以内，以保证 API 响应速度和数据提取的准确性。
  • 数据清洗：系统会自动处理枚举值（如将 DELIVERED 译为「已送达」），用户无需关心底层数据库字段名。
  • 安全提醒：务必在 SQL 中始终包含 WHERE delete_time = 0，以避免查询到软删除的历史数据导致统计偏差。
Read Full Documentation on GitHub

Metadata

Author@bendaye
Stars4473
Views0
Updated2026-05-01
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-bendaye-ttpos-agent": {
      "enabled": true,
      "auto_update": true
    }
  }
}

Tags(AI)

#ttpos#餐饮数据#数据分析#营业报表#sql分析
Safety Score: 4/5

Flags: network-access, external-api