add-imessage

Add iMessage channel integration to NanoClaw fleets for agent messaging.

5|Updated Apr 2, 2026

Search Tags:#setup #imessage #nanoclaw #channel-integration #local-mode #photon-api #remote-mode

Ready to run

npx skills add https://github.com/thmtz/nanoclaw-fleet --skill add-imessage-thmtz

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: add-imessage
Source: https://github.com/thmtz/nanoclaw-fleet/tree/main/.claude/skills/add-imessage
Command: npx skills add https://github.com/thmtz/nanoclaw-fleet --skill add-imessage-thmtz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

NanoClaw needs a way to support messaging through iMessage as a channel, enabling operators to interact with agents from iMessage.

Core Features & Use Cases

Local macOS mode with Full Disk Access for iMessage integration
Remote mode via Photon API for iMessage chat connectivity
Use cases include interactive 1:1 conversations with agents from iMessage and coordinated channel wiring to agent groups

Quick Start

Follow the setup flow to enable the iMessage channel in either local macOS or remote Photon API mode.

Frequently Asked Questions about add-imessage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I set up iMessage integration for an agent fleet?▼

To set up iMessage integration, install the chat-adapter-imessage package, configure the IMESSAGE_ENABLED environment variable, then build and run the agent container to enable interactive messaging.

Does iMessage integration require a local macOS deployment?▼

iMessage integration does not strictly require local macOS. You can use local mode with Full Disk Access or configure remote mode using the Photon API with IMESSAGE_SERVER_URL and IMESSAGE_API_KEY.

What environment variables are needed to connect iMessage to an agent?▼

Connecting iMessage requires IMESSAGE_ENABLED set to true, plus either IMESSAGE_LOCAL for local macOS mode or IMESSAGE_SERVER_URL and IMESSAGE_API_KEY for remote Photon API mode.

Why is my iMessage channel integration not working in NanoClaw?▼

iMessage channel integration fails if the iMessage adapter is missing, the chat-adapter-imessage package is uninstalled, or environment variables like IMESSAGE_ENABLED are not properly configured before running the container build.

Can I use iMessage to chat with agent groups?▼

You can use iMessage for interactive 1:1 conversations with agents and coordinate channel wiring to agent groups by enabling the integration through the local or remote Photon API setup.

What is remote mode for iMessage chat connectivity?▼

Remote mode enables iMessage chat connectivity through the Photon API. It requires configuring IMESSAGE_SERVER_URL and IMESSAGE_API_KEY environment variables instead of running a local macOS deployment with Full Disk Access.