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.

Your agents keep their full power — MCP servers, filesystem access, tools, config — RemoteClaw just bridges the messaging layer. 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.

Claude Code is the default runtime. See each CLI's own docs for setup. Set runtime in your config to switch runtimes.

4. Start the gateway

remoteclaw

5. Test

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

To use a different runtime (Gemini, Codex, OpenCode), set runtime in your config. See the configuration reference for all 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

• Use your agents from anywhere — message your Claude/Gemini from WhatsApp, Telegram, Slack, Discord, or any supported channel. One agent, all your surfaces.
• Your config, your tools, your rules — agents run with your ~/.claude, your MCP servers, your filesystem. RemoteClaw doesn't touch the agentic loop.
• 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.