Everything you need to set up and use ClawCloud.
To bring your AI agent online, you first need to create a bot through Telegram's official bot manager @BotFather and obtain its API token:
@BotFather. Make sure the account has the official blue checkmark. Open the chat and press Start./newbot in the chat.my_ai_agent_bot).1234567890:ABCdefGhIJKlmNoPQRsTUVwxyZ). On mobile, tap the token to copy it instantly.⚠️ Treat this token like a password — keep it safe and never share it.
t.me/your_bot_name), open the chat, and press Start. This is required for the bot to interact with you.So ClawCloud knows who to send messages and notifications to, you also need to bind your personal User ID:
@userinfobot.123456789).After you enter the Token and User ID and click "Save binding" in the dashboard, the system deploys your dedicated AI assistant in the background. You'll receive the following notifications in Telegram to confirm progress:
Right after you save, your Telegram bot sends this message. It means the system has verified your data and is provisioning resources:
About 1-3 minutes later, the bot sends a second message. When you see this, your AI assistant is fully online:
🎉 You can now chat directly with your AI assistant in Telegram!
Your subscription plan includes a monthly credit allowance. Every AI interaction deducts credits based on usage (input, output, and add-ons). Check your remaining balance on the dashboard anytime.
| Item | Credits deducted | How it works |
|---|---|---|
| Input Tokens | 1 credit / 1K tokens | The base unit of pricing. Each 1,000 tokens processed costs 1 credit. |
| Output Tokens | 6 credits / 1K tokens | Generation is more compute-intensive, so output costs 6× input. |
| Search (web search) | 20 credits / call | Fixed fee for each external web search the AI performs. |
After you sign up and verify your email, you receive 1,000 credits free to explore the AI agent.
ClawCloud offers two subscription plans. Your balance splits into a "monthly allowance" and "permanent credits" — the system uses monthly allowance first.
| Plan | Monthly fee | Monthly credits | Highlights |
|---|---|---|---|
| Starter | $15 | 26,000 credits | For light users and everyday conversational help. |
| Pro | $29 | 60,000 credits | Best valueLower per-credit cost — ideal for anyone with heavy AI workflow use. |
If you have a heavy month, you can buy permanent credits anytime. These never expire and stay with your account until used:
Manage your subscription anytime through the secure Customer Portal:
When you upgrade from Starter to Pro, you only pay the difference, and the system immediately tops up the plan difference in credits (e.g. an additional 34,000 credits) so you can continue seamlessly.
If you downgrade or cancel, your current service and credits remain active until the current billing period ends. The new plan takes effect on your next billing date. If you cancel, your data and settings are preserved — you're welcome to come back anytime.
So your AI agent can access external services (e.g. a specific language model or third-party API), you can configure API Keys and environment variables in the dashboard:
OPENAI_API_KEY).Your security is our priority. Every API key and env var configured here is written directly to your dedicated bot's .env file and stored on a protected Persistent Volume. This data is never uploaded or backed up to our cloud database — only your application reads it at runtime.
If your AI agent needs additional config files (e.g. config.yaml, service-account.json), you can upload them safely to the bot's workspace from the dashboard:
.config/.Your AI agent code should read settings from ./.config/your_file. For example, an uploaded data.json lives in a hidden folder under the working directory. These files are stored in your dedicated Persistent Volume for maximum privacy.