Troubleshooting

Bot not responding

Symptom: You send a message to your Telegram bot but get no reply.

Possible causes:

1. Container is still provisioning. Wait 60 seconds after deployment and try again.
2. Invalid bot token. Double-check the token in your dashboard matches what BotFather gave you. Tokens look like 123456789:ABCdefGHI....
3. Bot token was regenerated. If you used /token in BotFather to create a new token, the old one stops working. Update it on the ClawLuv dashboard and redeploy.
4. Telegram outage. Check Telegram's status for service disruptions.

Slow responses

Symptom: Your bot takes 10+ seconds to respond.

Possible causes:

1. Complex queries. If your message requires web search, image analysis, or multiple tool calls, responses naturally take longer.
2. Model latency. During peak hours, AI model APIs can be slower. This is usually temporary.
3. Memory retrieval. If your agent has a large conversation history, vector search can add 1–2 seconds.

What to do: If responses are consistently slow (30+ seconds), contact support. We may need to check your container's health.

Voice notes not transcribing

Symptom: You send a voice note but the agent doesn't acknowledge the audio content.

Possible causes:

1. Whisper skill not installed. Check your dashboard to make sure voice transcription is enabled.
2. Audio format issue. Telegram voice notes use .ogg format which is supported by default. If you're sending audio files in other formats, they may not be processed.
3. File size. Voice notes longer than ~10 minutes may time out during transcription.

Images not being analyzed

Symptom: You send a photo but the agent responds as if it didn't see it.

Possible causes:

1. Image analysis skill not enabled. Verify it's active in your dashboard.
2. Compressed photos. Telegram compresses photos by default. If you need the agent to read fine text in an image, send it as a "file" instead of a "photo" in Telegram.
3. Model doesn't support vision. Make sure your selected model supports image input.

"Container unavailable" error

Symptom: The dashboard shows your container as unavailable or offline.

What to do:

1. Click Restart on your dashboard. Most container issues resolve with a restart.
2. If the container keeps crashing, check your custom system prompt for issues — extremely long prompts can cause startup failures.
3. Contact hello@clawluv.com if the issue persists after a restart.

Billing questions

How do I cancel?

Go to your ClawLuv dashboard, click your profile, then Manage Billing. This opens the Stripe customer portal where you can cancel your subscription. Your agent stays active until the end of the current billing period.

Will I lose my data?

When your subscription ends, your container is paused (not deleted) for 30 days. If you resubscribe within that window, your agent picks up where it left off with all memory intact. After 30 days, the container and its data are permanently deleted.

Can I switch plans?

Currently there's one plan at $49/month. We're exploring usage-based and team plans — email us if you have specific needs.

Still stuck?

Email hello@clawluv.com or join our Discord community. Include your account email and a description of the issue — screenshots help.