Skip to main content

​
Welcome to SimpleClaw

SimpleClaw is a personal AI assistant you run on your own devices. It connects to the messaging channels you already use—WhatsApp, Telegram, Slack, Discord, and more—with powerful features like voice interaction, live canvas, and browser control.

Get Started

Install SimpleClaw and have your first chat in under 5 minutes

Installation

Install via npm, pnpm, or from source

Messaging Channels

Connect WhatsApp, Telegram, Discord, Slack, Signal, and more

Configuration

Configure models, channels, and routing

​
Key Features

Multi-channel Gateway

Connect to 10+ messaging platforms through a single WebSocket gateway

Multi-agent Routing

Route messages to isolated agents with separate workspaces and sessions

Voice & Talk Mode

Always-on speech for macOS, iOS, and Android with ElevenLabs

Live Canvas

Agent-driven visual workspace with A2UI for dynamic content

Browser Control

Dedicated Chrome/Chromium with CDP control for automation

Native Apps

macOS menu bar, iOS, and Android apps with full feature support

Automation

Cron jobs, webhooks, and Gmail Pub/Sub integration

Security First

DM pairing and allowlists for controlled access

​
Architecture

SimpleClaw runs as a local WebSocket gateway that manages all messaging channels, AI agents, and device nodes: 
WhatsApp / Telegram / Slack / Discord / Signal / ...
               │
               ▼
┌──────────────────────────────┐
│         Gateway              │
│     ws://127.0.0.1:18789     │
└──────────────┬───────────────┘
               │
               ├─ AI Agents (multi-agent routing)
               ├─ CLI (simpleclaw ...)
               ├─ WebChat UI
               ├─ macOS app
               └─ iOS / Android nodes
See Core Concepts: Gateway for details on the architecture.

First Chat

Send your first message and understand responses

Add Channels

Connect messaging platforms step by step

Voice Setup

Configure Voice Wake and Talk Mode

CLI Reference

Complete command-line interface documentation

API Reference

WebSocket API and protocol documentation

Troubleshooting

Common issues and solutions

​
Supported Platforms

  • Operating Systems: macOS, Linux, Windows (WSL2)
  • Node.js: Version 22 or higher
  • Package Managers: npm, pnpm, bun

​
Community

SimpleClaw is based on OpenClaw, a personal AI assistant gateway. It follows the same architecture and conventions while providing a streamlined experience.

Build docs developers (and LLMs) love

Get started for freeTalk to us