RemoteClaw

RemoteClaw is AI agent middleware. It connects agent CLIs you already run — Claude Code, Gemini CLI, Codex, OpenCode — to the messaging channels you already use, so you can reach your agents from anywhere: your phone, your team Slack, your WhatsApp, anywhere.

RemoteClaw adds messaging reach, persistent sessions, cron scheduling, and 50 MCP tools on top of whatever agent CLI you run. Middleware, not a platform.

Quick Start

Prerequisites: Node.js 22+

1. Install

npm install -g remoteclaw
# or
curl -fsSL https://remoteclaw.sh | bash        # macOS / Linux / Windows (WSL)
irm https://remoteclaw.ps | iex                # Windows (PowerShell)

2. Configure a channel

Create ~/.remoteclaw/remoteclaw.json with a channel adapter. Telegram is the simplest — you only need a bot token from @BotFather:

{
  channels: {
    telegram: {
      botToken: "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11",
    },
  },
}

3. Install and authenticate your agent CLI

RemoteClaw spawns agent CLIs as subprocesses — install the one you want and make sure it's authenticated on the gateway host. The easiest way is to install the CLI and log in, though you can also configure a token or API key through onboarding.

Set runtime in your config to pick your agent CLI — claude, gemini, codex, or opencode. See each CLI's own docs for authentication.

4. Start the gateway

remoteclaw

5. Test

Send a message to your Telegram bot — you should get a reply from the agent.

See the configuration reference for all runtime and channel options.

How It Works

WhatsApp / Telegram / Slack / Discord / Signal / Teams / iMessage / WebChat / ...
               │
               ▼
┌───────────────────────────────┐
│            Gateway            │
│       (control plane)         │
│     ws://127.0.0.1:18789      │
└──────────────┬────────────────┘
               │
               ├─ Agent runtime (Claude, Gemini, Codex, OpenCode)
               ├─ CLI (remoteclaw …)
               ├─ WebChat UI
               ├─ macOS app
               └─ iOS / Android nodes

Why RemoteClaw

• Reach your agent from anywhere — WhatsApp, Telegram, Slack, Discord, or any supported channel. One agent, all your messaging surfaces.
• Agents bring their full toolkit — MCP servers, filesystem, tools all work through the messaging layer. No capability loss.
• Multi-channel, multi-agent — route different channels or contacts to isolated agents, each with their own workspace and session.
• Voice built in — talk to your agent with always-on Voice Wake or push-to-talk on macOS, iOS, and Android.
• Browser, canvas, and device control — agents can browse the web, drive a live visual workspace, snap photos, record screens, and send notifications.
• Secure by default — unknown DMs require pairing codes. Group sessions can run in Docker sandboxes. You control who talks to your agents.
• Companion apps — macOS menu bar app, iOS and Android nodes for device-local actions.
• Runs anywhere — local machine, Linux VPS, Docker container. Remote access via Tailscale or SSH tunnels.

Supported Channels

Plus companion apps for macOS, iOS, and Android.

From Source

git clone https://github.com/remoteclaw/remoteclaw.git
cd remoteclaw
pnpm install && pnpm ui:build && pnpm build
pnpm remoteclaw onboard --install-daemon

See CONTRIBUTING.md for development setup and guidelines.

Learn More

Docs · Getting Started · Configuration · Security · Architecture · Vision · FAQ

Community

See CONTRIBUTING.md for guidelines and how to submit PRs. AI/vibe-coded PRs welcome!

Forked from OpenClaw. See upstream contributors.

License

RemoteClaw is licensed under AGPL-3.0-only.

This project incorporates code from OpenClaw, originally licensed under the MIT License. If you prefer the MIT-licensed version, see the upstream repository.