OpenClaw¶

What it is¶

OpenClaw (formerly Clawdbot/Moltbot) is an open-source, self-hostable autonomous AI agent platform designed for deploying personal and team agents. It runs as a lightweight TypeScript "Gateway" process that interfaces with 50+ messaging channels (Telegram, WhatsApp, Signal, Discord, Slack) and manages persistent local memory, fully supporting the MCP 3.0 Task Protocol as of July 2026.

What problem it solves¶

Setting up a personal AI agent that works continuously and integrates with local system resources normally requires complex orchestration. OpenClaw simplifies this by providing a single-port Gateway (18789) that bridges LLMs (GPT-5.5, Claude 4.8, or Gemma 3) to the user's local operating system and messaging apps, utilizing FastMCP 3.0 for rapid tool execution.

Where it fits in the stack¶

Agent Runtime / Orchestration Layer. OpenClaw is the execution environment for autonomous behaviors. It sits between the user's communication channels and the model inference provider (LiteLLM), utilizing MCP 3.0 for seamless tool integration.

Typical use cases¶

Personal Assistant: Manage tasks in Vikunja or Home Assistant via chat.
Local File Automation: Organize downloads, process receipts (OCR), and update local databases autonomously.
CI/CD Remediation: Automatically analyze build failures and draft PR fixes in GitHub using Claude Code.
Scheduled Research: Aggregate web research into a daily briefing via SearXNG.
Gemma 3 Integration: Running local-first agentic workflows with Gemma 3 via MCP.

Strengths¶

Low Latency: Local Gateway architecture ensures fast tool execution and messaging compared to cloud-only platforms.
Privacy-First: Conversation history and vector memory stay on your local device or self-hosted infrastructure.
Extreme Extensibility: 2,300+ community skills on ClawdHub cover almost any API or service.
Model Agnostic: Seamlessly switch between Ollama, Gemma 3, GPT-5.5, and Claude 4.8.
MCP 3.0 Support: Native integration with the latest Model Context Protocol and FastMCP for unified tool access.

Limitations¶

Security Governance: Requires technical knowledge to properly sandbox and secure (see ClawJacked vulnerability notes).
Token Consumption: Autonomous loops can quickly consume API budgets; requires LiteLLM budget management.
macOS/Linux Focus: Windows support is primarily via WSL2/Docker, with some native limitations.

When to use it¶

For tasks requiring multi-step reasoning and action-taking on a local machine or home server.
When you want a ready-to-run personal assistant that works through existing messaging apps like Signal or Discord.
For home-lab automation tied to Ollama, n8n, Paperless-ngx, or Vikunja.

When not to use it¶

For mission-critical tasks where zero autonomous interpretation is required (use n8n instead).
If you are uncomfortable maintaining a self-hosted Docker or Node.js environment.
For purely cloud-native workflows where local system access is not needed.

Getting started¶

Local Installation (macOS/Linux)¶

OpenClaw is optimized for local execution on macOS (Apple Silicon) and Linux.

# One-command installer (Official July 2026 script)
curl -fsSL https://openclaw.io/install.sh | sh

# Start the Gateway
openclaw start

Docker Setup (Self-hosted)¶

For server environments, use Docker to ensure sandboxed tool execution.

services:
  openclaw:
    image: openclaw/openclaw:latest
    ports:
      - "18789:18789"
    environment:
      GATEWAY_PORT: 18789
      LLM_BASE_URL: "http://litellm:4000"
      LLM_MODEL: "claude-4-8-opus"
      SIGNAL_SERVICE_URL: "http://signal-api:8080"
    volumes:
      - ./skills:/app/skills
      - ./memory:/app/memory

CLI examples¶

OpenClaw provides a powerful CLI for managing the agent and its memory:

# Install a skill from ClawdHub
openclaw skill install clawdhub:receipt-processor

# Evaluate agent performance on a specific suite
openclaw eval --suite tests/assistant_bench.yaml

# Inspect the vector memory
openclaw memory query "What did we discuss about the house renovation?"

API examples¶

OpenClaw exposes a REST API (typically on port 18789) for programmatic interaction:

# Trigger a specific skill via API
curl -X POST http://localhost:18789/api/execute \
  -H "Content-Type: application/json" \
  -d '{"skill": "weather-report", "params": {"location": "San Francisco"}}'

# Query the agent's status
curl http://localhost:18789/api/status

LiteLLM — Recommended model router and inference plane.
Claude Code — For agentic coding and terminal-based automation.
OpenHands — For code-heavy engineering tasks.
n8n — For deterministic, non-conversational workflows.
Ollama — Local model inference engine.
Gemma 3 — Recommended local model for agentic tasks.
Model Context Protocol — Standard for agentic tool use.
Nanoclaw — Lightweight, containerized alternative.

Sources / references¶

Contribution Metadata¶

Last reviewed: 2026-07-21
Confidence: high