Troubleshooting

Something not working? Start here. This guide covers the most common issues and how to fix them.

9.1 Setup Issues

App Won't Start

Symptoms: You double-click noHuman Team and nothing happens, or it crashes immediately.

Try these:

1. Restart your computer — Clears any stuck processes
2. Check system requirements — Make sure your OS version is supported (macOS 12+, Windows 10+, Ubuntu 20.04+)
3. Re-run the install script — The install may have been interrupted or corrupted
4. macOS: Check security settings — Go to System Settings → Privacy & Security and allow noHuman Team to run
5. Windows: Run as administrator — Right-click the app → Run as Administrator

If none of these work, contact support with your OS version and any error messages you see.

Wizard Stuck / API Key Not Accepted

Symptoms: The setup wizard won't move past the API key step.

Try these:

1. Check your key — Copy it again from your provider's dashboard. Make sure there are no extra spaces before or after.
2. Check your internet — The wizard needs to contact your AI provider to validate the key
3. Check your billing — Most providers require a payment method before API keys work. Go to your provider's billing page and add a card.
4. Try a different key — Generate a new key from your provider's dashboard
5. Check provider status — Your AI provider might be having an outage. Check their status page:
   • Anthropic: status.anthropic.com
   • OpenAI: status.openai.com

noHumans Not Coming Online

Symptoms: Setup completed, but one or more noHumans show a red or gray dot.

Try these:

1. Wait 30 seconds — noHumans sometimes take a moment to start
2. Check your API key — Go to Settings → API Keys and verify the key is valid
3. Restart the noHuman — Right-click the noHuman → Restart
4. Restart noHuman Team — Close and reopen the app
5. Check logs — Go to the activity log and look for error messages (red entries)

9.2 Runtime Issues

noHuman Not Responding

Symptoms: You sent a task but the noHuman hasn't replied.

How long has it been?

• Under 2 minutes — Some tasks take time. Complex requests (writing long content, building code) can take a few minutes. Wait a bit.
• Over 5 minutes — Something might be stuck. Try:
  1. Check the noHuman's status — Is it yellow (working) or red (error)?
  2. Check the activity log — Look for errors
  3. Restart the noHuman — Right-click → Restart
  4. Simplify your request — Break a complex task into smaller pieces

Tasks Not Completing

Symptoms: A noHuman started working but never finishes.

Try these:

1. Check noHuman status — If it's yellow, it's still working. Some tasks are genuinely long.
2. Look at the conversation — The noHuman may have asked a question you missed
3. Restart the noHuman — This forces it to save its progress and start fresh
4. Rephrase the task — Sometimes rewording helps: be more specific about what you want

Dashboard Not Loading

Symptoms: The app opens but the dashboard is blank or shows an error.

Try these:

1. Wait 10 seconds — The dashboard loads data on startup
2. Restart noHuman Team — Close and reopen
3. Check if the gateway is running — Go to Settings → Advanced → Terminal and run openclaw gateway status
4. Clear app cache — Go to Settings → Advanced → Clear Cache

9.3 API & Key Issues

"Invalid API Key" Errors

Causes:

• Key was deleted or revoked on your provider's dashboard
• Key was copied incorrectly (extra spaces, missing characters)
• You're using a key from one provider in the wrong provider slot

Fix:

1. Go to your provider's dashboard and verify the key exists and is active
2. Copy the key fresh and update it in Settings → API Keys
3. Make sure the provider dropdown matches your key (Anthropic key in Anthropic slot, etc.)

Rate Limits

Symptoms: noHumans work for a while, then start getting errors. Messages like "rate limit exceeded" or "too many requests."

What's happening: Your AI provider limits how many requests you can make per minute. Multiple noHumans working at once can hit this limit.

Fix:

1. Wait a few minutes — Rate limits reset quickly (usually 1-2 minutes)
2. Reduce simultaneous work — Don't give all four noHumans heavy tasks at the same time
3. Upgrade your API plan — Higher-tier plans have higher rate limits. Check your provider's pricing page.
4. Use different keys — Assign separate API keys to different noHumans (see section 5.4)

Billing / Quota Problems

Symptoms: "Insufficient quota" or "billing not active" errors.

Fix:

1. Go to your AI provider's billing page
2. Check that a payment method is active
3. Check that you haven't hit a spending limit you set
4. Add funds or increase your limit as needed

9.4 Connection Issues

External Channel Not Connecting

Symptoms: You set up Telegram/WhatsApp/Discord but messages aren't going through.

Telegram:

• Verify your Telegram bot token is correct (get a fresh one from BotFather if unsure)
• Make sure you've started a conversation with your Telegram bot (send it /start)
• Check that the Telegram bot isn't blocked

WhatsApp:

• Re-scan the QR code — sessions expire
• Make sure WhatsApp is running on your phone
• Check that your phone has internet access

Discord:

• Verify the Discord bot token and server permissions
• Make sure the bot has been invited to the correct server and channel
• Check that the bot has "Send Messages" permission

Bridge Errors

Symptoms: noHuman-to-noHuman messages aren't being delivered. Errors mentioning "bridge" in the logs.

Try these:

1. Restart noHuman Team — This restarts the message bridge
2. Check logs — Look for specific error messages in Settings → Logs
3. Restart individual noHumans — Sometimes a noHuman loses its connection to the bridge

9.5 Logs & Diagnostics

Where to Find Logs

• Activity log: Dashboard → Logs tab (shows noHuman activity and messages)
• System log: Settings → Advanced → System Logs (shows technical details)
• noHuman-specific log: Click a noHuman → Logs tab (shows only that noHuman's activity)

How to Report a Bug

If you've tried the fixes above and something is still broken:

1. Go to Settings → Advanced → System Logs
2. Click Export Logs — this creates a file with recent system activity
3. Email the log file to support with:
   • What you were trying to do
   • What happened instead
   • What you've already tried
   • Your OS and noHuman Team version (found in Settings → About)