add-deltachat

Integrates a DeltaChat email-based messaging channel into NanoClaw via the stdio-rpc-server adapter.

2|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/RADHA0-max/selfhealbackend --skill add-deltachat-radha0-max
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-deltachat
Source: https://github.com/RADHA0-max/selfhealbackend/tree/main/nanoclaw/.claude/skills/add-deltachat
Command: npx skills add https://github.com/RADHA0-max/selfhealbackend --skill add-deltachat-radha0-max

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @deltachat/stdio-rpc-server.

What problem does it solve? Setting up an end-to-end encrypted messaging channel for a NanoClaw bot requires copying adapter code, registering it, installing a pinned package, configuring IMAP/SMTP credentials, and wiring chats to agents — a multi-step process that is easy to get wrong. This Skill walks through the entire DeltaChat channel installation, credential setup, and chat wiring with idempotent, verifiable steps. ## Core Features & Use Cases - Guided adapter installation: Copies the DeltaChat adapter and its registration test from the channels branch, appends the self-registration import, installs the pinned @deltachat/stdio-rpc-server package, and validates with a build plus integration test. - Credential and account setup: Documents all required DC_* environment variables, IMAP/SMTP security modes, and optional settings like account directory, display name, and avatar. - Chat wiring and troubleshooting: Explains the SecureJoin invite-link flow for DMs, group wiring via ncl or /manage-channels, and provides diagnostics for common failures like missing credentials, configure errors, and stale lock files. - Use Case: You want your NanoClaw agent reachable over encrypted email-based messaging. Follow the Skill to install the adapter, add credentials, restart the service, share the invite link, and wire the resulting chat to an agent group. ## Quick Start Ask the assistant to add the DeltaChat channel to NanoClaw and it will copy the adapter, install the package, configure credentials, and guide you through wiring your first chat.

Frequently Asked Questions about add-deltachat

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

FAQPage Schema
How do I add a DeltaChat channel to NanoClaw?

Copy the deltachat adapter and registration test from the channels branch, add the self-registration import to src/channels/index.ts, install @deltachat/[email protected], then build and run the registration test. Finally add DC_* credentials to .env and restart the service.

How do users connect to a DeltaChat bot?

DeltaChat contacts cannot be added by email alone; users must open the bot's invite link or scan its QR code to trigger the SecureJoin handshake. The adapter logs the invite URL and writes a QR SVG to dc-account/invite-qr.svg on every startup.

What email providers work with DeltaChat bots?

Not all providers work well with DeltaChat, so check https://providers.delta.chat/ before choosing one. A dedicated email account is recommended since it accumulates DeltaChat-formatted messages and stores encryption keys.

Why is the DeltaChat adapter not starting in NanoClaw?

The most common cause is missing credentials: all six required variables (DC_EMAIL, DC_PASSWORD, DC_IMAP_HOST, DC_IMAP_PORT, DC_SMTP_HOST, DC_SMTP_PORT) must be present in .env. Check logs for 'Channel credentials missing' entries mentioning deltachat.

Does the DeltaChat channel support threads, reactions, or message editing?

No. DeltaChat has no thread model, and the adapter does not support reactions, message editing or deletion, or read receipts. It does support file attachments, avatar setting via /set-avatar, and a connectivity watchdog.

How do I fix a stale DeltaChat lock file after a crash?

Delete dc-account/accounts.lock and restart the service with systemctl --user restart using the unit name from setup/lib/install-slug.sh. The account is already configured, so IO restarts automatically on service start.