> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ultraclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Common Issues

> Solutions to common UltraClaw issues. Troubleshoot your AI assistant, channels, integrations, and billing.

# Common Issues

Having trouble with your UltraClaw agent? Find answers to the most common issues below. If your problem isn't listed here, [contact support](/troubleshooting/contact-support).

## Agent Issues

<AccordionGroup>
  <Accordion title="My assistant isn't responding">
    If your agent isn't replying to messages, try these steps in order:

    1. **Check agent status** — send `/status` to your agent. If it responds, it's online and may have been processing a long-running task.
    2. **Start a fresh conversation** — send `/new` to clear the current context and start a new thread. This resolves most response issues.
    3. **Check your token balance** — visit your [dashboard](https://ultraclaw.ai/dashboard) or send `/context` to see your remaining tokens. If your balance is zero, your agent can't respond until you top up or your monthly allocation resets.
    4. **Try a different channel** — if you're on iMessage, try sending a message via [WebChat](https://ultraclaw.ai/dashboard) to see if the issue is channel-specific.

    If none of these work, [contact support](/troubleshooting/contact-support) with your account details.
  </Accordion>

  <Accordion title="My agent's responses are slow">
    Response times can vary based on:

    * **Model selection** — more capable models may take slightly longer to respond
    * **Task complexity** — multi-step tasks (checking calendar + drafting email + setting reminder) take more time
    * **Extended thinking** — if your agent is using deep reasoning, it may take 10-30 seconds for complex questions

    If responses are consistently slow (over 60 seconds), try switching to a faster model via the model selector in your [dashboard](https://ultraclaw.ai/dashboard) or by sending `/new` followed by the model name.
  </Accordion>

  <Accordion title="Context is full">
    Every conversation has a context window — the amount of information your agent can hold in a single thread. When context is full:

    * Send **`/compact`** to compress the current conversation. Your agent will summarize the context and continue with more room.
    * Send **`/new`** to start a fresh conversation thread. Your agent's long-term memory still carries over — only the immediate conversation context resets.

    <Tip>
      For long-running sessions or complex projects, use `/compact` periodically to keep your agent performing at its best.
    </Tip>
  </Accordion>

  <Accordion title="How do I reset my conversation?">
    Send **`/new`** to start a fresh conversation. This clears the current conversation context but does **not** erase your agent's long-term memory. It still remembers past conversations, your preferences, and your standing instructions.

    If you want to switch models at the same time, send `/new` followed by the model name (e.g., `/new claude-sonnet`).
  </Accordion>

  <Accordion title="How do I change my AI model?">
    You have two options:

    1. **Dashboard** — go to your [dashboard](https://ultraclaw.ai/dashboard) and use the model selector dropdown
    2. **Slash command** — send `/new model-name` to start a new conversation with a different model (e.g., `/new gpt-4o` or `/new claude-sonnet`)

    See [Models](/assistant/models) for a full list of available models on your plan.
  </Accordion>

  <Accordion title="How do I check my token usage?">
    * Send **`/context`** to your agent for a quick usage summary
    * Visit your [dashboard](https://ultraclaw.ai/dashboard) for a detailed breakdown of token usage, remaining balance, and billing cycle

    All plans include \$15/mo in AI credits. If you need more, you can top up from the dashboard.
  </Accordion>
</AccordionGroup>

## Channel Issues

<AccordionGroup>
  <Accordion title="iMessage not working">
    If you're not receiving iMessage responses:

    1. **Check your dashboard** — go to [ultraclaw.ai/dashboard](https://ultraclaw.ai/dashboard) and verify that your iMessage channel shows as "Connected"
    2. **Verify your phone number** — make sure the number in your account settings matches the number you're texting from
    3. **Check iMessage settings** — on your iPhone, go to Settings → Messages and confirm iMessage is turned on
    4. **Try WebChat** — send a message via the dashboard to confirm your agent is running

    If iMessage still isn't working, [contact support](/troubleshooting/contact-support). Include your phone number and a screenshot of your dashboard channel status.
  </Accordion>

  <Accordion title="WhatsApp disconnected">
    WhatsApp connections can occasionally drop. To reconnect:

    1. Go to your [dashboard](https://ultraclaw.ai/dashboard)
    2. Navigate to the WhatsApp channel settings
    3. Click **Reconnect** to generate a new QR code
    4. Scan the QR code with your WhatsApp app

    Your conversation history and memory are preserved — reconnecting only re-establishes the messaging link.
  </Accordion>

  <Accordion title="Telegram bot not responding">
    If your Telegram bot isn't responding:

    1. Make sure you're messaging the correct bot — check the bot username in your [dashboard](https://ultraclaw.ai/dashboard)
    2. Send `/start` to the bot to reinitialize the conversation
    3. Check that you haven't blocked the bot

    If the issue persists, disconnect and reconnect Telegram from your dashboard.
  </Accordion>
</AccordionGroup>

## Integration Issues

<AccordionGroup>
  <Accordion title="Integration shows 'Disconnected'">
    OAuth connections can expire. To reconnect:

    1. Go to your [dashboard](https://ultraclaw.ai/dashboard)
    2. Find the disconnected integration
    3. Click **Reconnect** to re-authorize

    Your agent will immediately regain access once reconnected.
  </Accordion>

  <Accordion title="My agent can't access my calendar/email">
    Make sure:

    1. The integration is connected (check your dashboard)
    2. You granted the correct permissions during OAuth setup
    3. You're asking about the right account (if you have multiple Google accounts)

    If the integration is connected but not working, try disconnecting and reconnecting it from the dashboard.
  </Accordion>
</AccordionGroup>

## Still Need Help?

<Card title="Contact Support" icon="headset" href="/troubleshooting/contact-support">
  Can't find your answer? Reach out to our support team and we'll help you get back on track.
</Card>