# Setup Slack Channel

Use for the PROVIDER half of getting a locally running CopilotKit Channels agent to...

- Repository: https://github.com/CopilotKit/CopilotKit (38452 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add CopilotKit/CopilotKit --skill setup-slack-channel -g -a claude-code -y`
Codex: `npx skills add CopilotKit/CopilotKit --skill setup-slack-channel -g -a codex -y`
Cursor: `npx skills add CopilotKit/CopilotKit --skill setup-slack-channel -g -a cursor -y`
Gemini CLI: `npx skills add CopilotKit/CopilotKit --skill setup-slack-channel -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add CopilotKit/CopilotKit`

## Description

Use for the PROVIDER half of getting a locally running CopilotKit Channels agent to answer in Slack, when no Slack app exists yet, setting up a Channels bot in Slack for the first time, creating the Slack app and its tokens, attaching it to a managed Intelligence Channel, or when a Channel reports setup_required, sits at "Waiting for runtime", the Channel is Online but a Slack mention gets no reply, or a Slack app was built with Socket Mode instead of an Intelligence Request URL. Scoped to an OpenTag checkout, or the OpenTag example inside a channels-sdk clone, the phases assume those conventions (app/channel.tsx, app/env.ts, INTELLIGENCE_CHANNEL_NAME, a local agent on port 8123) and do not describe a project scaffolded by copilotkit init, which already ships its own channel host. If the Slack app and Channel already exist and the question is about declaring or customising the Channel in code, use the copilotkit-channels skill instead.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Set up a Slack Channel for a local Channels agent

Take a developer from a code checkout to a working local Slack agent. **Five
separate systems** have to line up, and they are owned by four different parties:

| System                                                | Who owns it                   | Where you work on it                     |
| ----------------------------------------------------- | ----------------------------- | ---------------------------------------- |
| Slack workspace                                       | Workspace owner / app manager | Slack, in a browser                      |
| Slack app + its tokens                                | The developer                 | api.slack.com, in a browser              |
| Intelligence project, API key, Channel, Slack adapter | The developer                 | The Intelligence dashboard, in a browser |
| Local Channels runtime                                | The developer                 | This repo, in the shell                  |
| AG-UI agent backend                                   | The developer                 | This repo, in the shell                  |

## How delivery actually works, two legs, two mechanisms

Getting this wrong is the most expensive mistake available here, because a
misconfigured Slack app installs cleanly and answers nothing.

The rest: https://github.com/CopilotKit/CopilotKit/blob/HEAD/skills/setup-slack-channel/SKILL.md