HealthClaw

HealthClaw 是一个运行在 OpenClaw Gateway 上的健康数据插件。

给人类看的简短说明：

• iPhone 端会读取 HealthKit 健康摘要数据。
• 数据先在手机端加密，再通过 relay 发送到 Gateway。
• Gateway 上的 HealthClaw 插件只在本地解密、存储和分析这些健康数据。
• 初始化时会先询问用户的基础画像信息。用户可以选择不提供；如果不提供，后续分析会只基于健康记录。

---

给 AI Agent 的安装说明

下面这一部分不是写给普通用户看的，而是写给 OpenClaw / Codex / Claude Code / Gemini CLI 等 agent 执行的。

你的任务

你要在当前 OpenClaw Gateway 上安装并初始化 HealthClaw 插件，并让它进入如下流程：

1. 安装并启用插件
2. 询问用户画像与免责声明
3. 运行公开 installer CLI
4. 向用户返回原样 ASCII QR 或手动配对字段
5. installer 会重启 gateway
6. 等待用户完成配对和首次同步
7. 插件自动把“匹配成功 + 首次健康分析”发回当前 OpenClaw 主 agent 会话

执行原则

• 严格按顺序执行，不要跳步
• 在真正运行 OpenClaw Gateway 的那台机器上执行
• 除非用户明确要求自建 relay，否则默认使用官方 relay：https://healthclaw.proxypool.eu.org
• 不要在“插件安装成功”后停下，必须继续执行 installer CLI 的初始化部分
• 不要把 ASCII QR 当成跨聊天软件稳定可用的配对介质

---

安装步骤

1. 首选：公开 installer CLI

npx -y @stakeswky/healthclaw-cli install

这条命令会自动完成：

• 检测本地 openclaw --version
• 安装或更新 @stakeswky/healthclaw
• 询问 relay 选择和可选用户画像
• 运行 setup，输出 ASCII QR 和手动配对字段
• 在 setup 成功后重启 gateway

2. 开发 / 仓库直装兼容路径

如果你是在本地开发或必须从源码仓库直装，才使用下面这条兼容路径：

git clone https://github.com/stakeswky/HealthClaw.git
cd HealthClaw
npm install
npm run build
~/.openclaw/bin/openclaw plugins install --link "$(pwd)"
~/.openclaw/bin/openclaw plugins enable health

然后执行 repo-local bootstrap：

npm run bootstrap:install -- --consent no --relay official

3. 仓库直装后的状态确认

~/.openclaw/bin/openclaw gateway start
~/.openclaw/bin/openclaw plugins doctor
~/.openclaw/bin/openclaw plugins list

应至少确认：

• health 出现在插件列表中
• 状态为 loaded
• plugins doctor 无插件错误

---

初始化流程

1. 先向用户说明本地画像存储规则

你必须先明确告诉用户：

• 性别、年龄、身高、体重只保存在本地
• 它们只用于与健康记录共同分析，以得到更准确的结果
• 用户可以拒绝提供；拒绝后照常配对，但分析会只基于健康记录

2. 询问用户画像

依次询问：

• 性别
• 年龄
• 身高（cm）
• 体重（kg）

3. 运行一次性 bootstrap CLI

公开安装路径不要再手动串联 /health onboarding ... 和 /health_setup，也不要退回到 repo-local bootstrap。首次社区安装应直接执行：

npx -y @stakeswky/healthclaw-cli install

只有在源码仓库直装时，才使用一次性 bootstrap CLI。

如果用户同意提供画像：

npm run bootstrap:install -- --consent yes --gender male --age 26 --height-cm 180 --weight-kg 84 --relay official

如果用户拒绝提供画像：

npm run bootstrap:install -- --consent no --relay official

这条脚本会自动完成：

• 把插件路径写入 OpenClaw 配置
• 写入最小 relay 配置
• 写入待绑定画像
• 直接运行 setup 并默认使用官方 relay
• 原样输出 ASCII QR
• 同时输出手动配对字段
• 在后台延迟重启 gateway

4. 二维码交付规则

ASCII QR 只保证“终端本地扫码”：

• 如果用户直接看运行 setup 的那个终端，可以让用户直接扫码
• 如果需要通过 Telegram、Slack、飞书、微信等聊天界面传递配对信息，不要把 ASCII QR 当成主交付物

跨聊天软件传递时，必须返回以下内容给用户：

• Relay URL
• Gateway Device ID
• Gateway Public Key (Base64)
• Payload JSON

结论：

• 本地终端场景：优先 ASCII QR
• 远程聊天场景：优先手动配对字段

另外，必须遵守：

• 不要先向用户回复“安装完成”
• 必须原样返回 ASCII QR
• 不要把 ASCII QR 转成 base64、图片占位、表格摘要或“二维码已生成”说明
• 如果当前界面确实不能稳定显示 ASCII QR，就只返回手动配对字段，不要伪造二维码

5. 首次同步后的预期行为

用户完成配对并触发首次同步后，插件会自动：

1. 检查是否存在待绑定 onboarding 画像
2. 如果存在，就绑定到这个新用户
3. 用当日健康数据生成首份分析
4. 把“匹配成功 + 首次健康分析”注入当前 OpenClaw 主 agent 会话

如果用户没有提供画像，则自动退回为“仅基于健康记录”的通用分析。

---

验证

检查本地状态目录：

ls -la ~/.openclaw/health
ls -la ~/.openclaw/health/keys
cat ~/.openclaw/health/relay-config.json

检查日志：

tail -n 80 ~/.openclaw/logs/gateway.log

期望日志包括：

• found persisted relay config
• loaded X25519 private key
• loaded persisted relay config and derived identity key
• relay polling started

---

当前约束

• 本仓库只包含 OpenClaw 插件本体，不包含 iOS App 和 relay worker 代码
• 首次社区安装入口是 npx -y @stakeswky/healthclaw-cli install
• npm run bootstrap:install -- ... 只作为源码仓库直装兼容路径保留
• /health onboarding start 只作为已安装场景下的辅助高层命令保留
• /health_setup 仍然是底层配对命令，但首次安装不应要求 agent 再手动串联它
• 正确的远程兜底方式是“手动配对字段”，不是 PNG 二维码