SmartClaw
Open navigation≡
Troubleshooting

Common Recovery Paths

Use these checks for installer errors, missing skill unlocks, stale marketplace views, billing sync delays, device activation limits, chat memory issues, and cloud sync troubleshooting.

Installer download fails

  1. Use the official download page and try the Windows, macOS, or Linux button again.
  2. If you see download_not_configured, the deployment is missing its GitHub release token or the release asset name does not match the expected platform.
  3. If the browser starts a download but the OS warns about the file, continue with the SmartScreen or Gatekeeper steps shown on the download page.

Payment completed but skill is still locked

  1. Return to the desktop app and press Refresh Library in the Skill Store.
  2. Open the Account tab and verify you are signed in with the same email used during checkout.
  3. If the lock remains after a minute, check whether Stripe redirected you back successfully and contact support with the purchase time.

No device slots left

  1. Open the Account tab in the desktop app.
  2. Use the Devices panel to deactivate an older machine you no longer use.
  3. Refresh the page, then retry activation on the current computer.

Marketplace looks outdated

  1. Refresh the library from the desktop Skill Store.
  2. If you are on a public marketing page, hard refresh the browser and verify the server deployment has completed.
  3. If you still see only a small subset of skills, open the admin skills page once so the built-in catalog can reconcile against the latest code.

Chat history disappeared

  1. Verify the local database exists at ~/.smartclaw/chat.db (or %USERPROFILE%\.smartclaw\chat.db on Windows).
  2. If the file is missing, prior conversations may have been stored only in memory. Enable Chat Memory in Settings to persist conversations.
  3. If you have Cloud Chat Sync enabled, open Settings and press Sync Now to pull your latest conversations from the server.

Cloud Chat Sync is failing

  1. Verify your internet connection and that you have an active SmartClaw subscription.
  2. Ensure your total conversation data is under the 5 MB sync limit. Very large chat histories may need to be trimmed.
  3. If you recently changed your password, re-authenticate in the Account panel and try again.

Cannot sync to a new device

  1. On your primary device, go to Settings > Chat Memory > Device Pairing and generate a new 6-digit PIN.
  2. On the new device, enter that PIN in Settings > Chat Memory > Enter Pairing PIN.
  3. The PIN is single-use. If it fails, generate a fresh PIN from the primary device.

Assistant forgot my preferences

  1. Open Settings > Chat Memory and verify that Adaptive Learning is enabled.
  2. Check the 'What I've Learned' section for any accidentally deleted insights.
  3. Insights are built over time from your conversations. Continue chatting normally and the assistant will re-learn your preferences.

Wrong insight learned by the assistant

  1. Go to Settings > Chat Memory and find the incorrect insight in the list.
  2. Click the delete button next to the insight to remove it immediately.
  3. You can also manually add correct insights using the input field in that section.

Still blocked?

Include the exact page, the time of the failure, and whether the issue happened during download, checkout, login, or skill install.

Contact SupportSecurity Guide