Skip to content

Comments

docs(imessage): macOS TCC troubleshooting#10761

Merged
sebslight merged 1 commit intoopenclaw:mainfrom
gitpds:docs/imessage-tcc-troubleshooting
Feb 7, 2026
Merged

docs(imessage): macOS TCC troubleshooting#10761
sebslight merged 1 commit intoopenclaw:mainfrom
gitpds:docs/imessage-tcc-troubleshooting

Conversation

@gitpds
Copy link
Contributor

@gitpds gitpds commented Feb 6, 2026

Adds a short troubleshooting section for common macOS Privacy & Security (TCC) prompts that can cause imsg/OpenClaw to fail or appear to hang when run headless (Full Disk Access + Automation → Messages), plus a note about Desktop/Documents/Downloads folder gating for local file reads.

Greptile Overview

Greptile Summary

  • Adds a new “Troubleshooting: macOS Privacy & Security (TCC)” section to the legacy iMessage (imsg) channel docs.
  • Documents common macOS permissions that can block/hang imsg in headless setups: Full Disk Access (Messages DB) and Automation → Messages (outbound sends).
  • Provides one-time interactive commands (imsg chats, imsg send) to trigger/approve TCC prompts.
  • Notes macOS folder-gating for Desktop/Documents/Downloads when the agent needs to read local files.

Confidence Score: 5/5

  • This PR is safe to merge with minimal risk.
  • Changes are documentation-only, scoped to a single channel guide, and do not alter runtime behavior. The troubleshooting guidance is consistent with how macOS TCC permissions affect imsg/Messages DB access and headless workflows.
  • No files require special attention

(2/5) Greptile learns from your feedback when you react with thumbs up/down!

@openclaw-barnacle openclaw-barnacle bot added docs Improvements or additions to documentation channel: imessage Channel integration: imessage labels Feb 6, 2026
@sebslight sebslight merged commit fe308a3 into openclaw:main Feb 7, 2026
24 of 27 checks passed
@sebslight
Copy link
Member

Landed via rebase merge onto main.\n\n- Gate: pnpm lint && pnpm build && pnpm test\n- PR head commit: 37dbd15\n- Merge commit: fe308a3\n\nThanks @gitpds!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

channel: imessage Channel integration: imessage docs Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants