Add Emacs Channel (NanoClaw)
Wires an Emacs channel into NanoClaw so you can chat with your agent from a buffer or straight inside org-mode.
Dev & CodingAdvanced★ 30,471⑂ 12,865AI score 7/10Last updated: Aug 9, 2026
What it does
Installs an Emacs channel adapter into a NanoClaw checkout using a local HTTP bridge (default port 8766) — no bot token, no external service. Works with Doom Emacs, Spacemacs and vanilla Emacs 27.1+.
- Pulls
emacs.tsplus thenanoclaw.elLisp client from thechannelsbranch - Adds the self-registration import, builds, and runs the registration integration test
- Covers
.envsetup (EMACS_ENABLED, port, optional bearer token) and messaging-group wiring commands - Per-distribution keybinding snippets, curl/log verification, and troubleshooting for port clashes, 401s and load failures
- Includes a markdown → org-mode conversion table for agent output
Who it's for
- Developers self-hosting NanoClaw who want another channel
- People who live inside Emacs and don't want to switch to a browser
- org-mode note takers who want answers landing directly in their outline
Examples
- Code review: select a region and run
nanoclaw-org-send; the reply appears as a child heading in your org file. - Meeting notes: send an org agenda entry and get a summary plus action items back as a child node.
- Debugging: open the chat buffer with
C-c n c, paste a stack trace and get an explanation without leaving Emacs.
· · · Install guide · · ·
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-emacs folder from the GitHub repo nanocoai/nanoclaw into my ~/.claude/skills/add-emacs/. 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-emacs ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Clone the NanoClaw repo locally and confirm the service already runs.
- Install the skill:
git clone https://github.com/nanocoai/nanoclaw.git && cp -r nanoclaw/.claude/skills/add-emacs ~/.claude/skills/ - Start Claude Code in your NanoClaw project root and ask it to "add the Emacs channel".
- Follow the steps:
git fetch origin channels→ copy the adapter andnanoclaw.el→ appendimport './emacs.js';tosrc/channels/index.ts→pnpm run build. - Add
EMACS_ENABLED=trueto.env(plus port andEMACS_AUTH_TOKENif you want auth). - Wire a messaging group with
/init-first-agentor theregistercommand. - Add the
nanoclaw.elload line and keybindings to your Emacs config, then reload it. - Restart NanoClaw and verify with
curl http://localhost:8766/api/messages?since=0and a message from the Emacs chat buffer.
View source on GitHub ↗License: MIT