FAQ en

FAQ

What is the default admin? Does upgrading reset the password?

A fresh install's default admin is admin@localhost with password 123456; change it right after the first sign-in. When an existing database is upgraded with PRESERVE_EXISTING_DATA=true, the startup script skips admin seeding and keeps account state. If you forget the password, see scripts/reset-password.js in the repository, and back up first.

Sign-in bounces back to the login page, or fails behind a reverse proxy?

Check that NEXTAUTH_URL equals the full address the browser actually uses, that NEXTAUTH_SECRET is set and stays the same after recreating the container, and that the proxy forwards the host and protocol correctly. Sign in again once the configuration takes effect.

I changed environment variables but the AI still uses the old configuration?

Fields saved in the web UI take precedence over environment variables. Check the provider, model and active instance in "Settings → AI Provider" first. After changing container environment variables, recreate the container; once the web configuration is saved, later AI requests read it.

The connection test passes but image recognition fails?

A successful connection does not mean the model accepts images. Make sure the chosen model has vision capability, the compatible API accepts image requests, the image is complete and readable, and the server can reach the provider. localhost inside a container is the container itself; see AI Configuration.

"AI response format error", or animation generation fails?

Check whether the model follows the tag or JSON output format and whether its maximum output length is large enough. Animations contain long SVG code and are easily truncated by short output limits. Switch to a more suitable model; on timeouts, check the network and adjust the admin analysis timeout.

The screenshot button is unavailable?

Screenshots use the browser's getDisplayMedia(), which requires an HTTPS or localhost secure context plus browser and OS support with permission to share the screen. Accessing the app through a LAN HTTP address usually does not qualify; even with HTTPS, mobile browsers may not support it, so take a photo, upload or paste an image instead.

Formulas show as source, or a figure is wrong?

Check the formula delimiters, backslashes and KaTeX-supported syntax using the source/preview toggle; when the detail page detects errors, try "Fix LaTeX". SVG figures are generated by the AI, so compare geometric relationships with the original image and regenerate when needed.

The question count did not increase after importing?

The import may have matched duplicate detection. Check the message and the original question's answer history; a duplicate is recorded as another wrong attempt on the original. The default threshold is 90% and a question is a duplicate when the similarity is strictly greater; adjust it in your personal settings. See the User Guide.

Why do the difficulty and paper A/B differ?

Difficulty and paper level are separate fields. When the paper level is not set, 1–3 stars default to paper A and 4–5 stars to paper B; a manually chosen paper level is kept. Changing the stars does not overwrite an existing manual choice.

The AI analysis percentage is stuck for a long time?

The percentage is an estimate for the current stage; AI services usually do not report real progress. Use the stage description, elapsed time and background task status, read the error after a timeout, and avoid submitting the same task repeatedly.

Why is the background task list empty after a restart?

The task list is kept in process memory, so a restart clears it and running tasks are not resumed. Check whether the question or exam paper was saved before retrying; the task status on the page is not the source of truth for saved data.

Does HTTP 207 mean the Openclaw import succeeded?

207 means some items in the batch failed; with the current implementation it can be returned even when every recognition failed. Always read successCount, failCount and each item in results. The per-image recognition timeout is currently at most 3 seconds; see Openclaw Integration for more limits.

Can the exported JSON restore the whole site?

The JSON does not include full account credentials or the server configuration. A full-site restore needs the complete database, config/, the deployment configuration and any certificates; see Backup and Restore.

Data is missing after an upgrade, or the container won't start?

First check that the original data/ and config/ are still mounted at /app/data and /app/config, then look for migration and permission errors in the container logs. Do not delete the data directory to try to fix it; keep the current state and backups, and check version compatibility following the deployment guide.

How do I report a problem?

Open a GitHub issue with the running version, deployment method, browser, steps to reproduce and redacted logs. The version is shown in "About" in the settings or at /api/health; do not include API keys, passwords, session data or a full database.