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

# AstrBot

> Updated: November 4, 2025

[AstrBot](https://astrbot.app/) is an open-source, all-in-one agent chatbot platform and development framework. It supports integrating large-model capabilities into multiple mainstream messaging platforms such as QQ, Feishu (Lark), DingTalk, Slack, Telegram, and Discord. It offers out-of-the-box RAG, Agent, and MCP features, along with a rich set of APIs to facilitate secondary development and integration. AstrBot has a strong community and a rich plugin ecosystem.

## Deploy and Configure AstrBot

### Deploy via Docker

Make sure Docker and Git are installed in your environment.

```bash theme={null}
git clone https://github.com/AstrBotDevs/AstrBot
cd AstrBot
docker compose up -d
```

> If your network environment is within mainland China, the above command may fail to pull images. You may need to modify the `compose.yml`file and replace `image: soulter/astrbot:latest` with `image: m.daocloud.io/docker.io/soulter/astrbot:latest`.

### Access the AstrBot WebUI

```txt theme={null}
http://127.0.0.1:6185
```

The default username and password are both`astrbot`. After logging in, you will be prompted to change the default password.

### Configure the chat model

On SiliconFlow’s [API Keys](https://cloud.siliconflow.cn/me/account/ak) page, create a new API Key and keep it handy.
On SiliconFlow’s [Models page](https://cloud.siliconflow.cn/me/models), choose the model you want to use and keep the model name handy.

Open the AstrBot WebUI and click `Service Providers` in the left sidebar → `Add Provider` → `select SiliconFlow`.

Paste the `API Key` and `Model Name` you created/selected above, click Save to finish creating. You can click `Refresh` under `Service Provider` `Availability `to test whether the configuration is successful.

<Frame>
  <img src="https://mintcdn.com/siliconflow-37161621/avRxNd36OE2uuCpS/images/usercases/AstrBot/1.webp?fit=max&auto=format&n=avRxNd36OE2uuCpS&q=85&s=f68cac56e8292e4b42e4162571b5794c" width="1200" height="764" data-path="images/usercases/AstrBot/1.webp" />
</Frame>

### Online chat test (optional)

You can test your configured model on the `Chat` page in the left sidebar of the AstrBot WebUI.

## Connect a Messaging Platform (Feishu as an example)

Feishu (Lark) is used here as an example. You can go to the [AstrBot Docs](https://docs.astrbot.app/) -> `Deployment` -> `Deploy Messaging Platform` to see how to connect other platforms.

### Create a Feishu bot

Go to the [Developer Console](https://open.feishu.cn/app) and create an enterprise self-built app.

<Frame>
  <img src="https://mintcdn.com/siliconflow-37161621/avRxNd36OE2uuCpS/images/usercases/AstrBot/2.webp?fit=max&auto=format&n=avRxNd36OE2uuCpS&q=85&s=c0aa60e10275f4fcf00fd501342650a8" width="1200" height="1015" data-path="images/usercases/AstrBot/2.webp" />
</Frame>

Add the “Bot” app capability.

<Frame>
  <img src="https://mintcdn.com/siliconflow-37161621/avRxNd36OE2uuCpS/images/usercases/AstrBot/3.webp?fit=max&auto=format&n=avRxNd36OE2uuCpS&q=85&s=1f67c5f670c71fe33841879319d59164" width="1200" height="745" data-path="images/usercases/AstrBot/3.webp" />
</Frame>

Click “Credentials & Basic Info” to obtain `app_id `and `app_secret`.

<Frame>
  <img src="https://mintcdn.com/siliconflow-37161621/avRxNd36OE2uuCpS/images/usercases/AstrBot/4.webp?fit=max&auto=format&n=avRxNd36OE2uuCpS&q=85&s=4d9a3c64f5f5005f98d99c577e7d5b03" width="1200" height="355" data-path="images/usercases/AstrBot/4.webp" />
</Frame>

### Configure AstrBot

1. Enter AstrBot’s admin panel
2. Click `Bots` on the left sidebar
3. In the right-hand panel, click `+ Create Bot`
4. Select `lark (Feishu)`

Fill in the popped-up configuration fields:

* ID: Fill in arbitrarily; used to distinguish different messaging platform instances.
* Enabled: Check this.
* app\_id: Your obtained `app_id`
* app\_secret: Your obtained `app_secret`
* The Feishu bot’s name

If you are using the international version of Feishu (Lark), set`domain` to `https://open.larksuite.com`.

Under `Configuration File`, click the ↗️ arrow button to the right of `Select Configuration File`.

<Frame>
  <img src="https://mintcdn.com/siliconflow-37161621/avRxNd36OE2uuCpS/images/usercases/AstrBot/5.webp?fit=max&auto=format&n=avRxNd36OE2uuCpS&q=85&s=4f3237f82c71bffe3fc559f1224ade30" width="1200" height="489" data-path="images/usercases/AstrBot/5.webp" />
</Frame>

On the configuration page that appears, click the provider-selection button to the right of the default chat model, choose the SiliconFlow provider you just created, then click the Save button at the bottom right. After saving successfully, close this page.

<Frame>
  <img src="https://mintcdn.com/siliconflow-37161621/avRxNd36OE2uuCpS/images/usercases/AstrBot/6.webp?fit=max&auto=format&n=avRxNd36OE2uuCpS&q=85&s=2f2090afd333fd77caaf1328d28bb78b" width="1200" height="766" data-path="images/usercases/AstrBot/6.webp" />
</Frame>

Click `Save`to create the bot.

### Set callbacks and permissions

Next, click “Events & Callbacks,” choose long-connection to receive events, and click Save. **If the previous step did not successfully start, you won’t be able to save here.**

<Frame>
  <img src="https://mintcdn.com/siliconflow-37161621/avRxNd36OE2uuCpS/images/usercases/AstrBot/7.webp?fit=max&auto=format&n=avRxNd36OE2uuCpS&q=85&s=c31359ae668b50edbd0a7f24be482c00" width="1200" height="750" data-path="images/usercases/AstrBot/7.webp" />
</Frame>

Click “Add Event,” go to “Messages & Groups,” scroll down to find `Receive Messages`, and add it.

<Frame>
  <img src="https://mintcdn.com/siliconflow-37161621/avRxNd36OE2uuCpS/images/usercases/AstrBot/8.webp?fit=max&auto=format&n=avRxNd36OE2uuCpS&q=85&s=5fa54cb32bb36fdc9b9c112fa067749d" width="1200" height="852" data-path="images/usercases/AstrBot/8.webp" />
</Frame>

Click to enable the following permissions.

<Frame>
  <img src="https://mintcdn.com/siliconflow-37161621/avRxNd36OE2uuCpS/images/usercases/AstrBot/9.webp?fit=max&auto=format&n=avRxNd36OE2uuCpS&q=85&s=72491451401ef07c6ab2e607f6db9710" width="1200" height="414" data-path="images/usercases/AstrBot/9.webp" />
</Frame>

Then click the `Save` button above.

Next, click “Permission Management,” click “Enable Permissions,” and enter`im:message:send,im:message,im:message:send_as_bot`. Add the filtered permissions.

Enter `im:resource:upload,im:resource` again to enable permissions related to uploading images.

The final set of enabled permissions is as follows:

<Frame>
  <img src="https://mintcdn.com/siliconflow-37161621/avRxNd36OE2uuCpS/images/usercases/AstrBot/10.webp?fit=max&auto=format&n=avRxNd36OE2uuCpS&q=85&s=675ca6986146e7c3536d6781ec8171ee" width="1200" height="750" data-path="images/usercases/AstrBot/10.webp" />
</Frame>

### Create a version

Create a version.

<Frame>
  <img src="https://mintcdn.com/siliconflow-37161621/avRxNd36OE2uuCpS/images/usercases/AstrBot/11.webp?fit=max&auto=format&n=avRxNd36OE2uuCpS&q=85&s=01a47b111fb6f363389b5afb7ee8cde4" width="1200" height="381" data-path="images/usercases/AstrBot/11.webp" />
</Frame>

Fill in the version number, update notes, and visibility scope, then click Save and confirm the release.

### Add the bot to a group

Open the Feishu app (you cannot add bots in the web version of Feishu), enter a group chat, click the button at the top-right → “Group Bots” → “Add Bot”.

Search for the name of the bot you just created. For example, in this tutorial we created the`AstrBot` bot:

<Frame>
  <img src="https://mintcdn.com/siliconflow-37161621/avRxNd36OE2uuCpS/images/usercases/AstrBot/12.webp?fit=max&auto=format&n=avRxNd36OE2uuCpS&q=85&s=360bdca938c64440460c9dad3978da26" width="1200" height="684" data-path="images/usercases/AstrBot/12.webp" />
</Frame>

### 🎉 All done

Send a test message `hi` in the group, and the bot will respond.

## More features

You can visit the [AstrBot Docs](https://docs.astrbot.app/) for more features and configurations.
