docs(imessage): call out includeAttachments off-by-defaul...
omarshahine
·
2026-05-09
·
via Recent Commits to openclaw:main
| Original file line number | Diff line number | Diff line change |
|---|
@@ -92,7 +92,7 @@ iMessage and BlueBubbles share a lot of channel-level config. The keys that chan
|
92 | 92 | | `channels.bluebubbles.groupAllowFrom` | `channels.imessage.groupAllowFrom` | Same. | |
93 | 93 | | `channels.bluebubbles.groups` | `channels.imessage.groups` | **Copy this verbatim, including any `groups: { "*": { ... } }` wildcard entry.** Per-group `requireMention`, `tools`, `toolsBySender` carry over. With `groupPolicy: "allowlist"`, an empty or missing `groups` block silently drops every group message — see "Group registry footgun" below. | |
94 | 94 | | `channels.bluebubbles.sendReadReceipts` | `channels.imessage.sendReadReceipts` | Default `true`. With the bundled plugin this only fires when the private API probe is up. | |
95 | | -| `channels.bluebubbles.includeAttachments` | `channels.imessage.includeAttachments` | Same. | |
| 95 | +| `channels.bluebubbles.includeAttachments` | `channels.imessage.includeAttachments` | Same shape, **same off-by-default**. If you had attachments flowing on BlueBubbles you must re-set this explicitly on the iMessage block — it does not carry over implicitly, and inbound photos/media will be silently dropped with no `Inbound message` log line until you do. | |
96 | 96 | | `channels.bluebubbles.attachmentRoots` | `channels.imessage.attachmentRoots` | Local roots; same wildcard rules. | |
97 | 97 | | _(N/A)_ | `channels.imessage.remoteAttachmentRoots` | Only used when `remoteHost` is set for SCP fetches. | |
98 | 98 | | `channels.bluebubbles.mediaMaxMb` | `channels.imessage.mediaMaxMb` | Default 16 MB on iMessage (BlueBubbles default was 8 MB). Set explicitly if you want to keep the lower cap. | |
|
| Original file line number | Diff line number | Diff line change |
|---|
@@ -403,7 +403,7 @@ See [ACP Agents](/tools/acp-agents) for shared ACP binding behavior.
|
403 | 403 | |
404 | 404 | <AccordionGroup> |
405 | 405 | <Accordion title="Attachments and media"> |
406 | | -- inbound attachment ingestion is optional: `channels.imessage.includeAttachments` |
| 406 | +- inbound attachment ingestion is **off by default** — set `channels.imessage.includeAttachments: true` to forward photos, voice memos, video, and other attachments to the agent. With it disabled, attachment-only iMessages are dropped before reaching the agent and may produce no `Inbound message` log line at all. |
407 | 407 | - remote attachment paths can be fetched via SCP when `remoteHost` is set |
408 | 408 | - attachment paths must match allowed roots: |
409 | 409 | - `channels.imessage.attachmentRoots` (local) |
|
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。
