Klaus

Frequently Asked Questions

Why am I using so many tokens?

Image files and certain tool calls (eg web fetch) can consume a lot of tokens.

To check your session size, use /usage — this toggles a usage summary on each message.

You can compact a session with /compact, or clear it with /new or /reset.

To check usage once without toggling, use /status.

How do I check my spending?

Ask Klaus directly: "How much have I spent?" or "Show me my usage stats."

Klaus can break down your spending by model, show which ones are consuming your credits, and display your remaining balance.

You can also use /credits to quickly check your OpenRouter balance.

Billing page

Why am I getting 'Key limit exceeded'?

You're out of tokens on OpenRouter. Go to the Billing page to buy more tokens or add your own OpenRouter key.

Billing page

Why are free models so slow?

OpenRouter treats all Klaus accounts as a single user, so free-tier rate limits are shared across everyone.

This means free models will be heavily throttled, especially during peak times.

If you want to make heavy use of free models, we recommend setting up your own OpenRouter API key (BYOK) on the Billing page — this gives you your own rate limits.

We're working with OpenRouter to resolve this on our end.

Billing page (BYOK setup)

Why am I getting 'Context overflow'?

This means the conversation is too long for your current model. Two common causes:

1. You switched to a model with a shorter context window than before.

2. You don't have enough OpenRouter credits to pay for such a long prompt — add more credits on the Billing page.

To fix it, either switch to a model with a longer context window, add more credits, or start a fresh session with /new or /reset.

Billing page

What if I get 'Invalid config at /root/.openclaw/openclaw.json'?

Email us at support@usebits.com and we'll fix this for you.

What if I configured a bad model and now Klaus won't start?

You can fix this from klausai.com/klaus — use the model selector dropdown to choose a valid model.

This will update your instance configuration without needing to access the command line.

What machine does Klaus run on?

Starter runs on t4g.small — 2 vCPUs, 2 GB RAM, and 30 GB of encrypted storage.

Plus runs on t4g.medium — 2 vCPUs, 4 GB RAM, and 60 GB of storage.

Pro runs on t4g.xlarge — 4 vCPUs, 16 GB RAM, and 100 GB of storage.

Can I SSH into my instance?

Yes. Go to the Integrations page and set up Tailscale. Once connected, you'll get an SSH command like ssh root@your-hostname.

Integrations

Does Klaus have browser support?

Yes. You can enable browser automation from the Integrations page. This installs Chromium on your instance and gives Klaus the ability to browse the web, take screenshots, and interact with web pages.

Integrations

What models can I use?

By default, you can use any model which OpenRouter supports, which is almost any AI model.

We recommend Haiku 4.5, Gemini 3 Flash, and Kimi k2.5. If you're stuck, use Opus 4.6.

If you connect your ChatGPT subscription, you can also use OpenAI models (like GPT-5.4) at no extra cost — usage is covered by your subscription.

Where do my tokens come from?

We provide $15 of tokens one-time, after which you can buy more OpenRouter credits directly on our website at klausai.com/klaus.

What is your pricing?

See our pricing page.

pricing page

What messengers are supported?

We support Slack, Telegram, WhatsApp, and iMessage directly. Discord is also very easy to set up.

Go to the Integrations page to connect any of these.

Integrations

Why does WhatsApp keep disconnecting?

WhatsApp connections are inherently unstable. There are two common issues:

1. **Session expiry:** WhatsApp sessions expire every 30 days — this is a limitation on WhatsApp's end. When it happens, go to the Integrations page and re-pair by scanning the QR code again.

2. **Periodic disconnections:** The WhatsApp Web protocol can drop connections during quiet periods, which may cause missed messages. This is an upstream issue in the WhatsApp provider that we're unable to fix on our side.

For more reliable messaging, we recommend using Slack or Telegram instead.

Integrations

How does Klaus use AgentMail?

See the AgentMail integration docs.

AgentMail integration docs

How can I get help?

Click the "Get Help" button in the chat sidebar — this lets you report issues or request support directly.

If your instance isn't responding, the Get Help button can also trigger the automated troubleshooter to diagnose and fix common problems.

AI can help you fix bugs and build new features from within our Discord in the #talk-to-klaus channel.

To talk to a human, post in the #help channel in Discord or email support@usebits.com.

Should I use a firewall?

Klaus runs on a private subnet on AWS. Adding a firewall won't increase security, and you might lock yourself out of your instance.

Does Klaus have ____?

The things we're working on most urgently are:

  • Discord support
  • Better token-saving settings
  • More file storage options
  • Who is Klaus and who is Bittie?

    Klaus is our hosted deployment of OpenClaw, and our main focus right now.

    Bittie is a previous browser agent project that we are no longer spending much time on.

    But that part of our website is still alive because we still have users and want to support them.

    If you're here to use OpenClaw/Klaus, you can entirely ignore the Bittie section of our UI.

    Can I give my agent its own Google account?

    Yes. Go to the Integrations page and click on Google.

    If you're already logged in with your own account, click the three dots to disconnect first.

    Then when Google prompts you to log in, make sure you log in with your agent's Google account.

    Why does Google show a scary warning when I connect my account?

    When you connect Google, you may see a screen that says "Google hasn't verified this app."

    This is normal — it appears because our Google OAuth app is still going through Google's verification process.

    To continue, click "Advanced" and then "Go to Klaus (unsafe)." Despite the wording, your data is safe — Klaus only requests the permissions shown on the consent screen, and you can revoke access at any time from your Google Account settings.

    How do I connect Google Workspace?

    Go to the Integrations page and enable the Google Workspace integration.

    This lets Klaus access your Google Calendar, Gmail, and Drive.

    Integrations

    What happens when I run low on credits?

    You'll get an email alert when your credits are running low.

    If you have auto-refill enabled, credits top up automatically so Klaus never stops mid-task.

    You can enable auto-refill from the Billing page.

    Billing page

    Can Klaus back up files to GitHub?

    Yes. You can enable the GitHub backup integration from the Integrations page.

    Klaus will sync files and code to a GitHub repository you specify.

    Integrations

    What's the Browser Relay extension?

    The Browser Relay extension lets Klaus control your Chrome browser directly.

    Unlike server-side browser automation (which runs Chromium on your instance), Browser Relay uses your own browser session — so Klaus can access sites you're logged into.

    Install the extension from the Chrome Web Store and connect it from the Integrations page.

    Integrations

    Can I create my own Slack app for Klaus?

    Yes. You can create a custom Slack app with your own icon and name.

    Go to the Integrations page and look for "Custom Slack App".

    Integrations

    What is the Canvas page?

    The Canvas page shows HTML files that Klaus has created for you.

    These can be interactive web apps, charts, or visualizations.

    Note: Canvas files don't send data back to Klaus — they're view-only.

    Files should be placed in ~/.openclaw/canvas/ (not ~/.openclaw/workspace/canvas/).

    Canvas

    What is the troubleshooter?

    The troubleshooter is an automated repair system that diagnoses and fixes common issues with your Klaus instance.

    It checks gateway health, disk space, memory, and service status — then attempts to fix any problems it finds.

    We run it automatically when your instance fails a health check, but you can also trigger it manually from the Klaus Health page.

    Klaus Health

    Where can I see troubleshooter history?

    Go to the Klaus Health page to see past troubleshooter runs and your instance health status.

    You can also manually trigger a troubleshoot from there if something seems wrong.

    Klaus Health

    Can I use my ChatGPT subscription with Klaus?

    Yes. If you have a ChatGPT Plus or Pro subscription, you can connect it to Klaus so that OpenAI model usage (like GPT-5.4) is covered by your subscription instead of per-token billing.

    Go to Settings → Billing, find "ChatGPT Subscription", and click "Connect ChatGPT."

    You'll be given a code to enter at OpenAI's verification page. The code is auto-copied to your clipboard.

    Once connected, the model selector will show only OpenAI models available through your subscription.

    Billing page

    How do I disconnect my ChatGPT subscription?

    Go to Settings → Billing and click "Disconnect" under the ChatGPT Subscription section.

    Klaus will switch back to using OpenRouter credits and show the full model list again.

    Billing page

    How do I connect iMessage?

    Go to the Integrations page and find "iMessage." Enter your phone number and verify it via SMS.

    Once connected, you can text Klaus from your iPhone and get responses as iMessage messages.

    Klaus will show typing indicators while composing a reply and supports emoji reactions.

    Integrations

    How do I upload images to Klaus?

    On the chat page, you can paste an image from your clipboard (Cmd+V) or drag and drop a file onto the chat input.

    Klaus will analyze the image and respond based on what it sees. We don't support PDFs, csvs, or other filetypes yet.

    Klaus Chat

    Can I search my past conversations?

    Yes. Go to the Sessions page and use the search bar to search across all your chat transcripts.

    Matching terms are highlighted in the results so you can quickly find what you're looking for.

    Sessions

    Can I edit files on my instance from the browser?

    Yes. The File Explorer on your instance page lets you browse, view, and edit files directly from the dashboard.

    You can also manage agent configuration files from the Agents page.

    Instance page

    How do scheduled tasks work?

    Scheduled tasks (cron jobs) let Klaus run prompts on a schedule — like daily reports or periodic checks.

    Go to the Scheduled Tasks page to create, edit, or delete tasks. You can configure the prompt, model, schedule, and delivery channel (e.g., Slack, Telegram).

    Scheduled Tasks

    Can Klaus auto-respond to emails?

    Yes. Enable the webhook on your AgentMail integration and incoming emails will be forwarded to your agent automatically.

    You can choose which agent handles the responses if you have multiple agents configured.

    Integrations

    Can I use my own AgentMail API key?

    Yes. On the AgentMail integration card, you can switch to "Bring Your Own Key" mode and enter your own AgentMail API key.

    This gives you full control over your email configuration and lets you use your existing AgentMail account.

    Integrations

    Can I connect Outlook or another email provider?

    Yes. The Outlook Email integration connects any IMAP/SMTP email account — including Outlook, Yahoo, and other providers.

    Go to the Integrations page to set it up.

    Integrations

    Does Klaus remember things from past conversations?

    Klaus has semantic memory search powered by OpenRouter embeddings.

    It can search through past conversation history to recall previous discussions, making it better at maintaining context across sessions.

    Are my instance files backed up?

    Yes. Your instance disk is backed up daily via automatic EBS snapshots.

    If you ever need to restore data, contact support@usebits.com.

    Can external services trigger my Klaus agent? Can I use webhooks?

    Yes. Instance webhooks let you send authenticated HTTP requests to your agent.

    Create a webhook from the Integrations page and use the provided URL and token to trigger your agent from any external service.

    Integrations