Slack - Lukan Agent

The Slack plugin connects Lukan to your Slack workspace using Socket Mode — no public URL needed.

Setup

1. Create a Slack App

Go to api.slack.com/apps and create a new app
In OAuth & Permissions, add bot scopes: chat:write, app_mentions:read, channels:history, im:history, groups:history
In Socket Mode, enable it and create an App-Level Token with connections:write scope
In Event Subscriptions, subscribe to app_mention and message.im
Install the app to your workspace

2. Configure in Lukan

lukan plugin install slack
lukan sk config set botToken "xoxb-YOUR-BOT-TOKEN"
lukan sk config set appToken "xapp-YOUR-APP-TOKEN"
lukan plugin start slack

Configuration

Field	Description
`botToken`	Bot User OAuth Token (`xoxb-...`)
`appToken`	App-Level Token for Socket Mode (`xapp-...`)
`allowedChannels`	Channel IDs where the bot responds (empty = everywhere)
`allowedUsers`	User IDs allowed to interact (empty = all)
`prefix`	Command prefix filter

Pipeline Approvals

Slack works as a notification channel for approval gates. You can use:

Channel ID (C01ABC123) — sends to the channel
User ID (U01XYZ789) — sends a DM to the user

To find IDs: right-click the channel or user in Slack and select Copy Link or View Details.