Skip to content

Troubleshooting

Typical error:

No API token found

Check one of these:

  • ~/.config/clawdie/crowdin-token
  • .env in the host repo
  • exported CROWDIN_PERSONAL_TOKEN

Then verify:

Terminal window
cd /home/<agent>/clawdie-ai
./scripts/crowdin-sync.sh --status

Check:

  1. the token is valid
  2. the project still exists in Crowdin
  3. the target language is enabled there

Then retry:

Terminal window
./scripts/crowdin-sync.sh --push
./scripts/crowdin-sync.sh --pull

Check whether translators actually produced content for that locale.

Expected output paths look like:

  • docs/public/sl/
  • docs/public/de/

If the locale is empty or missing, the issue is usually upstream in Crowdin, not in Astro.

Localized page does not appear on the site

Section titled “Localized page does not appear on the site”

First make sure the translated markdown exists in the repo.

Then redeploy from the cms jail project:

Terminal window
cd /usr/home/<tenant>/<tenant>-site
npm run deploy

If that succeeds, verify the live route with curl.

Remember the current runtime path is:

  • /usr/home/<tenant>/<tenant>-site/

Not:

  • /home/clawdie/astro-docs/

If an error message or an old note points at astro-docs, treat it as historical guidance and switch back to the current cms-jail path.

Docs deploy works, but translations still look stale

Section titled “Docs deploy works, but translations still look stale”

Check whether the translated markdown was actually pulled into git before deploy:

Terminal window
cd /home/<agent>/clawdie-ai
git diff -- docs/public/sl docs/public/de

If there are no new locale changes, the deploy is probably working and the content simply was not updated yet.

Tenant sites disappeared after a docs deploy

Section titled “Tenant sites disappeared after a docs deploy”

That should not happen anymore.

The current docs deploy path protects:

  • /usr/local/www/<tenant>/sites/

If tenant-site output was still removed, inspect the deploy script in the Astro project and confirm the protected-path behavior is still present.