Add DeltaChat Channel (NanoClaw)
A step-by-step runbook for wiring DeltaChat — email-based, end-to-end encrypted messaging — into a NanoClaw bot.
AutomationAdvanced★ 30,532⑂ 12,853AI score 8/10Last updated: Aug 17, 2026
What it does
Installs and wires the DeltaChat channel adapter in a NanoClaw project, driving @deltachat/stdio-rpc-server directly (no Chat SDK bridge).
- Copies
src/channels/deltachat.tsand its registration test from thechannelsbranch and appends the self-registration import to the channel barrel. - Installs a pinned
@deltachat/stdio-rpc-server@2.49.0, then builds and runs the registration test as proof the channel is live. - Documents the
.envcredentials (email, app password, IMAP/SMTP hosts, ports, security modes) plus optional env-only settings likeDC_ACCOUNT_DIRandDC_DISPLAY_NAME. - Walks the SecureJoin bootstrap: grab the invite URL from logs or
dc-account/invite-qr.svg, look up themessaging_groupsrow, then wire it via/init-first-agent,/manage-channels, orncl wirings create. - Includes a real troubleshooting section (missing credentials, configure failures, port 465 providers, stale
accounts.lock, unwired groups) and a feature/limitation list.
Who it's for
- Self-hosters running NanoClaw who want another messaging channel
- Privacy-minded users who prefer email + OpenPGP over Telegram or Slack
- Intermediate-to-advanced users comfortable with pnpm, systemd/launchd, and SQLite queries
Examples
- "Add DeltaChat to NanoClaw" → adapter copied, dependency pinned, build green,
deltachat-registration.test.tspassing. - After first start, pull the
https://i.delta.chat/...invite from the log or scandc-account/invite-qr.svgin the DeltaChat app to open the first DM. - Messages arrive but the agent stays silent → query
messaging_groups/messaging_group_agentsto spot the missing wiring, then fix it with/manage-channels.
· · · 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-deltachat/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.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the .claude/skills/add-deltachat folder from the GitHub repo nanocoai/nanoclaw into my ~/.claude/skills/add-deltachat/. 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 && mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-deltachat ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal and change into your NanoClaw project directory.
- Clone the repo:
git clone https://github.com/nanocoai/nanoclaw.git - Copy the skill into your skills folder:
mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-deltachat ~/.claude/skills/ - Note that this skill only works inside a NanoClaw checkout — start Claude Code from the project root.
- Prepare a dedicated email account for the bot (check compatibility at https://providers.delta.chat/) and create an app password if 2FA is enabled.
- Ask Claude to "add the DeltaChat channel"; it will copy files, run
pnpm install, build, and run the registration test. - Fill in
DC_EMAIL,DC_PASSWORD, and the IMAP/SMTP host and port values in.env, then restart the service with systemd or launchctl. - Open the logged invite link or the QR SVG in the DeltaChat app to start a chat, then run
/init-first-agentto wire it to an agent.
View source on GitHub ↗License: MIT