---
read_when:
    - فعال‌سازی خلاصه‌های HealthKit در یک Node ‏iOS
    - فراخوانی health.summary یا عیب‌یابی معیارهای سلامت مفقودشده
    - بررسی اینکه چه داده‌های سلامتی می‌توانند از یک دستگاه iOS خارج شوند
summary: فعال‌سازی و فراخوانی خلاصه‌های HealthKit با دسترسی کنترل‌شده توسط حریم خصوصی از یک Node در iOS
title: خلاصه‌های HealthKit
x-i18n:
    generated_at: "2026-07-27T14:16:20Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: b8ac13d2870c55e2083a5e3a14c3d04238c2780a9e83d091f31923eb738476af
    source_path: platforms/ios-healthkit.md
    workflow: 16
---

# خلاصه‌های HealthKit

OpenClaw می‌تواند خلاصه‌ای فقط‌خواندنی از روز جاری تقویمی را از یک Node متصل در iPhone یا iPad درخواست کند. دستگاه داده‌های تجمیعی را روی خود دستگاه محاسبه می‌کند و فقط تعداد گام‌ها، مدت خواب، میانگین ضربان قلب در حالت استراحت و تعداد/مدت تمرین‌ها را بازمی‌گرداند. نمونه‌های منفرد HealthKit، منابع، فراداده‌ها، سوابق بالینی، دریافت داده در پس‌زمینه و نوشتن داده پشتیبانی نمی‌شوند.

این قابلیت به‌طور پیش‌فرض غیرفعال است. برای استفاده از آن، هم رضایت جداگانه روی دستگاه iOS و هم مجوز در Gateway لازم است.

## الزامات

- یک iPhone یا iPad که برنامه iOS مربوط به OpenClaw را اجرا کند و HealthKit در آن، داده‌های سلامت را در دسترس گزارش دهد.
- یک Node متصل و تأییدشده iOS. به [راه‌اندازی برنامه iOS](/fa/platforms/ios) مراجعه کنید.
- یک Gateway به‌روز که بتواند به Node دستگاه iOS دسترسی پیدا کند.
- داده‌های خواندنی Health برای هر معیاری که انتظار دارید مشاهده کنید. Apple Watch می‌تواند داده‌ها را به مخزن Apple Health اضافه کند، اما برای خلاصه‌های HealthKit به برنامه watchOS مربوط به OpenClaw نیازی نیست.

## فعال‌کردن دسترسی

### 1. مجازکردن فرمان Gateway

`health.summary` را به آرایه موجود `gateway.nodes.commands.allow` در
`openclaw.json` اضافه کنید. فرمان‌های موجود را حفظ کنید:

```json5
{
  gateway: {
    nodes: {
      commands: { allow: ["health.summary"] },
    },
  },
}
```

`health.summary` در رده موارد بسیار حساس از نظر حریم خصوصی قرار می‌گیرد و تنظیم پیش‌فرض پلتفرم iOS هرگز آن را مجاز نمی‌کند. وجود یک ورودی در `gateway.nodes.commands.deny` بر ورودی فهرست مجاز اولویت دارد. به [سیاست فرمان Node](/fa/nodes#command-policy) مراجعه کنید.

### 2. فعال‌کردن اشتراک‌گذاری روی دستگاه iOS

در برنامه iOS:

1. بخش **Settings -> Permissions** را باز کنید و **Apple Health Summaries** را در بخش همیشه‌نمایان **Apple Health** پیدا کنید.
2. روی **Enable Apple Health Summaries** بزنید.
3. متن افشا را بخوانید، سپس در صفحه مجوز Apple مشخص کنید OpenClaw مجاز به خواندن کدام دسته‌های Health باشد.

این کلید، انتخاب صریح شما برای اشتراک‌گذاری با OpenClaw را ثبت می‌کند. این کلید به‌معنای آن نیست که Apple دسترسی به همه دسته‌های درخواستی را اعطا کرده است.

فعال‌کردن خلاصه‌های Health، `health.summary` را به مجموعه فرمان‌های اعلام‌شده Node اضافه می‌کند. به‌روزرسانی حاصل در جفت‌سازی Node را تأیید کنید:

```bash
openclaw nodes pending
openclaw nodes approve <requestId>
```

سپس بررسی کنید که دستگاه متصل iOS یک فرمان مؤثر `health.summary` ارائه می‌کند:

```bash
openclaw nodes describe --node "<iOS device name>"
```

## درخواست خلاصه امروز

فقط `today` پشتیبانی می‌شود. این خلاصه بازه نیمه‌شب محلی تا زمان درخواست را بر اساس تقویم و منطقه زمانی فعلی دستگاه iOS پوشش می‌دهد.

```bash
openclaw nodes invoke \
  --node "<iOS device name>" \
  --command health.summary \
  --params '{"period":"today"}' \
  --json
```

عامل‌ها می‌توانند همین فرمان را با ابزار `nodes` فراخوانی کنند:

```json
{
  "action": "invoke",
  "node": "<iOS device name>",
  "invokeCommand": "health.summary",
  "invokeParamsJson": "{\"period\":\"today\"}"
}
```

داده خلاصه شامل موارد زیر است:

| فیلد                    | معنا                                       |
| ------------------------ | --------------------------------------------- |
| `period`                 | همیشه `today`                                |
| `startISO`               | آغاز محلی روز، کدگذاری‌شده به‌صورت یک لحظه ISO |
| `endISO`                 | زمان درخواست، کدگذاری‌شده به‌صورت یک لحظه ISO       |
| `timeZoneIdentifier`     | شناسه منطقه زمانی دستگاه iOS               |
| `stepCount`              | مجموع گام‌های گرد‌شده                      |
| `sleepDurationMinutes`   | زمان خواب بدون موارد تکراری، محدودشده به امروز    |
| `restingHeartRateBpm`    | میانگین ضربان قلب در حالت استراحت                    |
| `workoutCount`           | تمرین‌هایی که امروز آغاز شده‌اند                   |
| `workoutDurationMinutes` | مدت کل آن تمرین‌ها              |

فیلدهای معیار اختیاری هستند و هنگامی که HealthKit هیچ مقدار خواندنی بازنگرداند، حذف می‌شوند. مراحل خواب و منابع هم‌پوشان پیش از محاسبه مدت با هم ادغام می‌شوند؛ بنابراین یک دقیقه یکسان دوبار محاسبه نمی‌شود.

## رفتار حریم خصوصی

- تجمیع روی دستگاه iOS انجام می‌شود. نمونه‌های خام از دستگاه خارج نمی‌شوند.
- داده تجمیعی درخواستی از طریق Gateway شما از دستگاه خارج می‌شود. هنگامی که یک عامل آن را درخواست کند، داده تجمیعی به ارائه‌دهنده هوش مصنوعی پیکربندی‌شده می‌رسد و ممکن است در تاریخچه گفتگو باقی بماند. فراخوانی مستقیم CLI آن را به اپراتور CLI بازمی‌گرداند.
- OpenClaw فقط دسترسی خواندن درخواست می‌کند. نمی‌تواند داده‌های Health را اضافه یا تغییر دهد.
- OpenClaw فقط هنگام فراخوانی `health.summary`، HealthKit را می‌خواند. هیچ دریافت داده سلامت در پس‌زمینه‌ای وجود ندارد.
- HealthKit عمداً مشخص نمی‌کند که آیا دسترسی خواندن رد شده است یا نه. نبودن یک معیار می‌تواند به‌معنای رد دسترسی، نبود نمونه منطبق یا در دسترس نبودن نوع داده باشد. OpenClaw نمی‌تواند این حالت‌ها را از هم تشخیص دهد.
- این خلاصه برای زمینه شخصی سلامت و تناسب اندام است، نه تشخیص یا توصیه پزشکی.

برای توقف اشتراک‌گذاری، به **Apple Health Summaries** برگردید و روی **Turn Off Summaries** بزنید. سپس دستگاه iOS قابلیت Health و فرمان `health.summary` را از مجموعه قابلیت‌های Node خود حذف می‌کند. همچنین می‌توانید `health.summary` را از
`gateway.nodes.commands.allow` حذف کنید تا سمت Gateway این مسیر دسترسی نیز بسته شود.

## عیب‌یابی

### فرمان توسط Node اعلام نشده است

مطمئن شوید خلاصه‌های Apple Health در برنامه iOS فعال هستند و دستگاه متصل است. `openclaw nodes pending` را اجرا کنید و هرگونه به‌روزرسانی قابلیت را تأیید کنید، سپس دوباره `openclaw nodes describe --node "<iOS device name>"` را بررسی کنید.

### فرمان به فعال‌سازی صریح نیاز دارد

`health.summary` را به `gateway.nodes.commands.allow` اضافه کنید. همچنین بررسی کنید که
`gateway.nodes.commands.deny` شامل آن نباشد؛ فهرست منع‌شده اولویت دارد.

### `HEALTH_ACCESS_DISABLED`

کلید اشتراک‌گذاری در برنامه خاموش است. **Apple Health Summaries** را در مسیر
**Settings -> Permissions -> Apple Health** روی دستگاه iOS فعال کنید.

### خلاصه با موفقیت دریافت می‌شود، اما معیارها وجود ندارند

برنامه Health مربوط به Apple را باز کنید و مطمئن شوید برای امروز داده‌ای وجود دارد. دسترسی OpenClaw را در تنظیمات Health مربوط به Apple بررسی کنید، اما نتیجه خالی را دلیل ردشدن دسترسی تلقی نکنید: HealthKit عمداً این تفاوت را پنهان می‌کند.

### بازه‌های قدیمی‌تر ناموفق هستند

این فرمان فقط `{"period":"today"}` را می‌پذیرد. خلاصه‌های چندروزه و تاریخی پشتیبانی نمی‌شوند.

## مرتبط

- [برنامه iOS](/fa/platforms/ios)
- [Nodeها](/fa/nodes)
- [مرجع پیکربندی Gateway](/fa/gateway/configuration-reference#gateway)
- [ممیزی امنیتی](/fa/gateway/security)