add-slack

Add Socket Mode Slack integration with channel handlers to NanoClaw.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/theowenyoung/nanoclaw --skill add-slack-theowenyoung
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-slack
Source: https://github.com/theowenyoung/nanoclaw/tree/main/.claude/skills/add-slack
Command: npx skills add https://github.com/theowenyoung/nanoclaw --skill add-slack-theowenyoung

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Adds Slack as a first-class messaging channel for NanoClaw so agents can send and receive messages in Slack workspaces while preserving container-level isolation and avoiding exposing host services.

Core Features & Use Cases

  • Socket Mode Integration: Connects using Slack Socket Mode so no public inbound URL is required.
  • Channel, Private, and DM Support: Supports public channels, private channels, and direct messages with explicit channel registration.
  • Robust Messaging Behavior: Queues outgoing messages when disconnected, flushes on connect, splits long messages to respect Slack limits, detects bot messages, and caches user names to reduce API calls.
  • Developer-Friendly Package: Provides deterministic code changes (adds channel class, tests, and barrel import), a manifest for npm dependency hints, and detailed setup documentation for workspace configuration and OAuth scopes.
  • Use Case: Add Slack to receive operational alerts, enable agent-driven team interactions, or let Claude agents participate in workspace conversations alongside other channels like WhatsApp.

Quick Start

Inside the claude CLI run /add-slack, follow the interactive prompts to provide SLACK_BOT_TOKEN and SLACK_APP_TOKEN, register the Slack channel ID, then build and restart NanoClaw.

Frequently Asked Questions about add-slack

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

FAQPage Schema
How do I connect a Slack bot to a self-hosted agent without exposing a public URL?

Slack Socket Mode integration connects your bot to agents without requiring an inbound public URL, enabling secure message sending and receiving while preserving container-level isolation.

What Slack channel types can an automated bot interact with using Socket Mode?

Socket Mode Slack bots can interact with public channels, private channels, and direct messages, provided each channel is explicitly registered using its specific channel ID.

What tokens do I need to set up Slack Socket Mode for nodejs automation?

Setting up Slack Socket Mode requires both a SLACK_BOT_TOKEN and a SLACK_APP_TOKEN stored in your .env file, with Socket Mode enabled in the Slack app configuration.

How does a Slack bot handle long messages and API rate limits during automation workflows?

The Slack integration queues outgoing messages when disconnected, flushes them on reconnect, splits long messages to respect Slack limits, and caches user names to reduce API calls.

Can I use Slack alongside other messaging channels like WhatsApp for agent interactions?

Slack can be added as a first-class messaging channel alongside other platforms like WhatsApp, allowing Claude agents to participate in workspace conversations and receive operational alerts.

Why is my Slack bot not receiving messages after adding Socket Mode integration?

Slack Socket Mode requires explicit channel registration using the slack:<channel-id> format, valid tokens in .env, and a build and restart of NanoClaw to activate the handler.