Add iMessage Channel (NanoClaw)

A guided installer that wires an iMessage channel into NanoClaw using either a local Mac chat.db bridge or a hosted photon.codes line.

AutomationIntermediate★ 30,573⑂ 12,843AI score 8/10Last updated: Aug 20, 2026

What it does

Registers a single imessage channel in NanoClaw with two swappable backends: local (reads this Mac's signed-in chat.db via chat-adapter-imessage) or hosted (a managed line over Photon's spectrum-ts gRPC stream, no Mac required).
Copies the adapter plus its tests from the channels branch and appends the single self-registration import to src/channels/index.ts.
Installs exactly one pinned package per backend, respecting the repo's supply-chain policy (no ranges, no @latest).
Walks you through macOS Full Disk Access, or the hosted device-login wizard with E.164 number registration and the required first inbound text.
Ends with a build, a registration test, a service restart, and a troubleshooting matrix.

Who it's for

NanoClaw operators who want to chat with their agent from iMessage.
Non-Mac users who still want an iMessage line through a hosted provider.
Anyone who has botched a manual adapter install and wants deterministic, re-runnable steps.

Examples

Say "connect imessage" — the skill asks for a backend, then hard-stops the local path with a uname check if you're not on macOS.
Pick hosted — it prints a login URL and code, registers your +1415… number, shows the assigned iMessage line, and waits for your first text to opt you in.
Channel installed but silent — run pnpm exec vitest run src/channels/imessage-registration.test.ts, grep Photon channel connected in logs/nanoclaw.log, then restart with bash setup/lib/restart.sh.

· · · Install guide · · ·

Try it now, no install

Paste this into Claude to use the skill without installing anything.

Read the instructions in this file and follow them to help me:
https://raw.githubusercontent.com/nanocoai/nanoclaw/HEAD/.claude/skills/add-imessage/SKILL.md

What I want: (describe your task here)

If Claude can't open the link, open it yourself and paste the contents instead.

↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.

Install in the Claude app (no terminal)

Download the ZIP with the button below.
In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.

↓ Download ZIP

Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on AI Skill Mart.
Copy the .claude/skills/add-imessage folder from the GitHub repo nanocoai/nanoclaw into my ~/.claude/skills/add-imessage/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/nanocoai/nanoclaw.git && cd nanoclaw && mkdir -p ~/.claude/skills && cp -r .claude/skills/add-imessage ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

Open a terminal and clone the repo: git clone https://github.com/nanocoai/nanoclaw.git
Enter the project and install dependencies: cd nanoclaw && pnpm install
Optionally copy the skill to your personal folder: mkdir -p ~/.claude/skills && cp -r .claude/skills/add-imessage ~/.claude/skills/ (running Claude Code inside the repo already picks it up).
Start claude from the project directory and ask: "add imessage".
Choose your backend: local (macOS only) or hosted (any OS).
For local, grant Full Disk Access to the node binary in System Settings > Privacy & Security.
For hosted, approve the device at the printed login URL, enter your phone number in +E.164 format, and text the assigned iMessage number once.
Confirm the build, the registration test, and bash setup/lib/restart.sh all finish cleanly before moving on to /init-first-agent.

View source on GitHub ↗License: MIT