Files

gavrielc 57a6491c7e v2: channel isolation model, manage-channels skill, refactored channel skills

- Add three-level isolation model (shared session, same agent, separate agent)
  with agent-shared session mode for cross-channel shared sessions
- Create /manage-channels skill for wiring channels to agent groups
- Refactor all 12 v2 channel skills: lean SKILL.md + VERIFY.md + REMOVE.md
  with structured Channel Info section for platform-specific metadata
- Create /add-discord-v2 skill (was missing)
- Add step 5a to setup SKILL.md invoking /manage-channels after channel install
- Update setup/verify.ts to check all 12 channel token types
- Add docs/v2-isolation-model.md explaining the isolation model
- Update v2-checklist.md and v2-setup-wiring.md to reflect completed work

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-04-09 13:19:19 +03:00

2.3 KiB

Raw Blame History

name, description

name	description
add-slack-v2	Add Slack channel integration to NanoClaw v2 via Chat SDK.

Add Slack Channel

Adds Slack support to NanoClaw v2 using the Chat SDK bridge.

Pre-flight

Check if src/channels/slack.ts exists and the import is uncommented in src/channels/index.ts. If both are in place, skip to Credentials.

Install

Install the adapter package

npm install @chat-adapter/slack

Enable the channel

Uncomment the Slack import in src/channels/index.ts:

import './slack.js';

Build

npm run build

Credentials

Create Slack App

Go to api.slack.com/apps and click Create New App > From scratch
Name it (e.g., "NanoClaw") and select your workspace
Go to OAuth & Permissions and add Bot Token Scopes:
- chat:write, channels:history, groups:history, im:history, channels:read, groups:read, users:read, reactions:write
Click Install to Workspace and copy the Bot User OAuth Token (xoxb-...)
Go to Basic Information and copy the Signing Secret
Go to Event Subscriptions, enable events, and subscribe to:
- message.channels, message.groups, message.im, app_mention
Set the Request URL to your webhook endpoint (e.g., https://your-domain/webhook/slack)

Configure environment

Add to .env:

SLACK_BOT_TOKEN=xoxb-your-bot-token
SLACK_SIGNING_SECRET=your-signing-secret

Sync to container: mkdir -p data/env && cp .env data/env/env

Next Steps

If you're in the middle of /setup, return to the setup flow now.

Otherwise, run /manage-channels to wire this channel to an agent group.

Channel Info

type: slack
terminology: Slack has "workspaces" containing "channels." Channels can be public (#general) or private. The bot can also receive direct messages.
how-to-find-id: Right-click a channel name > "View channel details" — the Channel ID is at the bottom (starts with C). Or copy the channel link — the ID is the last segment of the URL.
supports-threads: yes
typical-use: Interactive chat — team channels or direct messages
default-isolation: Same agent group for channels where you're the primary user. Separate agent group for channels with different teams or sensitive contexts.

2.3 KiB Raw Blame History