安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install fitatu-diary
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 fitatu-diary。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Fitatu Diary 通过 fitatu-mcp MCP 服务器将 AI 代理连接到 Fitatu 卡路里计数器。它支持读取每日饮食记录和营养进度；通过搜索、条码或自定义项目记录餐食；以及管理体重、饮水量、身体测量数据、锻炼、目标和报告。
在 Openclaw Skills 中，这项技能以实用的安全措施脱颖而出：编辑前先读取日记条目，使用已验证的食物和行 ID，移除前先预览，并区分工具调用成功与数据变更已确认。Fitatu 是非官方集成，账户需要具备网络访问权限和有效会话。

应用场景

询问今天吃了什么、记录了多少，或距离目标还剩多少卡路里和宏量营养素。
通过食物名称、条码、包装标签、自定义卡路里估算或复制餐食来记录餐食。
更正、移动或移除日记条目，移除前可先预览。
记录体重、饮水量、身体测量数据和锻炼，或查看其历史记录。
设置每日卡路里和宏量营养素目标、查看个人资料详情或请求每周报告。
查找食谱、查看食谱说明、创建私人食谱，或为计划中的日期创建购物清单。
使用 Openclaw Skills 工作流程，通过兼容 MCP 的代理主机管理 Fitatu 数据。

工作原理

代理解析请求，并使用 get_today 按 Fitatu 账户的时区确定相对日期。
对于日记变更，它会读取相关日期的内容，或搜索相应目录以获取有效的行 ID 和食物 ID；不会猜测标识符。
它会将用户对餐食的描述映射到日记中实际的 meal_name，并传入对应的 meal_key。
它会调用相应的 MCP 工具来读取进度，或添加、更新、移除或移动日记数据。移除时，会先调用 preview_removal，再调用 remove_items。
在报告变更已发生前，它会检查 data.ok。如果添加操作返回 retry_row_id，则会使用该 ID 重复相同调用，以避免重复条目。
报告结果时会考虑单位和账户限制：能量以 kcal 计，食物营养素和重量以 g 计，水以 ml 计，记录的体重以 kg 计。

配置指南

安装 MCP 服务器包，或使用 uvx 运行，无需单独安装。
在托管服务器的计算机上通过 Fitatu 完成身份验证。对于没有密码的账户，请使用会话导入流程。
在 MCP 主机中配置服务器。以下示例适用于 Hermes Agent；其他 MCP 主机可以使用等效的服务器配置。
测试连接，并在已运行的 Hermes 会话中重新加载 MCP 工具。使用 --demo 可在没有账户的情况下试用服务器。
pip install "fitatu-api[mcp]"
fitatu-api login

对于没有密码的账户，请参阅：

fitatu-api import-session --help
Hermes Agent 配置：
mcp_servers:
fitatu:
command: "uvx"
args: ["--from", "fitatu-api[mcp]", "fitatu-mcp"]
hermes mcp test fitatu

在运行中的会话中：

/reload-mcp
对于其他 MCP 主机，以下是一个示例：
claude mcp add fitatu -- uvx --from "fitatu-api[mcp]" fitatu-mcp
对于远程代理，请在 Fitatu 会话可用的机器上运行服务器，设置 FITATU_MCP_TOKEN，并使用服务器 URL 和 bearer token 配置客户端。在本地或 HTTP 服务器参数中添加 --read-only，可将服务器限制为只读工具。
fitatu-mcp --http --host 0.0.0.0 --allow-host
将 http://:8765/mcp 用作 URL，并将 Authorization: Bearer 用作标头。会话存储在 ~/.fitatu/session.json；令牌会自动刷新。服务器需要网络访问 Fitatu。

数据架构

数据与标识符
数据 技能的处理方式
Fitatu 会话 存储在服务器计算机的 ~/.fitatu/session.json 中；令牌会自动刷新。
日记日期 使用 get_today 按账户时区确定；每周报告从周一统计到请求的结束日期。
日记行 使用 get_day 读取；编辑和移除需要行 ID。
食物和食谱 食物 ID 来自搜索、条码查询、最近使用/收藏/自定义食物或创建工具。切勿猜测 ID。
餐次时段 breakfast 和 lunch 等键代表用户可重命名的时段；根据 meal_name 匹配并使用其 meal_key。
营养与活动 能量单位为 kcal，营养素和食物重量单位为 g，水单位为 ml，体重单位为 kg；锻炼使用分钟和消耗的 kcal。
该技能通过 MCP 工具操作 Fitatu 日记数据；SKILL.md 未定义单独生成的导出文件或本地数据库。日记操作包括餐食条目、目标、备注、饮水量、体重、测量数据、活动、食谱和购物清单。免费账户无法使用某些仅限 Premium 的功能；请查看 get_profile 和工具错误，了解账户具体可用性。免费账户仍可使用报告，但 top_foods 为 null，并附有说明。

高级特性

支持本地 MCP 连接和远程 HTTP 连接，包括为另一台机器上的代理配置 bearer token。 --read-only 服务器模式，适用于不应修改日记数据的配置。
支持通过文本搜索、条码查询、特定地区目录、最近使用的食物、收藏项目和自定义食物创建来查找食物。
支持批量记录餐食、复制餐食、自定义卡路里条目、搜索和创建食谱，以及为计划日期生成购物清单。
提供进度和每周报告、体重和测量历史、个人资料和目标查询，以及锻炼记录。
执行安全的数据变更规则：变更前先读取，移除前先预览，对推断出的或范围更广的变更征求同意，并在添加失败时使用
retry_row_id
。
识别 Fitatu Premium 限制，并建议不要重试因 Premium 相关
forbidden
错误而失败的请求。
对常见服务错误提供可执行的指导，涵盖身份验证过期、速率限制、维护和无效参数。

name: fitatu-diary description: Keep the user's Fitatu food diary (Polish calorie counter, licznik kalorii) through the fitatu-mcp tools - read a day, check calories and macros left against goals, log meals by name, barcode or as a custom item, fix or remove entries, log weight, water, body measurements and workouts, set calorie and macro goals, and give weekly reports. Use when the user mentions Fitatu, what they ate, calories or macros left, logging food or a meal (posiłek, kalorie, dziennik), their weight, water or calorie goal, or a diet report. license: MIT
compatibility: Needs the fitatu-mcp MCP server (pip install "fitatu-api[mcp]", or uvx --from "fitatu-api[mcp]" fitatu-mcp) and a Fitatu session from fitatu-api login. Built for Hermes Agent; works in any MCP host (Claude Desktop, Claude Code, Cursor). Over HTTP (fitatu-mcp --http, with a token) for an agent on another machine. Needs network access to Fitatu.