Skip to main content

​
Welcome to SimpleClaw

SimpleClaw is a personal AI assistant you run on your own devices. It answers you on the 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

Messaging Channels

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

Voice & Canvas

Always-on speech for macOS, iOS, and Android with live visual workspace

CLI Reference

Complete command-line interface documentation

​
Key Features

Connect to WhatsApp, Telegram, Slack, Discord, Google Chat, Signal, iMessage, Microsoft Teams, Matrix, Zalo, and more. All channels route through a single WebSocket gateway that manages sessions, presence, and message delivery.
Route messages to isolated agents with separate workspaces and sessions. Configure routing by channel, account, peer, or guild with precedence chains for flexible control.
Always-on speech interaction for macOS, iOS, and Android. Use voice wake for hands-free activation and talk mode for continuous conversation with ElevenLabs integration.
Agent-driven visual workspace with A2UI (Agent-to-UI) for pushing dynamic content, evaluating code, and taking snapshots. Available on macOS, iOS, and Android.
Dedicated SimpleClaw-managed Chrome/Chromium with CDP (Chrome DevTools Protocol) control for snapshots, actions, uploads, and profile management.
macOS menu bar app, iOS app, and Android app for seamless integration with your devices. Apps support canvas, voice, camera, screen recording, and more.
Built-in cron jobs, webhooks, and Gmail Pub/Sub integration for scheduled tasks and event-driven workflows.
Bundled, managed, and workspace skills with install gating and UI integration for extending capabilities.
DM pairing system with allowlists ensures only approved contacts can reach your assistant. Run simpleclaw doctor to check security configuration.
Single WebSocket control plane at ws://127.0.0.1:18789 manages all sessions, channels, tools, and events locally on your device.

​
Architecture Overview

SimpleClaw consists of several key components: 
WhatsApp / Telegram / Slack / Discord / Signal / iMessage / ...
               │
               ▼
┌───────────────────────────────┐
│          Gateway              │
│       (control plane)         │
│    ws://127.0.0.1:18789       │
└──────────────┬────────────────┘
               │
               ├─ Pi agent (RPC)
               ├─ CLI (simpleclaw ...)
               ├─ WebChat UI
               ├─ macOS app
               └─ iOS / Android nodes

​
Gateway

The Gateway is a local WebSocket server that:
  • Manages connections to messaging channels
  • Routes inbound messages to AI agents
  • Handles session storage and presence
  • Executes scheduled tasks (cron jobs)
  • Serves the Control UI and WebChat
  • Coordinates with device nodes for local actions

​
Agents

Each Agent has:
  • Isolated workspace directory
  • Independent model configuration
  • Separate session storage
  • Custom skills and tools
  • Routing rules for channel/account/peer

​
Channels

Supported messaging platforms:
  • WhatsApp (Baileys)
  • Telegram (grammY)
  • Discord (discord.js)
  • Slack (Bolt)
  • Signal (signal-cli)
  • iMessage (BlueBubbles or legacy)
  • Microsoft Teams, Matrix, Zalo (extensions)
  • WebChat (built-in web interface)

​
Next Steps

1

Install SimpleClaw

Follow the Installation Guide to get SimpleClaw running on your system.
2

Run the Quickstart

Complete the Quickstart to have your first chat in under 5 minutes.
3

Add Channels

Connect your messaging platforms with the Channels Guide.
4

Explore Features

Try Voice, Canvas, and Browser Control.

​
Requirements

  • Node.js: Version 22 or higher
  • Operating System: macOS, Linux, or Windows (via WSL2)
  • Package Manager: npm, pnpm, or 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