📖 Overview
AstrBot is an open-source one-stop Agent chatbot platform. It connects LLM capabilities to QQ, Feishu, DingTalk, WeCom, and other IM apps for personal assistants, customer service, and knowledge-base bots.
⚙️ Connect to BeeHears
BeeHears is a New API–compatible relay. In most apps, fill in the three fields below using a token from the BeeHears console:
| Field | Value |
|---|---|
| API Base URL | https://ai.beehears.com or https://ai.beehears.com/v1 (use the OpenAI-compatible field the app expects) |
| API Key | BeeHears console token (starts with sk-) |
| Model name | A model ID available on your account (list via /v1/models). |
Create a token at https://ai.beehears.com and confirm model access. Never paste secrets into docs or chat.
BeeHears does not own this third-party app. Steps below are adapted from upstream New API docs for BeeHears (ai.beehears.com).
📚 Setup guide
AstrBot is an open-source, all-in-one Agent chatbot platform that seamlessly integrates large language model capabilities into mainstream instant messaging software such as QQ, Feishu, DingTalk, and WeChat Work, creating a reliable and scalable conversational AI infrastructure for individuals, developers, and teams. Whether it's a personal AI companion, intelligent customer service, automation assistant, or enterprise knowledge base, AstrBot can quickly build production-ready AI applications within your instant messaging platform's workflow.
- Official Website: https://astrbot.app
- Official Documentation: https://docs.astrbot.app
- Project Homepage: https://github.com/astrbotdevs/astrbot
BeeHears Integration Method
AstrBot supports integrating BeeHears as a model provider, allowing users to access and utilize various AI model services through BeeHears.
Configuration Steps
Obtain BeeHears API Key
After registering and logging into BeeHears, click 'Console' in the top navigation bar, then click 'Token Management', and then click the 'Add Token' button to create a new API Key. Select the appropriate permissions and click 'Create'.
After successful creation, click the 'Copy Key' button to copy the generated API Key.
Configure BeeHears Service Provider in AstrBot
Open the AstrBot administration panel, go to the 'Model Providers' page, then click the 'Add Model Provider' button.
BeeHears perfectly supports OpenAI Chat Completion and Responses interfaces. Click 'OpenAI' to enter the OpenAI provider configuration page.
In the pop-up dialog, set the API Base URL to the BeeHears interface address. Please use your own deployed BeeHears, or ensure that the service provider has legitimate upstream authorization and compliance obligations for the BeeHears service. If you have deployed BeeHears locally, fill in the local address, for example, https://ai.beehears.com/v1. Do not connect API addresses or keys from unknown sources to a production environment.
Then, enter the API Key into the 'API Key' field and click the 'Save' button.
Then click 'Save' to complete the BeeHears provider configuration.
Apply Service Provider
Go to the 'Configuration File' page, find the 'Model' section, change the 'Default Chat Model' to the BeeHears provider you just created, and click the 'Save' button.
At this point, you have successfully configured BeeHears as AstrBot's model provider. Now, you can access and use various AI model services provided by BeeHears through AstrBot.