@BotFather. Send /newbot, choose a name and username for your bot. BotFather will give you a bot token.Documentation
Getting Started
Your Clawberry gateway is activated and running. This guide covers everything you need to get the most out of it — from opening the dashboard to connecting chat apps and automating tasks.
Your Gateway at a Glance
Clawberry runs a personal AI gateway on your local network 24/7. It is powered by OpenClaw and connects to AI models through your OpenRouter API key. Once active, it never needs to be set up again — just power it on and it reconnects automatically.
Dashboard URL
Access from any device on your network at
http://ai-gateway.local:18789. Bookmark this.Onboarding URL
If you ever need to re-activate, visit
http://ai-gateway.local/ on port 80.Default AI Model
Claude 3.5 Haiku via OpenRouter. Fast and cost-efficient for everyday tasks.
Power Cycles
Unplug and replug anytime. All services restart automatically — no intervention needed.
Dashboard Guide
Using the Dashboard
The dashboard is your control center. Open it at
http://ai-gateway.local:18789 from any browser on your home network.Dashboard Sections
| Section | What It Does |
|---|---|
| Chat | Direct conversation with your AI. Start new sessions, switch models, and see full response history. |
| Overview | Gateway health status, uptime, connection info, and your WebSocket URL. |
| Channels | Connect and manage external chat apps — Telegram, WhatsApp, Discord, Slack. |
| Instances | Active AI process instances and resource usage. |
| Sessions | All recent session keys. Useful for tracking conversations across channels. |
| Usage | Token consumption and API call statistics. |
| Cron Jobs | Scheduled automated tasks. Create, view, and manage recurring AI jobs. |
| Agents | Agent configuration and identity settings. |
| Skills | Installed capability extensions. Add new skills from the community. |
| Config | Edit your openclaw.json directly from the browser. |
| Logs | Live gateway logs for debugging and monitoring. |
The Chat section is the fastest way to interact with your AI. Type a message and press Enter to get a response.
Authentication
Your Gateway Token
Your gateway token is a unique secret key that authenticates your browser to your AI gateway. It was generated during activation and is stored securely on the device.
Where to Find It
Your token was shown on the activation completion page. It is also stored permanently on the device at:
/home/ubuntu/.openclaw/.env
# Look for the line: OPENCLAW_GATEWAY_TOKEN=...How the Dashboard Link Works
The Open AI Dashboard button on your completion page embeds your token directly in the URL as ?token=YOUR_TOKEN. This means clicking it always connects you automatically — no manual pasting required.
If You're Asked for a Token
Go back to http://ai-gateway.local/complete to see your token. Copy it and paste it into the Overview → Gateway Access → Gateway Token field in the dashboard, then click Connect.
Never share your gateway token. It gives full access to your AI gateway.
Channels
Connecting Chat Apps
Connect your gateway to messaging apps so you can talk to your AI from your phone or any chat platform. All channels connect to the same gateway and share the same AI context.
Telegram
1
Create a Bot
Open Telegram and search for
2
Add Token in Dashboard
In your dashboard go to Channels → Telegram. Paste your bot token and click Save.
3
Start Chatting
Open a chat with your bot in Telegram. Send any message and your AI will respond.
To restrict who can message your bot, ask your AI: "Set allowFrom to only my Telegram user ID".
1
Open Channels in Dashboard
Go to Channels → WhatsApp in your dashboard.
2
Scan QR Code
A QR code will appear. Open WhatsApp on your phone → Settings → Linked Devices → Link a Device → scan the QR code.
3
Send a Message
Message the gateway number from your phone. Your AI will reply directly in WhatsApp.
WhatsApp sessions may occasionally need re-scanning if the connection expires. The dashboard will prompt you when needed.
Discord
1
Create a Discord Bot
Go to discord.com/developers → New Application → Bot → Reset Token → copy the token.
2
Invite Bot to Your Server
Under OAuth2 → URL Generator, select
bot scope and Send Messages permission. Use the generated URL to add the bot to your server.3
Add Token in Dashboard
Go to Channels → Discord. Paste your bot token and click Save.
Slack
1
Create a Slack App
Go to api.slack.com/apps → Create New App → From Scratch. Choose your workspace.
2
Add Bot Scopes
Under OAuth & Permissions, add
chat:write, channels:history, im:history scopes. Install to workspace and copy the Bot User OAuth Token.3
Add Token in Dashboard
Go to Channels → Slack. Paste your bot token and click Save.
AI Models
AI Models & Cost Optimization
Your gateway uses a smart model routing system. The right model is used for the right task — saving API credits without sacrificing quality.
Default Model: Claude 3.5 Haiku
Haiku is used by default for all tasks. It is fast, highly capable, and approximately 12x cheaper per token than Sonnet. It handles the vast majority of tasks — chat, Q&A, writing, browsing, and automation — without any quality trade-off.
Switching to Sonnet
For complex reasoning, architecture decisions, code review, or nuanced analysis, simply ask your AI:
Use Sonnet for this — I need detailed analysis of...Your AI will switch to Claude 3.5 Sonnet for that task and return to Haiku afterward.
| Model | Best For | Cost |
|---|---|---|
| Claude 3.5 Haiku | Chat, writing, browsing, automation, quick tasks | ~$0.00025 / 1K tokens |
| Claude 3.5 Sonnet | Complex reasoning, code review, analysis, strategy | ~$0.003 / 1K tokens |
| GPT-4o Mini | Fallback if Haiku is unavailable | ~$0.00015 / 1K tokens |
Your monthly cost should stay under $5–10 with Haiku as default. Sonnet usage is the main cost driver — use it intentionally.
Memory
Memory & Context
Your AI builds persistent memory across conversations. It loads only what it needs at session start, keeping costs low and responses fast.
How Memory Works
At the start of each session, your AI loads a minimal context file (SOUL.md) with your preferences and rules — under 8KB. When you ask about something from a past conversation, it searches memory on demand rather than pre-loading everything.
What Gets Remembered
Your AI automatically creates daily memory entries at the end of sessions — what was worked on, decisions made, and next steps. This builds a searchable history over time.
Telling Your AI About Yourself
You can speed up the memory process by telling your AI directly:
Remember that I prefer concise responses and work in Pacific timezone.
My main focus right now is building an e-commerce store.Automation
Cron Jobs & Automation
Schedule recurring tasks that run automatically — daily briefings, reminders, status checks, web monitoring, and more. All configured through the dashboard or by asking your AI.
Creating a Cron Job
The easiest way is to ask your AI in Chat:
Every morning at 8am, check the weather and send me a summary via Telegram.Or use the dashboard directly: Cron Jobs → New Job.
Cron Schedule Format
| Schedule | Means |
|---|---|
0 8 * * * | Every day at 8:00 AM |
0 9 * * 1 | Every Monday at 9:00 AM |
*/30 * * * * | Every 30 minutes |
0 */2 * * * | Every 2 hours |
Frequent cron jobs that make API calls can accumulate costs. Use rate limits in your prompts — ask your AI to batch work and keep jobs to what you actually need.
Skills
Skills & Extensions
Skills extend your AI with new capabilities. They range from calendar integrations to custom workflows. You can install community skills or build your own by asking the AI.
Installing Skills
Go to Dashboard → Skills to browse and install available skills. Each skill adds new commands and tools your AI can use.
Building a Custom Skill
Ask your AI to build a skill for any task you repeat regularly:
Build me a skill that checks my website uptime every hour and notifies me if it's down.Your AI will write the skill, test it, and install it — all from the conversation.
Skills are stored in your workspace directory. Your AI can also modify or delete skills on request.
Help
Troubleshooting
Common issues and how to fix them.
Dashboard Shows "Health Offline"
The gateway may still be starting. Wait 20–30 seconds after plugging in, then refresh the page. If it persists, the AI service may have crashed — visit http://ai-gateway.local/ to check the onboarding status.
"Origin Not Allowed" Error
This can appear if you bookmarked the dashboard URL directly without the token parameter. Go back to http://ai-gateway.local/complete and click Open AI Dashboard from there — the URL includes your token automatically.
Dashboard Shows 502 Bad Gateway
The AI service is still starting. The page will auto-refresh with a "starting up" screen. Wait up to 30 seconds. If it doesn't resolve, try a full page refresh with Ctrl + Shift + R.
ai-gateway.local Doesn't Resolve
Make sure you're on the same Wi-Fi network as your Clawberry device. If still not resolving, use the device's IP address directly — find it in your router's connected devices list and navigate to http://[IP]:18789.
AI Not Responding in a Chat App
Check that the channel is still connected: Dashboard → Channels. Some channels (especially WhatsApp) may need to be re-paired after extended inactivity. Click Reconnect or re-scan the QR code.
FAQ
Frequently Asked Questions
Quick answers to common questions.
Can multiple people use the same gateway?
Yes. Anyone on your home network can access the dashboard. For chat apps, multiple people can message the connected bot — each sender gets their own isolated session.
What happens to my data?
All data stays on your device. Your conversations, memory files, and credentials never leave your local network. The only external calls are to OpenRouter's API for AI inference.
How much will it cost per month?
With Claude 3.5 Haiku as default, typical usage runs $3–10/month depending on how actively you use it. Heavy Sonnet usage can increase costs. Check your OpenRouter dashboard for real-time usage tracking.
Can I change my OpenRouter API key?
Yes. Go to http://ai-gateway.local/, which will show your activation status. If you need to reset and re-activate with a new key, contact support.
Does it work without an internet connection?
The gateway itself runs locally, but AI responses require an internet connection to reach OpenRouter's API. On-device AI without internet is not currently supported.
How do I update the AI gateway software?
In the dashboard, go to Overview → Update now when an update is available. The gateway will update and restart automatically. Updates are pulled from the official OpenClaw npm registry.
What if I want to reset and start fresh?
Visit http://ai-gateway.local/ on port 80. If activation has already been completed, this page will redirect you to the completion screen. A full factory reset requires physically connecting to the device — contact support for guidance.