# Connect Lark

> Connect your organization's Lark bot to one AgentSky workspace.

canonical: https://agentsky.dev/help/connect-lark
source: https://agentsky.dev/help/connect-lark.md
updated: 2026-10-22

---

**A workspace owner or admin connects your organization's Lark bot once. People in that Lark organization can then use the shared workspace without linking individual AgentSky accounts.**

## Open the workspace setup

1. Select the intended workspace in AgentSky, open **Channels**, and choose **Connect Lark**. On the Mac, setup opens in your browser.
2. If your company bot is already registered in this AgentSky workspace and appears in setup, choose **Connect Lark** to reuse it, then finish the connection below.
3. Otherwise, use **Copy message** to ask your agent for setup help, or choose **Set up manually**. Keep credentials out of the message.

Start from Channels to keep the selected workspace. If you open the [setup page](https://platform.agentsky.dev/developer/apps/new?platform=lark&purpose=workspace) directly, check the workspace name before continuing.

## Register a company bot manually

1. In Lark, open your existing custom app and check that **Bot** is enabled. Create an app only if you do not already have one.
2. In AgentSky, choose **Copy permission scopes**. In Lark, open **Permissions & Scopes › Batch import/export** and import those scopes.
3. Enter its **App ID**, **App Secret**, and **Verification token** in the setup form, then choose **Verify and continue**. Enter these only in that form, never in chat or email.
4. In Lark, use the **Request URL** shown by AgentSky, subscribe to `im.message.receive_v1`, and publish the app for your organization.
5. Choose **Connect workspace** in AgentSky.

## Finish the connection

1. Select your company app and choose **Continue**.
2. Choose **Open connection instructions** and **Copy code**. Send that code once to your company bot as the administrator.
3. Wait for **Connected**. If the code expires, choose **Get a new code**.

Where: Web or Mac › Channels › Connect Lark. Setup continues in your browser.

Good to know: this is a shared workspace, not a private link to your personal chats. Send `/new` to start another task. If access is refused, ask a workspace admin; connecting does not give every member billing or admin rights. Related: [Message your agents from any app](https://agentsky.dev/help/message-your-agents).