Rudder: Remote AI Agent Orchestration by rushit kalariaRudder: Remote AI Agent Orchestration by rushit kalaria

Rudder: Remote AI Agent Orchestration

rushit kalaria

AI Agent Orchestrator

AI Automation

AI Agent Developer

Anthropic

Telegram API

Electronics

Rudder

Remote orchestration for AI agents — from your phone. Monitor, control, and approve your agents via Telegram from anywhere, on any device.

"Rudder puts every developer in the captain's chair of their AI agents."

What is Rudder?

You build AI agents. They run on your machine. But when you're away from your desk, you're flying blind.

Rudder lets you orchestrate, monitor, and approve your AI agents from anywhere via Telegram:

Ask questions in plain English ("what's my agent doing?")

Approve or deny tool calls before they execute

Run commands on your machine remotely

Check logs and file contents from your phone

Browse the web — fill forms, click buttons, scrape sites (via OpenClaw)

Quick Start

Then open Telegram and message your bot.

What Rudder Can Do

Tool Example Read files "show me the last 20 lines of app.log" Run commands "run my_script" → Approve/Deny on phone List files "what files are in my project?" Write files "create a config file with these settings" Browse the web "go to acme.com and find the contact email" Fill forms "sign up on that site with my email" Answer questions "what's the status of my agent?"

Browser Automation (via OpenClaw)

Rudder includes a browser tool powered by OpenClaw — giving your agent real browser control: navigate websites, fill forms, click buttons, and scrape content.

Prerequisites

Install OpenClaw: npm install -g openclaw

Configure your model: openclaw onboard

Start the gateway: openclaw gateway (keep this terminal open)

How it works

When your agent needs to do anything on the web, it uses the browser tool — which delegates to OpenClaw running on your machine:

OpenClaw handles JavaScript-heavy sites, login flows, React forms, and anything that requires a real browser. You see the task appear in Telegram for Approve/Deny just like any other tool call.

Example prompts

Requirements

Python 3.10+

A Telegram account and bot token (free)

An API key for your chosen AI model

OpenClaw (optional — for browser/web tools)

Supported Models

Rudder works with any of these AI providers — pick one during rudder init:

Provider Models Install Claude / Anthropic (recommended) claude-sonnet-4-6, claude-opus-4-6 pip install rudder-ai[anthropic] OpenAI gpt-4o, gpt-4-turbo, gpt-3.5-turbo pip install rudder-ai[openai] Grok / xAI grok-3-beta, grok-2 pip install rudder-ai[openai] Ollama (local, free) llama3, mistral, phi3, gemma, any pip install rudder-ai Custom Any OpenAI-compatible API pip install rudder-ai[openai]

Custom option supports Groq, Together.ai, Mistral, Azure OpenAI, and any provider with an OpenAI-compatible endpoint.

Setup — Step by Step

Step 1 — Create a Telegram bot

Open Telegram and search for @BotFather (official blue checkmark)

Send this message: /newbot

BotFather will ask: "What's the name of your bot?"

This is the display name shown in chats — e.g. My Agent Bot

BotFather will ask: "What username would you like to give it?"

Must end in bot — e.g. myagent_bot or MyAgentBot

Must be unique across all of Telegram

BotFather will reply with your bot token — it looks like:

Copy and save this token — you'll need it in Step 4

Step 2 — Get your Telegram user ID

Rudder only accepts messages from you — it needs your personal user ID to enforce this.

Open Telegram and search for @userinfobot

Send any message (e.g. /start)

It will reply with your Id number — e.g. 123456789

Copy this number

Step 3 — Get an API key for your chosen model

Claude (recommended)

Go to console.anthropic.com

Copy the key — starts with sk-ant-...

OpenAI

Go to platform.openai.com

Copy the key — starts with sk-...

Grok / xAI

Go to console.x.ai

Copy the key

Ollama (local — no API key needed)

Install Ollama from ollama.com

Run: ollama pull llama3 (or any model you want)

No API key required

Step 4 — Install and configure Rudder

Open a terminal in your project folder, then run:

Then run the setup wizard:

The wizard will ask for:

Your Telegram bot token (from Step 1)

Your Telegram user ID (from Step 2)

Your working directory — the folder Rudder should have access to

Your AI model provider and API key (from Step 3)

Tip: Run rudder init from inside your project folder. When asked for the working directory, press Enter to use the current folder.

This creates a rudder.yaml file. Keep it safe — it contains your API keys.

Step 5 — Start Rudder

You should see:

Step 6 — (Optional) Enable browser tools

To give Rudder real browser control:

Once the gateway is running, Rudder's browser tool becomes available automatically. No config changes needed.

Step 7 — Message your bot

Open Telegram, search for your bot by its username (e.g. @myagent_bot), and send a message.

Try:

hello

what files are in my project?

show me the contents of app.log

go to example.com and tell me what it sells

Configuration Reference

Your rudder.yaml file supports these options:

Troubleshooting

Bot doesn't respond

Make sure rudder start is running in your terminal

Check that your bot token in rudder.yaml is correct

Try sending /start to your bot first

"Unauthorized" error

Your allowed_user_id in rudder.yaml doesn't match your actual Telegram ID

Re-check your ID with @userinfobot

"Working directory not found" error

The working_dir path in rudder.yaml doesn't exist on your machine

Update it to a valid folder path

Bot stops when I close the terminal

This is expected — the bot runs in your terminal session

For always-on usage, set it up as a background service

Browser tool returns "OpenClaw returned no response"

Make sure openclaw gateway is running in a separate terminal

The gateway must be running before Rudder starts browser tasks

Security

Only your Telegram user ID can send commands

Destructive actions (bash, file writes, browser) require explicit Approve/Deny on your phone

Your API keys stay on your machine — never sent anywhere else

Self-hosted: you control everything

Roadmap

Telegram channel

Bash, read/write file, list files tools

Approve/Deny on mobile

pip install rudder-ai — installable package

rudder init setup wizard

Multi-model support — Claude, OpenAI, Grok, Ollama, any OpenAI-compatible API

Browser tool — real browser automation via OpenClaw

Discord channel

Custom plugin tools

pip install rudder-ai[github] — GitHub tools

License

MIT

Like this project

Posted Apr 23, 2026

Developed Rudder for remote orchestration of AI agents via Telegram.

Likes

Views