Add GitHub Channel (NanoClaw)
Installs and configures the GitHub channel adapter so a NanoClaw agent can converse inside PR and issue comment threads.
AutomationAdvanced★ 30,573⑂ 12,843AI score 8/10Last updated: Aug 20, 2026
What it does
- Copies the GitHub adapter (
src/channels/github.ts) from thechannelsbranch and appends the single self-registration import tosrc/channels/index.ts. - Installs
@chat-adapter/githubat an exact pinned version, then runspnpm run buildand a registration test withvitestto prove the channel is really wired. - Prompts for and writes three secrets to
.env(bot fine-grained PAT, webhook secret, bot username) without overwriting existing values. - Creates messaging groups, wirings and members through
ncl, choosingunknown_sender_policypublicfor private repos orstrictfor public repos, withper-threadsession isolation. - Ships a troubleshooting section for 401/403 token issues, red webhook deliveries and @-mentions that never fire.
Who it's for
- Teams self-hosting NanoClaw who want an agent replying in GitHub PRs and issues.
- Platform/DevOps engineers turning GitHub comment threads into agent conversations.
- Anyone operating multiple repos that need isolated per-thread agent sessions.
Examples
- "Add the GitHub channel to our backend repo" → adapter copy, dependency install, build and registration test all run in order.
- Public repo setup: apply
strictpolicy, resolve trusted users withgh api users/<username> --jq .id, then add them as members. - Webhook returning 401: verify the form secret matches
GITHUB_WEBHOOK_SECRETand use Redeliver to retest without a new comment.
· · · 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-github/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-github folder from the GitHub repo nanocoai/nanoclaw into my ~/.claude/skills/add-github/. 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-github ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal and clone the repository:
git clone https://github.com/nanocoai/nanoclaw.git - Copy the skill into your Claude skills folder:
mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-github ~/.claude/skills/ - Prerequisite: create a dedicated GitHub bot account (not your personal one) and invite it as a collaborator with write access to the repos you want monitored.
- Signed in as the bot, create a fine-grained PAT with Pull requests and Issues set to Read & Write (Settings → Developer Settings → Personal Access Tokens).
- Add a webhook on each repo: Payload URL
https://your-domain/webhook/github, content typeapplication/json, secret fromopenssl rand -hex 20, events = Issue comments + Pull request review comments. - Run Claude Code from your NanoClaw project root and ask it to "add the GitHub channel"; paste the token, webhook secret and bot username when prompted.
- Confirm
pnpm run buildand the registration test pass, create the messaging group/wiring withncl(the host service must be running), then restart the service (launchctl kickstarton macOS,systemctl --user restarton Linux). - From a different account, mention
@your-bot-usernamein a PR comment and verify the agent replies.
View source on GitHub ↗License: MIT