User Guide
Troubleshooting
Open the entry that matches what you're seeing. Most issues come down to provider config or a per-persona extension toggle.
Model and provider
AI Providers
"Failed to connect" or model errorsUsually the API key, the base URL, or the model selection.
AI Providers
- Open Settings → AI Providers. Make sure the active tab matches the provider you want to use.
- For OpenRouter: paste the key, save, then wait for the model list to load before picking a model.
- For Ollama or LM Studio: confirm the server is running and reachable. Use the test button rather than guessing.
- For Built-In on Free: check the usage meter in the sidebar footer. You might be out of monthly tokens.
AI Providers
Responses cut off mid-sentenceContext window or a provider timing out.
AI Providers
- Switch to a model with a larger context window.
- Trim long persona system prompts or scenario base prompts.
- If you're running locally, check the server has enough RAM/VRAM for the model.
Devices
Devices & Toys
Browser won't show the Bluetooth pickerWeb Bluetooth needs a Chromium-based browser on HTTPS or localhost.
Devices & Toys
- Use Chrome, Edge, or Opera. Safari and Firefox don't support Web Bluetooth.
- The page has to be served over HTTPS (or be on localhost). A non-secure proxy will block the picker.
- Restart the device in pairing mode before clicking Scan for Devices.
Devices & Toys
Toy paired but doesn't respondThe extension is installed but not enabled for the current persona.
Devices & Toys
- Open the extension's detail page from My Toys and check the Personas section — is the persona you're chatting with toggled on?
- Confirm the device shows as connected in the top bar (green status, not gray).
- Try the Test action on the extension settings page. If that doesn't move the toy, the AI's tool calls won't either.
Coyote
Coyote disconnects every few minutesBattery, distance, or Bluetooth interference.
Coyote
- Check the battery indicator on the Devices tab (V3 only). Low battery causes drops.
- Stay within a couple of metres of the computer, line-of-sight if possible.
- Other Bluetooth peripherals on the same machine can interfere — headphones and watches are common offenders.
Extensions
Extensions
Extension installed but does nothingAlmost always a per-persona enable issue.
Extensions
- Open the extension on its category page (My Toys, My Utilities, or My Integrations) and check the Enabled here filter.
- From the detail page, scroll to Personas and confirm the current persona has the extension toggled on.
- If global settings ask for a key, endpoint, or credential, fill them in. Extensions don't run with empty config.
Extensions
"Update available" badge won't go awayUpdates are click-to-install on purpose.
Extensions
Open the extension card and click Update. Nothing auto-applies, so you get to read the changelog before installing.
Extensions
Dev Extensions page is emptyDeveloper Mode is the gate.
Extensions
- Turn on Developer Mode and Show developer features under Settings → Advanced.
- Pick a local extension folder. Each extension is its own subfolder with a
manifest.jsonand a JS module. - Click Scan workspace.
Image generation
Image Generation
No images showing upEither the behaviour is off or the backend isn't reachable.
Image Generation
- Check Settings → Image Generation → Photo Behavior. Turn photos off is the obvious culprit; Send pics every few turns needs enough turns to have elapsed.
- For ComfyUI or Automatic1111, confirm the server is running at the configured URL (defaults:
http://localhost:8188andhttp://localhost:7860). - Automatic1111 must be started with
--api. - For Cloud images, adult content needs NSFW enabled under Content.
Image Generation
Images look wrong (wrong person, wrong outfit)The persona's visual fields drive the prompt.
Image Generation
- Edit the persona's Visuals and Advanced Settings tab. Look at the base prompt, default clothing presets, and any attached LoRA files.
- If a scenario is active, its Environment and Clothing fields also feed the prompt.
Data and storage
Storage
My chats and personas are goneLocal mode lives in this browser only.
Storage
- If you're in Local mode and cleared browser data, the chats really are gone unless you have an export.
- If you signed in from a different browser, profile, or device, sign in there to check.
- If you're in Cloud mode and you're sure the account is right, contact support before doing anything destructive.
Storage
History rename button is missingLocal mode hides it.
Storage
The pencil icon next to a History row only appears in Cloud mode. In Local mode the session title is whatever the first message generated — the row groups under Today, Yesterday, or Earlier and you can delete but not rename.
Storage
Import says my archive looks emptyWrong ZIP, or the export was made before there was data.
Storage
- The import preview shows persona, session, message, memory, and summary counts. Zeroes mean an empty account.
- The archive's export date is shown too — useful for spotting a stale backup.
Account and billing
Account
Token usage is higher than expectedLong contexts burn tokens fast.
Account
- Some scenarios stack base prompts, environment, character definitions, and triggers. All of that is sent every turn.
- Memories above ~50 entries grow the context noticeably. Trim or lower the importance of older ones.
- Image generation tools also consume tokens for the prompts they build.
Account
Username change is greyed outThe limit is once every 90 days.
Account
The field shows a countdown to when you can change it again. There's no override; the cooldown keeps handles stable for other users who may reference yours.
Getting more help
Still stuck? Email [email protected] or join our Discord — the fastest way to reach a human. When you get in touch, mention which provider you're on, which storage mode you're in, the extension or scenario involved, and what you've already tried.