ScalyClaw Documentation

Welcome to the official documentation for ScalyClaw — the personal AI assistant that scales with your ambition. One mind, every channel, infinite memory.

ScalyClaw is a self-hosted, open-source AI assistant platform designed for a single user. It connects to your messaging channels (Telegram, Discord, Slack, WhatsApp, Signal, Teams) and presents a unified, continuous personality backed by persistent memory, extensible skills, and autonomous agents.

New here?

Start with the Getting Started guide to have ScalyClaw up and running in minutes.

What is ScalyClaw?

ScalyClaw is not a chatbot framework or an API wrapper. It's a complete AI platform that gives you:

One Mind

A single personality shaped by three editable files — identity, soul, and user context. It knows who it is and who you are.

Every Channel

Seven messaging channels out of the box. Talk to it on Telegram in the morning, Discord at night — same memory, same context.

Infinite Memory

Hybrid SQLite + vector search. It remembers your preferences, past conversations, and key facts — automatically.

Extensible Skills

Write skills in JavaScript, Python, Rust, or Bash. Hot-reloaded instantly. The AI can even create skills on its own.

Autonomous Agents

Delegate complex tasks to sub-agents with custom prompts, models, and tool permissions.

Defense in Depth

Four security layers — echo guard, content guard, skill guard, and vault — all fail-closed by default.

How It Works

ScalyClaw consists of three main processes:

Component	Role
Node	The brain — handles channel connections, the orchestrator, LLM calls, guards, and system coordination.
Worker	Stateless execution engine — processes the tools queue (code execution, skill invocation, shell commands). The main Node process handles the remaining five queues (messages, agents, proactive, scheduler, system).
Dashboard	A 16-page React admin interface — configure everything visually with real-time WebSocket updates.

All three connect through Redis, which serves as the message bus (BullMQ), session store, config store, secret vault, and pub/sub channel for hot-reloading.

Quick Start

bash

# Install ScalyClaw
curl -fsSL https://scalyclaw.netlify.app/install.sh | bash

# Run the setup wizard
scalyclaw setup

# Start everything
scalyclaw node start
scalyclaw worker start
scalyclaw dashboard start

After setup, open the dashboard at http://localhost:3000, configure a channel, and send your first message.

Explore the Docs

Section	What You'll Learn
Getting Started	Prerequisites, installation, first run
Architecture	System design, message flow, configuration
The Mind	Personality files and how to customize them
Channels	Setting up each messaging platform
Models	LLM providers, embedding, budget control
Memory	How auto-memory and vector search work
Skills	Writing and deploying custom skills
Agents	Autonomous sub-agents for complex tasks
Security	Guards, vault, and defense-in-depth
Use Cases	Real-world scenarios and setups