Nutrition Claw

用于营养追踪的本地CLI工具,支持JSON数据、语义搜索、可配置目标、食物库、饮食记录、影响反馈及YAML输出。

安装

概览

什么是Nutrition Claw

Nutrition Claw 是一款专为个人营养追踪设计的本地命令行工具,完全离线运行,所有数据均存储在用户本地目录中,绝不外传。它深度集成于 openclaw.ai 生态,通过简洁的命令行界面,帮助用户记录每日饮食、管理食物库、设定个性化营养目标,并实现智能化的饮食反馈与教育。无论是精确记录每餐成分,还是分析长期摄入趋势,该工具都能以 YAML 格式输出清晰、易读的结果,确保用户在隐私保护的前提下获得专业级的营养管理能力。其核心优势在于‘零上传’的数据处理方式,以及结合科学营养学知识的实时反馈机制,让用户不仅能追踪数字,更能理解食物对身体的真实影响。

核心功能特点

  1. 完全本地化运行,所有数据(饮食记录、食物库、目标)保存在 ~/.nutrition-claw/ 目录下,永不联网上传
  2. 支持基于 MiniLM 模型的语义搜索功能,无需精确名称即可智能匹配食物和餐食记录
  3. 提供交互式与参数化两种目标配置模式,可自动计算或手动设定热量、蛋白质、脂肪等营养素目标
  4. 每次添加食材时生成结构化影响反馈,展示当前摄入占目标百分比及状态(达标/不足/超标),并提供具体营养建议
  5. 内置教育性饮食评论系统,根据食材类型轮换讲解营养知识(如蛋白质质量、饱和脂肪影响、纤维益处等),提升用户营养素养
  6. 支持多维度历史查询与汇总报告,可按日期范围查看每日总摄入与目标对比情况

适用场景

Nutrition Claw 特别适合注重健康管理的个体用户,尤其是那些希望在不依赖云服务的情况下精准掌控自身营养摄入的人群。对于正在进行减脂、增肌或维持体重的健身爱好者而言,该工具能帮助他们实时监控宏量营养素是否匹配训练目标,并通过即时反馈调整下一餐结构。例如,当用户摄入一份鸡胸肉后,系统不仅会显示蛋白质已达成15%的目标,还会解释为何这种食物是高效的肌肉合成来源——因其高蛋白低脂的特性,单位热量下提供最优质的氨基酸供给。此外,对于关注慢性病预防(如糖尿病前期或高血压)的成年人,工具中对精制碳水、添加糖和高钠食品的风险提示,有助于建立更健康的饮食习惯。另一个典型场景是家庭厨房中的日常烹饪:用户可将自制酱料、汤品录入食物库,下次食用时只需调用名称即可完成记录,极大简化重复性饮食追踪流程。无论是晨间咖啡、午间沙拉还是晚间加餐,Nutrition Claw 都能无缝融入生活节奏,成为值得信赖的私人营养师助手。