Use LobeHub on Slack

Slack works in two phases: a workspace admin installs the official LobeHub Slack app once, and then each member links their personal LobeHub account. Both phases happen from Settings → Messenger → Slack.

Prerequisites

• A LobeHub account
• A Slack workspace
• For the install step: permission to install Slack apps in that workspace (typically Workspace Admin or a permission granted by one)

Phase A — Install the LobeHub Slack app (admin, once per workspace)

<Steps> ### Open Settings → Messenger → Slack

In LobeHub, open Settings → Messenger and click the Slack card. Click Connect in the top-right.

Authorise in Slack

You'll be redirected to Slack's authorisation screen. Pick the workspace you want to install into and click Allow.

Workspace appears under Connections

After approval you're redirected back to LobeHub. The workspace shows up as a workspace row in Connections, with a status of Connected.

Workspace already connected by someone else? LobeHub blocks the install and shows a "Workspace already connected" notice. You don't need to install again — just DM @LobeHub in Slack to link your personal account. If you want to take over ownership, ask the original installer to disconnect the workspace first.

</Steps>

Phase B — Link your personal account (each member)

<Steps> ### Open the LobeHub bot in Slack

In Slack, open the Apps sidebar and find LobeHub, or search for @LobeHub. Open a DM with the bot.

Send any message

Send any message to the bot to trigger the linking flow. The bot replies with a one-time confirmation link.

Confirm the link in your browser

Tap the link, sign in to LobeHub if asked, and choose a default agent. Every message you DM the bot in this workspace will route to this agent.

Your link appears as a user row under the workspace install in Connections. </Steps>

Switching the Active Agent

Two equivalent ways:

• In Slack — DM the bot /agents and pick a different agent.
• In LobeHub — open Settings → Messenger → Slack and use the agent picker on your link row.

The change takes effect on the next message you send.

Disconnecting

Slack has two distinct disconnect actions:

Action	Effect
Disconnect on a user row	Unlinks your LobeHub account from your Slack account in this workspace. Your inbound DMs stop until you message the bot and link again.
Disconnect on a workspace row	Removes the workspace install. The bot is frozen for everyone in that workspace because dispatch is token-gated — existing user links remain on file but pause until the workspace is re-installed.

You can re-install (workspace) or re-link (personal) at any time by repeating the relevant phase.

Troubleshooting

• "Workspace already connected" — Another LobeHub user already installed the app to this workspace. DM @LobeHub to link your personal account; you do not need to install again. To take over ownership, ask the original installer to disconnect first.
• Slack install failed (<reason>) — Common reasons: authorisation cancelled, install session expired (re-open the modal and try again), Slack returned incomplete data (retry; if persistent, contact support).
• Bot does not reply to your DM — The workspace install may have been disconnected. Check Settings → Messenger → Slack for a workspace row; if missing, ask an admin to re-install.
• "This link is already used" — One-time confirmation links expire after one use. DM the bot again to get a new link.
• "This account is already linked" — Your Slack account is bound to a different LobeHub account. Sign in to that LobeHub account to manage the link, or unlink there before retrying.
• "Another Slack account is already linked" — Your LobeHub account already has a Slack link in this workspace. Disconnect it in Settings → Messenger → Slack before linking a new Slack account.