AstrBot/docs/en/faq.md

FAQ

Dashboard Related

Encountering 404 Error When Opening the Dashboard

Download AstrBot-vxxxxx-dashboard.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).

First Login Account and Random Password

On first startup, the WebUI account is astrbot by default, and the default password is randomly generated (it is not a fixed hardcoded value). Check the startup logs and log in with the random initial password shown there:

[00:27:40.590] [Core] [INFO] [dashboard.server:523]:
 ✨✨✨
  AstrBot v4.24.3 WebUI is ready

   ➜  Local: http://localhost:6185
   ➜  Initial username: astrbot
   ➜  Initial password: UiYVpZxnW8k22IWqf0ru5pOy
   ➜  Change it after logging in
 ✨✨✨
Set dashboard.host in data/cmd_config.json to enable remote access.

UiYVpZxnW8k22IWqf0ru5pOy is the default password.

Forgot Dashboard Password

If you forgot your AstrBot dashboard password, find the "dashboard" field in AstrBot/data/cmd_config.json, for example:

  "dashboard": {
    "enable": true,
    "username": "astrbot",
    "password": "81e0c3dxxxxxxxxxxx78862e78",
    "pbkdf2_password": "pbkdf2_sha256$600000$1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "password_storage_upgraded": true,
    "password_change_required": true,
    "jwt_secret": "5e1b0280bcxxxxxxxxxxxxxxxxf4a",
    "host": "127.0.0.1",
    "port": 6185,
    "disable_access_log": true,
    "ssl": {
      "enable": false,
      "cert_file": "",
      "key_file": "",
      "ca_certs": ""
    }
  },

Delete the username, password, pbkdf2_password, password_storage_upgraded, password_change_required, and jwt_secret fields (with their values), then save. The segment should look like:

  "dashboard": {
    "enable": true,
    "host": "127.0.0.1",
    "port": 6185,
    "disable_access_log": true,
    "ssl": {
      "enable": false,
      "cert_file": "",
      "key_file": "",
      "ca_certs": ""
    }
  },

After restart, AstrBot will automatically generate a random password with the fixed username astrbot; check the startup logs.

Correct Password Cannot Log In After Upgrading AstrBot

If you are sure the dashboard password is correct but still cannot log in after upgrading AstrBot, the old WebUI static files may be incompatible with the newer backend.

Solution:

1. Stop AstrBot.
2. Delete the dist folder under AstrBot's data directory: AstrBot/data/dist.
3. Restart AstrBot.
4. Access the dashboard in your browser. Press Ctrl+Shift+R or Ctrl+F5 (or Cmd+Shift+R on macOS) to force refresh the page.

After restart, AstrBot will reload or download WebUI files that match the current version.

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. /name, /provider, /dashboard_update, /op, /deop, /persona, /llm, /plugin, /model, /groupnew 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.