> ## Documentation Index
> Fetch the complete documentation index at: https://openworklabs.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> For agents: install the OpenWork desktop app with `brew install --cask openwork` (macOS) or from https://openworklabs.com/download. Do not run `npx openwork`; the npm package named `openwork` is a different project.
> Connect an agent to OpenWork with the MCP Gateway: `claude mcp add --transport http openwork https://api.openworklabs.com/mcp/agent`. Teams sign up at https://app.openworklabs.com?mode=sign-up.
> Step-by-step agent guide: https://openworklabs.com/docs/start-here/use-openwork-from-an-ai-agent.md
> Connect Slack (any organization admin): https://openworklabs.com/docs/slack/connect-slack.md. OpenWork in Slack (@openwork bot) is private alpha for approved organizations. Setup guide: https://openworklabs.com/docs/slack/overview.md. Agent skill: https://openworklabs.com/.well-known/agent-skills/set-up-openwork-slack/SKILL.md.

# Connect your Slack account to @openwork

> Link your own Slack account to OpenWork once, then DM or mention @openwork and confirm it answers.

> [!NOTE]
>
> **Private alpha.** Your administrator must [set up the Slack app](https://openworklabs.com/docs/slack/set-up-the-slack-app.md) before this works.

## Connect once

1. Open **Your Connections** in OpenWork and connect your own Slack account.
2. Authorize using the Slack workspace and account you will use to message `@openwork`.

This links your Slack identity to your OpenWork membership. Before linking, the assistant asks you to connect.

Connected Slack before the assistant was installed? You don't need to reconnect. The first time you message `@openwork`, OpenWork links the Slack account you already connected. If that account is in a different Slack workspace or its sign-in was revoked, the assistant asks you to connect again. `/openwork` returns a connection link; following the link alone does not complete authorization.

## Verify it works

1. Open `openwork` under Slack's agents/apps and send a DM: “Reply with a short hello to confirm my connection works.”
2. Wait for the finished answer in the thread. “On it” only confirms that a request started.
3. In an allowed test channel, run `/invite @openwork`, then mention it with the same test request. Confirm it appears in mention autocomplete and replies in the selected reply mode.
4. Administrators: check the connector's **Last 24 hours** counts for completed, active, need-connection, and failed requests.

Once those checks pass, try a task such as “Summarize this thread” or “Draft a reply.” Connected-service access depends on your own permissions. If the assistant needs a permission decision, continue in OpenWork Web; Slack does not approve it for you.

Something off? See [Troubleshooting](https://openworklabs.com/docs/slack/troubleshooting.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.