RemoteClaw

Any OS gateway for AI agents across WhatsApp, Telegram, Discord, iMessage, and more.

Send a message, get an agent response from your pocket. Plugins add Mattermost and more.

Get Started

Get Started — Install RemoteClaw and bring up the Gateway in minutes.

Setup

Setup — Configure auth, gateway settings, and optional channels.

Open the Control UI

Open the Control UI — Launch the browser dashboard for chat, config, and sessions.

What is RemoteClaw?

RemoteClaw is AI agent middleware that connects agent CLIs (Claude, Gemini, Codex, OpenCode) to messaging channels — WhatsApp, Telegram, Discord, iMessage, and more. You run a single Gateway process on your own machine (or a server), and it becomes the bridge between your messaging apps and your agent CLIs.

Who is it for? Developers and power users who want to run agent CLIs remotely via messaging channels — without giving up control of their data or relying on a hosted service.

What makes it different?

Self-hosted: runs on your hardware, your rules
Multi-channel: one Gateway serves WhatsApp, Telegram, Discord, and more simultaneously
Agent-native: built for coding agents with tool use, sessions, memory, and multi-agent routing
Open source: AGPL-3.0 licensed, community-driven

What do you need? Node 22+, an API key (Anthropic recommended), and 5 minutes.

How it works

flowchart LR
  A["Chat apps + plugins"] --> B["Gateway"]
  B --> C["Agent runtime"]
  B --> D["CLI"]
  B --> E["Web Control UI"]
  B --> F["macOS app"]
  B --> G["iOS and Android nodes"]

The Gateway is the single source of truth for sessions, routing, and channel connections.

Key capabilities

Multi-channel gateway

WhatsApp, Telegram, Discord, and iMessage with a single Gateway process.

Plugin channels

Add Mattermost and more with extension packages.

Multi-agent routing

Isolated sessions per agent, workspace, or sender.

Media support

Send and receive images, audio, and documents.

Web Control UI

Browser dashboard for chat, config, sessions, and nodes.

Mobile nodes

Pair iOS and Android nodes with Canvas support.

Quick start

Install RemoteClaw
Terminal window
```
npm install -g remoteclaw@latest
```
Onboard and install the service
Terminal window
```
remoteclaw onboard --install-daemon
```

Pair WhatsApp and start the Gateway

remoteclaw channels login
remoteclaw gateway --port 18789

Need the full install and dev setup? See Quick start.

Dashboard

Open the browser Control UI after the Gateway starts.

Local default: http://127.0.0.1:18789/
Remote access: Web surfaces and Tailscale

Configuration (optional)

Config lives at ~/.remoteclaw/remoteclaw.json.

If you do nothing, RemoteClaw uses the default CLI agent runtime with per-sender sessions.
If you want to lock it down, start with channels.whatsapp.allowFrom and (for groups) mention rules.

Example:

{
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: { "*": { requireMention: true } },
    },
  },
  messages: { groupChat: { mentionPatterns: ["@remoteclaw"] } },
}

Start here

Docs hubs

Docs hubs — All docs and guides, organized by use case.

Configuration

Configuration — Core Gateway settings, tokens, and provider config.

Remote access

Remote access — SSH and tailnet access patterns.

Channels

Channels — Channel-specific setup for WhatsApp, Telegram, Discord, and more.

Nodes

Nodes — iOS and Android nodes with pairing and Canvas.

Help

Help — Common fixes and troubleshooting entry point.

Learn more

Full feature list

Full feature list — Complete channel, routing, and media capabilities.

Multi-agent routing

Multi-agent routing — Workspace isolation and per-agent sessions.

Security

Security — Tokens, allowlists, and safety controls.

Troubleshooting

Troubleshooting — Gateway diagnostics and common errors.

About and credits

About and credits — Project origins, contributors, and license.