The two tokens

A Socket Mode app uses two tokens, and Kura-chan needs both.

Token	Looks like	What it’s for
Bot token	xoxb-…	The bot’s identity — posting messages, reading files, running commands
App-level token	xapp-…	The Socket Mode connection itself (scope connections:write)

You generate them in two different places in the Slack app settings. Do this right after creating the app.

1 · Generate the App-level token (xapp-…)

1. In your app, open Settings → Basic Information.
2. Scroll to App-Level Tokens → Generate Token and Scopes.
3. Give it any name (e.g. socket), add the connections:write scope, and Generate.
4. Copy the xapp-… value. It’s shown only once — keep the tab open until you’ve pasted it.

2 · Install the app and copy the Bot token (xoxb-…)

1. Open Settings → Install App.
2. Click Install to your workspace and approve the permissions.
3. Copy the Bot User OAuth Token — the value starting xoxb-….

Re-install after changing scopes

If you ever add a scope later (e.g. via the manual checklist), Slack invalidates the bot token until you reinstall the app and copy the new xoxb-….

3 · Paste both tokens into Kura-chan

In the dashboard, go to Channels → Slack:

1. Paste the Bot token into the xoxb-… field.
2. Paste the App-level token into the xapp-… field.
3. Click Connect. On success the panel shows your workspace name and the bot handle.

Note

Both tokens are secrets — they let anything act as your bot. Don’t commit them to git or share them. Disconnecting in the dashboard clears them.

Once connected, Verify & troubleshooting confirms it actually works.