Skip to main content
AstrBot 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. 
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.ymlfile and replace image: soulter/astrbot:latest with image: m.daocloud.io/docker.io/soulter/astrbot:latest.

​
Access the AstrBot WebUI

http://127.0.0.1:6185
The default username and password are bothastrbot. After logging in, you will be prompted to change the default password.

​
Configure the chat model

On SiliconFlow’s API Keys page, create a new API Key and keep it handy. On SiliconFlow’s Models page, 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.

​
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 -> Deployment -> Deploy Messaging Platform to see how to connect other platforms.

​
Create a Feishu bot

Go to the Developer Console and create an enterprise self-built app.
Add the “Bot” app capability.
Click “Credentials & Basic Info” to obtain app_id and app_secret.

​
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), setdomain to https://open.larksuite.com. Under Configuration File, click the ↗️ arrow button to the right of Select Configuration File.
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.
Click Saveto 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.
Click “Add Event,” go to “Messages & Groups,” scroll down to find Receive Messages, and add it.
Click to enable the following permissions.
Then click the Save button above. Next, click “Permission Management,” click “Enable Permissions,” and enterim: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:

​
Create a version

Create a version.
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 theAstrBot bot:

​
🎉 All done

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

​
More features

You can visit the AstrBot Docs for more features and configurations.