Skip to main content
OpenHands utilizes a large language model (LLM), which may generate responses that are inaccurate or incomplete. While we strive for accuracy, OpenHands’ outputs are not guaranteed to be correct, and we encourage users to validate critical information independently.

Prerequisites

  • Access to OpenHands Cloud.

Installation Steps

This step is for Slack admins/owners
  1. Make sure you have permissions to install Apps to your workspace.
  2. Click the button below to install OpenHands Slack App Add to Slack
  3. In the top right corner, select the workspace to install the OpenHands Slack app.
  4. Review permissions and click allow.
Make sure your Slack workspace admin/owner has installed OpenHands Slack App first.Every user in the Slack workspace (including admins/owners) must link their OpenHands Cloud account to the OpenHands Slack App. To do this:
  1. Visit the Settings > Integrations page in OpenHands Cloud.
  2. Click Install OpenHands Slack App.
  3. In the top right corner, select the workspace to install the OpenHands Slack app.
  4. Review permissions and click allow.
Depending on the workspace settings, you may need approval from your Slack admin to authorize the Slack App.

Working With the Slack App

To start a new conversation, you can mention @openhands in a new message or a thread inside any Slack channel. Once a conversation is started, all thread messages underneath it will be follow-up messages to OpenHands. To send follow-up messages for the same conversation, mention @openhands in a thread reply to the original message. You must be the user who started the conversation.

Example conversation

Start a new conversation, and select repo

Conversation is started by mentioning @openhands. slack-create-conversation.png

See agent response and send follow up messages

Initial request is followed up by mentioning @openhands in a thread reply. slack-results-and-follow-up.png

Pro tip

You can name one or more repositories when starting a new conversation, as owner/repo or as a repository URL (e.g. @openhands in OpenHands/OpenHands and OpenHands/docs ...). OpenHands starts with up to ten named repositories it can access. The first accessible one is the main repository, and the others are cloned beside it. Its reply lists the repositories it started with, any it could not access, and any left out because of the limit. If the message names no repository it can access, you’ll be asked to select one or more repositories and press Start, or to continue with No Repository. The first repository you select is the main one. slack-pro-tip.png