OpenClaw 🦞

“EXFOLIATE! EXFOLIATE!” — Ein Weltraum-Hummer, wahrscheinlich

OpenClaw

Jedes OS + WhatsApp/Telegram/Discord/iMessage Gateway für AI Agents (Pi).
Plugins fügen Mattermost und mehr hinzu. Schick eine Nachricht, bekomm eine Agent-Antwort — direkt aus der Hosentasche.

GitHub · Releases · Docs · OpenClaw Assistant Setup

OpenClaw verbindet WhatsApp (via WhatsApp Web / Baileys), Telegram (Bot API / grammY), Discord (Bot API / channels.discord.js) und iMessage (imsg CLI) mit Coding Agents wie Pi. Plugins fügen Mattermost (Bot API + WebSocket) und mehr hinzu. OpenClaw betreibt auch den OpenClaw Assistant.

Hier starten

Wenn das Gateway auf demselben Computer läuft, öffnet dieser Link sofort die Browser Control UI. Falls es nicht klappt, starte zuerst das Gateway: openclaw gateway.

Dashboard (Browser Control UI)

Das Dashboard ist die Browser Control UI für Chat, Config, Nodes, Sessions und mehr. Lokal standardmäßig: http://127.0.0.1:18789/ Remote-Zugriff: Web surfaces und Tailscale

OpenClaw

Wie es funktioniert

WhatsApp / Telegram / Discord / iMessage (+ Plugins)
        │
        ▼
  ┌───────────────────────────┐
  │          Gateway          │  ws://127.0.0.1:18789 (loopback-only)
  │     (single source)       │
  │                           │  http://<gateway-host>:18793
  │                           │    /__openclaw__/canvas/ (Canvas host)
  └───────────┬───────────────┘
              │
              ├─ Pi Agent (RPC)
              ├─ CLI (openclaw …)
              ├─ Chat UI (SwiftUI)
              ├─ macOS App (OpenClaw.app)
              ├─ iOS Node via Gateway WS + Pairing
              └─ Android Node via Gateway WS + Pairing

Die meisten Operationen laufen über das Gateway (openclaw gateway), ein einzelner dauerhaft laufender Prozess, der die Channel-Verbindungen und die WebSocket Control Plane verwaltet.

Netzwerk-Modell

  • Ein Gateway pro Host (empfohlen): Es ist der einzige Prozess, der die WhatsApp Web Session besitzen darf. Falls du einen Rescue Bot oder strikte Isolation brauchst, führe mehrere Gateways mit isolierten Profilen und Ports aus; siehe Multiple gateways.
  • Loopback-first: Gateway WS nutzt standardmäßig ws://127.0.0.1:18789.
    • Der Wizard generiert jetzt standardmäßig ein Gateway Token (auch für Loopback).
    • Für Tailnet-Zugriff führe openclaw gateway --bind tailnet --token ... aus (Token ist erforderlich für Non-Loopback Binds).
  • Nodes: Verbinden sich mit dem Gateway WebSocket (LAN/Tailnet/SSH nach Bedarf); die alte TCP Bridge ist deprecated/entfernt.
  • Canvas Host: HTTP File Server auf canvasHost.port (Standard 18793), serviert /__openclaw__/canvas/ für Node WebViews; siehe Gateway configuration (canvasHost).
  • Remote-Nutzung: SSH Tunnel oder Tailnet/VPN; siehe Remote access und Discovery.

Features (Überblick)

  • 📱 WhatsApp Integration — Nutzt Baileys für WhatsApp Web Protokoll
  • ✈️ Telegram Bot — DMs + Gruppen via grammY
  • 🎮 Discord Bot — DMs + Guild Channels via channels.discord.js
  • 🧩 Mattermost Bot (Plugin) — Bot Token + WebSocket Events
  • 💬 iMessage — Lokale imsg CLI Integration (macOS)
  • 🤖 Agent Bridge — Pi (RPC Mode) mit Tool Streaming
  • ⏱️ Streaming + Chunking — Block Streaming + Telegram Draft Streaming Details (/concepts/streaming)
  • 🧠 Multi-Agent Routing — Routen von Provider Accounts/Peers zu isolierten Agents (Workspace + per-Agent Sessions)
  • 🔐 Subscription Auth — Anthropic (Claude Pro/Max) + OpenAI (ChatGPT/Codex) via OAuth
  • 💬 Sessions — Direkte Chats werden in gemeinsame main Session zusammengefasst (Standard); Gruppen sind isoliert
  • 👥 Group Chat Support — Standardmäßig Mention-basiert; Owner kann /activation always|mention umschalten
  • 📎 Media Support — Senden und Empfangen von Bildern, Audio, Dokumenten
  • 🎤 Voice Notes — Optionaler Transkriptions-Hook
  • 🖥️ WebChat + macOS App — Lokale UI + Menüleisten-Companion für Ops und Voice Wake
  • 📱 iOS Node — Pairt als Node und stellt eine Canvas Surface bereit
  • 📱 Android Node — Pairt als Node und stellt Canvas + Chat + Camera bereit

Hinweis: Die alten Claude/Codex/Gemini/Opencode Pfade wurden entfernt; Pi ist der einzige Coding-Agent Pfad.

Quick Start

Runtime-Anforderung: Node ≥ 22.

# Empfohlen: Globale Installation (npm/pnpm)
npm install -g openclaw@latest
# oder: pnpm add -g openclaw@latest

# Onboarding + Service installieren (launchd/systemd User Service)
openclaw onboard --install-daemon

# WhatsApp Web pairen (zeigt QR)
openclaw channels login

# Gateway läuft via Service nach dem Onboarding; manueller Start ist weiterhin möglich:
openclaw gateway --port 18789

Zwischen npm und Git Installs später zu wechseln ist einfach: Installiere die andere Variante und führe openclaw doctor aus, um den Gateway Service Entrypoint zu aktualisieren.

Aus dem Quellcode (Entwicklung):

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # installiert UI Deps beim ersten Lauf automatisch
pnpm build
openclaw onboard --install-daemon

Falls du noch keine globale Installation hast, führe den Onboarding-Schritt via pnpm openclaw ... aus dem Repo aus.

Multi-Instance Quickstart (optional):

OPENCLAW_CONFIG_PATH=~/.openclaw/a.json \
OPENCLAW_STATE_DIR=~/.openclaw-a \
openclaw gateway --port 19001

Test-Nachricht senden (erfordert ein laufendes Gateway):

openclaw message send --target +15555550123 --message "Hello from OpenClaw"

Konfiguration (optional)

Die Config liegt unter ~/.openclaw/openclaw.json.

  • Wenn du nichts tust, nutzt OpenClaw die mitgelieferte Pi Binary im RPC Mode mit per-Sender Sessions.
  • Falls du es absichern willst, starte mit channels.whatsapp.allowFrom und (für Gruppen) Mention-Regeln.

Beispiel:

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

Docs

Der Name

OpenClaw = CLAW + TARDIS — weil jeder Weltraum-Hummer eine Zeit-und-Raum-Maschine braucht.

“Wir spielen alle nur mit unseren eigenen Prompts.” — Eine KI, wahrscheinlich high auf Tokens

Credits

  • Peter Steinberger (@steipete) — Creator, Hummer-Flüsterer
  • Mario Zechner (@badlogicc) — Pi Creator, Security Pen-Tester
  • Clawd — Der Weltraum-Hummer, der einen besseren Namen forderte

Core Contributors

Lizenz

MIT — Frei wie ein Hummer im Ozean 🦞

“Wir spielen alle nur mit unseren eigenen Prompts.” — Eine KI, wahrscheinlich high auf Tokens