slack-agent-flow

Provisions new agents as dedicated Slack bots with operator DMs and shared rooms.

30.7k|12.8k|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/nanocoai/nanoclaw --skill slack-agent-flow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: slack-agent-flow
Source: https://github.com/nanocoai/nanoclaw/tree/main/.claude/skills/slack-agent-flow
Command: npx skills add https://github.com/nanocoai/nanoclaw --skill slack-agent-flow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Creating a new agent inside NanoClaw normally leaves it reachable only through internal messaging; this Skill makes each new agent arrive in Slack as its own bot, with a provisioned Slack app, an operator DM, and a shared multi-agent room, all without restarting the host.

Core Features & Use Cases

  • Automated Slack app provisioning: Creates a Slack app per agent via a managed broker or workspace manager token, writes tokens to .env, and hot-starts the adapter in the running host.
  • Room orchestration: Adds create_room and add_to_room agent-facing actions so teams of agents share one MPIM room with pairwise agent-to-agent destinations and a canvas contract tab.
  • Resumable failure handling: Any failed Slack leg reports the exact step and can be finished idempotently with the bundled finish script; workspace install approvals are polled and parked apps resume on the next request.
  • Use Case: Tell your existing Slack agent "create an agent called Research" and within seconds a new bot appears in your workspace with its own DM and a three-way room connecting you, the origin bot, and the new bot.

Quick Start

Ask your Slack-connected agent to create a new agent by name, for example "create an agent called Research", and approve the provisioning prompt when it appears.

Frequently Asked Questions about slack-agent-flow

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

FAQPage Schema
How do I create a new agent that appears as its own Slack bot?

Ask any Slack-wired agent to create one, for example "create an agent called Research". The flow provisions a Slack app, opens an operator DM, opens a shared three-way room, and hot-starts the new bot's adapter without restarting the host.

How do I create a team of agents in one Slack room?

Create each agent with room set to 'none' so no per-agent room opens, then call create_room once naming all of them. This produces a single shared MPIM room instead of N separate three-way rooms.

What credentials are required for automatic Slack app provisioning?

Provisioning needs either NANOCLAW_INSTALL_TOKEN for the managed broker or SLACK_MANAGER_TOKEN for direct workspace-level app creation in .env. Without one, agent creation still works but the Slack leg reports no-credentials and points at the finish script.

What happens when my Slack workspace requires admin approval for app installs?

The flow posts the install approval link in the originating conversation and polls the broker for up to five minutes. On timeout the app parks with its tokens in .env, and asking for the same agent again resumes that same app rather than provisioning a second one.

How do I recover when the Slack setup of a new agent fails partway?

Run pnpm exec tsx scripts/slack-agent-flow-finish.ts with the new agent's group id, slug, and source group id. The script re-runs every step idempotently, reusing existing tokens and rows, and can restart the service with the --restart flag.

Does create_agent behave differently outside Slack sessions?

No. Non-Slack sessions such as Telegram or CLI run the upstream create_agent behavior byte-for-byte with zero Slack side effects. The Slack provisioning leg only activates when the request originates from a Slack-channel session.