OpenClaw on Mobile: How to Control Your AI Agent From Your Phone
Full setup guide: Telegram bot, remote commands, mobile workflow tips. Your AI agent in your pocket — no cloud subscription required.
Why Mobile Control Matters in 2026
Anthropic just shipped Claude Dispatch — a feature that lets you prompt Claude from your phone while it controls your desktop. The developer community immediately noticed: phone-to-agent control is the workflow that actually unlocks AI productivity.
But there's a difference. Claude Dispatch routes everything through Anthropic's servers. Every command you send, every task your agent runs, every file it touches — all logged, all processed in the cloud. OpenClaw takes a different approach: your agent runs on your server, and you talk to it over Telegram. Same capability. Zero cloud lock-in.
The X/Twitter community has been circulating the real math: "Hetzner/DigitalOcean $5-8/mo + OpenClaw free = full agent stack." That tweet has legs because it's true. This guide shows you how to set it up.
100% Private
Your commands never touch Anthropic or OpenAI servers. End-to-end yours.
Always-On
Agent runs 24/7 on your VPS. Respond to tasks while you're away from your desk.
Native Mobile
Telegram is already on your phone. No new app. No login. Just message your agent.
How OpenClaw Mobile Works
The architecture is simple. OpenClaw runs on a server (your VPS, Mac mini, or Raspberry Pi). It connects to a Telegram Bot token at startup. From that moment, any message you send to your bot triggers the agent — which processes your request, runs tools, and sends back a response.
# The flow:
Your LLM API key (Anthropic, OpenAI, etc.) goes from your server directly to the provider — never through Telegram. Telegram only carries the text of your messages. This means your agent can browse the web, run shell commands, search files, and execute automations — all triggered from your phone — without any of that activity passing through a cloud AI middleman.
Prerequisites
Before you start, make sure you have:
OpenClaw installed and running
On a VPS, Mac mini, or local machine. See the full setup guide if not.
A Telegram account
Free. Download the app on iOS or Android if you don't have it.
An LLM API key
Anthropic (Claude), OpenAI, or any supported provider. From ~$0.01/message.
A server (recommended, not required)
A VPS gives you 24/7 uptime. Without one, your agent only responds when your computer is on.
Step 1: Create Your Telegram Bot
Telegram bots are created through BotFather — Telegram's official bot management system. This takes about 2 minutes.
Open BotFather
In Telegram, search for @BotFather (blue checkmark). Start a conversation.
Create a new bot
Send /newbot. BotFather will ask for a name (display name, e.g. "My Agent") then a username (must end in "bot", e.g. "myagent_bot").
Copy your token
BotFather replies with a token like 1234567890:AAFqV1WAoDxZP9dAt8wMp4BWaWi5s-MUrIs. Save this — you'll need it next.
Get your Telegram user ID
Message @userinfobot in Telegram. It replies with your numeric user ID (e.g. 87654321). This is your authorised user ID for OpenClaw.
Example BotFather session:
You: /newbot
BotFather: Alright, a new bot. How are we going to call it?
You: My OpenClaw Agent
BotFather: Good. Now let's choose a username for your bot.
You: myopenclaw_bot
BotFather: Done! Congratulations on your new bot.
Use this token to access the HTTP API:
8311048617:AAFqV1WAoDxZP9dAt8wMp4BWaWi5s-MUrIs
Keep your token secure — it controls your bot.Step 2: Configure OpenClaw for Telegram
OpenClaw reads its Telegram config from its config file or environment variables. Open your OpenClaw config (typically ~/.openclaw/config.json or the dashboard) and add:
{
"plugins": {
"telegram": {
"enabled": true,
"token": "YOUR_BOT_TOKEN_FROM_BOTFATHER",
"allowedUsers": [YOUR_NUMERIC_TELEGRAM_ID],
"prefix": "",
"parseMode": "Markdown"
}
}
}Then restart OpenClaw:
# If running with PM2:
pm2 restart openclaw
# If running directly:
openclaw start
# Verify it connected:
openclaw statusNow open Telegram, find your bot, and send it a message: "hello". Your agent should respond within a few seconds. If it does — you're live.
Troubleshooting tip
If the bot doesn't respond, check that your allowedUsers array contains your correct numeric ID (not your username). Also ensure your VPS firewall allows outbound HTTPS on port 443 for the Telegram API.
Key Commands Reference
Once connected, you talk to OpenClaw in plain English — no special syntax required. But there are some patterns that work especially well from mobile:
What's on my agenda today?Agent checks calendar, todos, pending tasksAdd a task: [description]Creates task in Things, Notion, or your configured toolWhat did you do in the last hour?Summary of completed agent actionsSearch the web for [topic] and summariseFull web search from your phoneRead [URL] and give me the key pointsAgent fetches and summarises any URLWhat's the latest on [topic]?Agent searches and synthesises newsCheck if my server at [IP] is onlineAgent pings and reports statusShow me the last 20 lines of [log file]Remote log access from phoneRun the deploy script for [project]Trigger scripts remotely via agent/statusAgent health, uptime, current model/reasoning onEnable extended reasoning mode/model claude-opus-4-6Switch active model mid-conversationMobile Workflow Tips
The best OpenClaw builders on X and Discord have converged on a few patterns that make mobile control genuinely useful — not just a novelty.
Morning brief on wake-up
Set a cron job to run at 7 AM and message you a daily digest: calendar, weather, inbox priority, market moves. You read it before you get out of bed.
# In OpenClaw cron config:
"0 7 * * *": "Send me a morning brief with today's calendar, top 3 emails, and weather"Push notifications for agent completions
When a long-running task finishes (a code generation, a web scrape, a report), have the agent message you on Telegram instead of leaving you waiting at your desk.
# Example: end a long task with a ping
"When done, message me on Telegram with the result summary"Send files and images via Telegram
Photo you took at a whiteboard? Forward it to your agent. It can read text, extract diagrams, and turn them into structured notes — all from your camera roll.
# Just send the image with a caption:
"Transcribe this whiteboard and format as markdown"Telegram shortcuts on iOS/Android
Create Telegram quick-reply shortcuts for your most common agent prompts. On iOS, use Shortcuts.app to send a Telegram message to your bot with one tap.
Security & Access Control
Your Telegram bot token is effectively a remote control for your server. Treat it like a password. The allowedUsers list is your first line of defence — OpenClaw will silently ignore any messages from IDs not on that list.
Never share your bot token
Anyone with the token can message your bot. If it leaks, revoke it immediately via BotFather (/revoke).
Allowlist only yourself
Set allowedUsers to only your numeric Telegram ID. OpenClaw ignores all other senders.
Use a VPS firewall
Allow only outbound HTTPS. Block all inbound ports except SSH and what OpenClaw needs.
Audit the action log
Ask your agent: "What have you done in the last 24 hours?" for a full action audit trail.
Your Agent. Your Phone. No Cloud.
OpenClaw on mobile isn't a feature — it's the whole point. An AI agent you control, on hardware you own, accessible from anywhere. The full setup guide walks you through every step.
* Affiliate link. We earn a small commission — it helps keep this guide free.