Troubleshooting

Solutions to common issues you might encounter when using SuperClawd.

Authentication Failed

Problem: superclawd can't authenticate with SuperClawd when launching Claude Code

Solutions:

1. Re-run superclawd login to reconnect this machine
2. Launch superclawd and confirm the right workspace is selected in the startup picker (press d to set your default). Stale defaults self-heal — if your default is no longer reachable, the CLI clears it and re-shows the picker.
3. Revoke this device and re-add it under Settings → Devices in the web dashboard
4. Clear npm cache to get the latest CLI: npm cache clean --force

Invalid or Expired Tokens

Problem: Getting token errors during authentication

Solutions:

1. Request a new verification/reset email
2. Check if the link has expired (usually 24 hours)
3. Clear browser cookies and try again

Credit Balance Issues

Problem: "Insufficient credits" errors

Solutions:

1. Check your billing account balance
2. Ensure the billing account is linked to your workspace
3. Purchase more credits or enable auto top-up

Free Tier Limits

Problem: Can only create 1 skill, workflow, command, or resource

Free tier accounts are limited to 1 of each entity type (skill, workflow, command, resource) per workspace. This allows you to explore the full functionality before upgrading.

Solutions:

1. Purchase credits — Your account automatically upgrades to the paid tier when you purchase any credit package (starting at $10 for 100 credits). Paid tier allows up to 50 skills, 50 workflows, 50 commands, and 250 resources per workspace.
2. Use the welcome gift — New users can redeem the WELCOME gift code for 50 free credits. While this doesn't upgrade your tier limits, it lets you test all features including notifications.
3. Consolidate your content — Make the most of your single skill, workflow, command, or resource by combining related instructions.

See the Limits page for complete details on all tier limits.

Workspace Access Denied

Problem: Can't access a workspace or feature

Solutions:

1. Verify you have the correct role (some features require Admin or Owner)
2. Check if your membership is still active
3. Contact the workspace owner for access

Recovery Code Not Working

Problem: Account recovery code is rejected

Solutions:

1. Ensure you're entering the code exactly as shown (case-sensitive)
2. Check for spaces or special characters
3. If regenerated, use the latest code
4. Contact support for manual recovery

CLI Issues

Problem: Can't run the superclawd CLI via npx

Solutions:

1. Ensure Node.js is installed (version 18+): node --version
2. Clear npm cache: npm cache clean --force
3. Try running with fresh download: npx -y superclawd@latest version
4. Check your internet connection (npx downloads the package on first run)

Skills Not Being Applied

Problem: Instructions aren't showing up in AI responses

Solutions:

1. Ensure the skill is enabled (not disabled)
2. Check that the action type matches your request
3. Relaunch Claude Code with superclawd so your latest workspace skills are loaded