FAQ

Dashboard Related

Encountering 404 Error When Opening the Dashboard

Download dist.zip from the release page, extract it, and move it to AstrBot/data. If it still doesn't work, try restarting your computer (based on community feedback).

Forgot Dashboard Password

If you forgot your AstrBot dashboard password, you can modify the "dashboard" field in the AstrBot/data/cmd_config.json configuration file, where "username" is your username and "password" is your password encrypted with MD5.

To modify your account credentials, follow these steps:

1. Modify the "username" field, keeping the "" quotation marks. If you don't want to change the username, skip this step
2. Visit the website: Online MD5 Generator
3. Enter your new password in the input text box
4. Select MD5 encryption (32-bit), make sure to choose the 32-bit option
5. Paste the converted string into the configuration file, keeping the "" quotation marks

Bot Core Related

How to Let AstrBot Control My Mac / Windows / Linux Computer?

1. In AstrBot WebUI's Config -> General Config, find Use Computer Capabilities, and select local for the runtime environment.
2. In Config -> Other Config, find Admin ID List, and add your user ID (you can get it through the /sid command).

TIP

For security reasons, when runtime environment is set to local, AstrBot only allows AstrBot administrators to use computer capabilities by default. You can select sandbox for the runtime environment, which allows all users to use computer capabilities (in an isolated sandbox). For more details, see AstrBot Sandbox Environment

Bot Cannot Chat in Group Conversations

1. In group chats, to prevent message flooding, the bot will not respond to every monitored message. Please try mentioning (@) the bot or using a wake word to chat, such as the default /, for example: /hello.

No Permission to Execute Admin Commands

1. /reset, /persona, /dashboard_update, /op, /deop, /wl, /dewl are the default admin commands. You can use the /sid command to get a user's ID, then add it to the admin ID list in Settings -> Other Settings.

Chinese Characters Garbled When Locally Rendering Markdown Images (t2i)

You can customize the font. See details -> #957

Recommended font: Maple Mono.

Cannot Parse API Returned Completion & LLM Returns <empty content>

This is because the provider's API returned empty text. Try the following steps:

1. Check if the API key is still valid
2. Check if the API call limit or quota has been reached
3. Check network connection
4. Try reset
5. Lower the maximum conversation count setting
6. Switch to another model from the same provider / a different provider

Plugin Related

Cannot Install Plugin

1. Plugins are installed via GitHub. Access to GitHub from mainland China can indeed be unstable. You can use a proxy, then go to Other Settings -> HTTP Proxy to configure it. Alternatively, download the plugin archive directly and upload it.

Error No module named 'xxx' After Installing Plugin

This is because the plugin's dependencies were not installed properly. Normally, AstrBot automatically installs plugin dependencies after installing the plugin, but installation may fail in the following situations:

1. Network issues preventing dependency downloads
2. Plugin author did not include a requirements.txt file
3. Python version incompatibility

Solution:

Based on the error message, refer to the plugin's README to manually install dependencies. You can install dependencies in the AstrBot WebUI under Console -> Install Pip Package.

If you find that the plugin author did not include a requirements.txt file, please submit an issue in the plugin repository to remind the author to add it.