openclaw-genie

# OpenClaw Genie

OpenClaw is a self-hosted personal AI agent gateway (MIT license, open source).
It connects LLM agents to 22+ messaging platforms natively (WhatsApp, Telegram,
Discord, Slack, Signal, iMessage, MS Teams, Matrix, and more) with 50+
integrations (Gmail, GitHub, Obsidian, Spotify, and more) through a single
Gateway process. All data stays local.

---

## Quick Start

```bash
# One-liner install (macOS/Linux, requires Node 22+)
curl -fsSL https://openclaw.ai/install.sh | bash

# Or via npm
npm install -g openclaw@latest

# Interactive setup — gateway, workspace, channels, skills
openclaw onboard --install-daemon

# Verify
openclaw status
openclaw gateway status
```

Web Control UI: `http://127.0.0.1:18789/`

---

## Core Architecture

```
Channels (WhatsApp, Discord, Telegram, Slack, Signal, …)
        ↓
    Gateway  ← WebSocket control plane (port 18789), single source of truth
        ↓
    Agents   ← isolated workspaces, sessions, memory, tools
        ↓
    Tools    ← exec, browser, skills, hooks, messaging, sub-agents
        ↓
    Nodes    ← companion devices (macOS/iOS/Android): camera, canvas, screen
```

- **Gateway**: Multiplexed port (WebSocket + HTTP + Control UI). Hot-reloads config.
- **Agents**: Fully isolated — own workspace, session store, memory, auth profiles, sandbox.
- **Channels**: 22+ native adapters run simultaneously. Deterministic routing: replies return to origin.
- **Nodes**: Paired companion devices that expose `canvas.*`, `camera.*`, `screen.*`, `device.*`, `notifications.*` via `node.invoke`.
- **Sessions**: Key format `agent:<agentId>:<channel>:<scope>:<chatId>`. DM scopes: `main`, `per-peer`, `per-channel-peer`, `per-account-channel-peer`.

---

## Agent Configuration

Workspace files in `~/.openclaw/workspace/` (default agent) or `~/.openclaw/workspace-<agentId>/`:

| File | Purpose |
|------|---------|
| `SOUL.md` | Agent personality and system prompt |
| `IDENTITY.md` | Name, emoji, avatar |
| `USER.md` | User profil...

# OpenClaw Genie

A comprehensive agent skill for [OpenClaw](https://openclaw.ai) — the self-hosted AI agent gateway that connects LLM agents to 38+ messaging platforms.

## What It Covers

- Installation and quick start
- Full `openclaw.json` configuration reference
- Channel setup (Discord, Telegram, WhatsApp, Slack, Signal, iMessage, and more)
- Memory system (vector search, hybrid BM25+vector, QMD, local embeddings)
- Tools (exec, browser, skills, hooks, messaging, sub-agents)
- Deployment (Docker, Fly.io, Railway, Render, sandboxing, security)
- Multi-agent architecture (routing, broadcast, workspaces, session isolation)

## File Structure

```
openclaw-genie/
├── SKILL.md                          # Main skill (247 lines)
└── references/
    ├── configuration.md              # openclaw.json, model providers, auth, OAuth
    ├── channels.md                   # Per-channel setup, access control, streaming
    ├── memory.md                     # Vector search, QMD, hybrid, embeddings
    ├── tools.md                      # Exec, browser, skills system, hooks, sub-agents
    ├── deployment.md                 # Docker, cloud platforms, sandboxing, security
    └── multi-agent.md                # Bindings, broadcast, workspaces, sessions
```

## Installation

### Via [skills.sh](https://skills.sh) (recommended)

Works with 37+ agents — Claude Code, OpenClaw, Cursor, Copilot, Windsurf, and more:

```bash
npx skills add fcsouza/agent-skills --skill openclaw-genie
```

Install globally (available across all projects):

```bash
npx skills add fcsouza/agent-skills --skill openclaw-genie -g
```

### Via ClawHub (OpenClaw only)

```bash
clawhub install openclaw-genie
```

### Manual

Copy the `openclaw-genie/` folder to your agent's skills directory:

```bash
# OpenClaw (workspace skills, highest precedence)
cp -r openclaw-genie/ ~/.openclaw/workspace/skills/openclaw-genie/

# Claude Code
cp -r openclaw-genie/ .claude/skills/openclaw-genie/
```

## Usage

Once installed, th...