Help center

Start here when something goes wrong in Halo: ask Halo first, look up the exact error text, or pick the page for your kind of problem.

Just tell Halo

Halo says "The model service is limiting requests". What does that mean, and what should I do?

Halo checks its own official documentation and tells you what the message means and how to fix it. Paste the full error text for a more precise answer.

Find your problem

• Error messages: look up the exact message you see; conversation, model, attachment, Digital Human, bot and team messages are all there.
• Model API error codes: what status codes such as 401 and 429 mean.
• Install and launch problems: Halo won't install or open, Mac and Windows security prompts, Windows "First-time setup required", where the logs are.
• Bot not replying: a WeCom, Feishu or WeChat bot doesn't receive or answer messages.
• A Digital Human did not run: missed schedules, "Not started", stopped after repeated failures.
• FAQ: short answers to common questions such as cost, where your data goes, whether the AI asks before changing files, and offline and phone use.
• Logs and diagnostics: run System Diagnostics, reset the AI engine, export a diagnostic report, find logs, and what to include in a bug report.

For team problems, see Teams across computers.

Still stuck

When you ask for help, include these to save a round of questions:

1. What you did, what you expected, and what you actually saw.
2. The exact error: copy the text in the red box, or click Copy (tooltip "Copy error message") on the failed step in the thought process above the reply.
3. Your Halo version: Settings › About.
4. A diagnostics report: open Settings › System › System Diagnostics, click Run Diagnostics, then Copy Report or Export Report. The report doesn't contain the key itself. In error messages, Bearer tokens, JWTs and some keys starting with sk- are masked, but formats such as Anthropic (sk-ant-…) and OpenAI project keys (sk-proj-…) are not; user names in macOS and Linux paths are hidden, but not in Windows paths. Read it through before sending and delete any key you see.
5. If needed, the logs; see Logs and diagnostics.

Then open an issue on GitHub Issues, or reach us through Contact.

Next steps

• Get started: from install to your first finished task.
• Guides: how each feature works.