Terminal
Terminal/Skill
Guides building and debugging Letta Code channel plugins that connect agents to Telegram, Slack, Discord and similar chat apps.
By Letta
Works with
npx skills add letta-ai/skills --skill creating-letta-code-channelsUse this when adding or debugging Letta Code channel support.
~/.letta/channels/<id>/) for headless experiments, community plugins, and fast workflow tests.src/channels/<id>/) when the channel needs bespoke Desktop UI, custom account snapshots, Slack/Discord-style auto-routing, rich protocol fields, or migration/compatibility shims.User plugins cannot shadow first-party ids: telegram, slack, and discord are ignored under ~/.letta/channels/. Use ids like telegram-test, whatsapp-community, or custom-chat.
~/letta/letta-code or a worktree.src/channels/README.md on branches with dynamic plugins.~/.letta/channels/<id>/channel.json~/.letta/channels/<id>/plugin.mjs~/.letta/channels/<id>/accounts.jsonmessageActions if agents should reply via MessageChannel.dmPolicy: "pairing" for testing, or allowlist/open for known headless deployments.adapter.onMessage(msg) to route/pairingMessageChannel calls messageActions.handleAction → adapter.sendMessagebun run typecheck, bun run lint, bun run build.Read only what is needed:
references/user-plugins.md — dynamic plugin manifest/account/runtime/headless flow and gotchas.references/first-party-channels.md — first-party channel file cascade and safety checks.references/testing.md — smoke-test checklist and commands.Use the bundled scaffold for a minimal user plugin skeleton. Replace <path-to-this-skill> with this skill directory path:
npx tsx <path-to-this-skill>/scripts/scaffold-user-channel-plugin.ts \
my-channel "My Channel" \
--runtime-package some-sdk@1.0.0 \
--runtime-module some-sdk
It creates channel.json, plugin.mjs, and accounts.example.json. Replace the TODO inbound/outbound implementation with the real SDK calls.
MessageChannel silently feels broken if plugin.messageActions is missing. Every plugin that should reply needs describeMessageTool() and handleAction().approve replies.node_modules. Runtime modules should resolve from explicit runtime dirs only.letta channels pair --channel <id> --code <code> --agent <agent-id> --conversation <conversation-id>.pairing.yaml and routing.yaml on the next inbound miss; restart only when adapter/account config itself changed.