@meetopenbot/slack

Slack specialist agent for OpenBot: Events API ingress, simple LLM replies, and thread delivery.

Features (MVP)

• Ingress — verify Slack webhooks, dedupe events, prefetch thread/channel context, turn messages into agent:invoke
• Agent — OpenAI + Slack MCP tools (post_message, list_channels, etc.)
• Egress — post inbound-thread replies via chat.postMessage

Setup

1. Create a Slack app with bot scopes:

   • app_mentions:read, chat:write, channels:history, users:read
   • For private channels: groups:history (bot must be invited)
   • For DMs: im:history, im:read, im:write

2. Add the plugin to ~/.openbot/agents/slack/AGENT.md:

plugins:
  - id: "@meetopenbot/slack"
    config:
      signingSecret: your-signing-secret
      botToken: xoxb-your-bot-token
      teamId: T01234567
      authMode: credits
      model: openai/gpt-4o-mini
      channelMappings: "C01234567:engineering,C89ABCDEF:support"

On cloud, authMode: credits uses your workspace credit balance. For BYOK (bring your own key), set authMode: byok and add OPENAI_API_KEY under workspace settings — no API key field in plugin config.

Channel routing (webhook ingress)

When a Slack message arrives via the Events API webhook, the plugin delegates to the OpenBot system agent in a target channel. Set channelMappings as comma-separated slackChannelId:openbotChannelId pairs:

C01234567:engineering,C89ABCDEF:support,D0789ABC:slack-dms

• Left side — Slack channel id (C… for channels, D… for DMs). In Slack: right-click the channel → View channel details → copy the id at the bottom.
• Right side — OpenBot channel id to run in (must already exist).

Slack channels without a mapping route to uncategorized.

This applies only to webhook ingress delegation, not Slack MCP tools.

3. Point Slack Event Subscriptions request URL to:

https://<your-host>/api/webhooks/slack

4. Subscribe to app_mention for channel mentions. Add message.im only if you want DMs.

   Do not subscribe to message.channels or message.groups — that causes duplicate replies alongside app_mention.

Build

pnpm install
pnpm build

Restart the OpenBot runtime to load the plugin.