# Send Openclaw Genie to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "openclaw-genie",
    "name": "Openclaw Genie",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/fcsouza/openclaw-genie",
    "canonicalUrl": "https://clawhub.ai/fcsouza/openclaw-genie",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/openclaw-genie",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-genie",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "references/channels.md",
      "references/configuration.md",
      "references/deployment.md",
      "references/memory.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/openclaw-genie"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/openclaw-genie",
    "downloadUrl": "https://openagent3.xyz/downloads/openclaw-genie",
    "agentUrl": "https://openagent3.xyz/skills/openclaw-genie/agent",
    "manifestUrl": "https://openagent3.xyz/skills/openclaw-genie/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/openclaw-genie/agent.md"
  }
}
```
## Documentation

### 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

# 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>/:

FilePurposeSOUL.mdAgent personality and system promptIDENTITY.mdName, emoji, avatarUSER.mdUser profile informationMEMORY.mdCurated long-term memorymemory/YYYY-MM-DD.mdDaily append-only session logsTOOLS.mdTool usage guidanceBOOTSTRAP.mdOne-time init tasks (deleted after first run)HEARTBEAT.mdPeriodic check-in instructions

Bootstrap injection: IDENTITY → SOUL → USER → MEMORY → daily log → skills → session.
Limits: 20,000 chars/file, 150,000 chars total (configurable).

Multi-agent config uses agents.list[] and bindings[] in openclaw.json (see references/multi-agent.md).

### Configuration — openclaw.json

Location: ~/.openclaw/openclaw.json (JSON5 — comments and trailing commas OK).

{
  "models": {           // primary, fallbacks, aliases, image model
    "primary": "anthropic/claude-sonnet-4-5",
    "fallbacks": ["openai/gpt-4o"]
  },
  "channels": { },      // discord, telegram, whatsapp, slack, signal, …
  "agents": { },        // list, defaults, bindings, broadcast, subagents
  "tools": { },         // profiles, allow/deny, loop detection, exec config
  "skills": { },        // entries, load dirs, install manager
  "browser": { },       // profiles, SSRF policy, executable path
  "sandbox": { },       // mode (off/non-main/all), scope, Docker hardening
  "gateway": { },       // port, auth, discovery, binding
  "automation": { },    // cron, webhooks, heartbeat
  "hooks": { },         // internal hooks config
  "session": { },       // dmScope, resets, sendPolicy, maintenance
  "auth": { }           // OAuth profiles, key rotation, order
}

Env vars: ~/.openclaw/.env, ${VAR} substitution in config strings.
$include: Nested file inclusion (up to 10 levels).
Hot reload: hybrid mode (default) — safe changes hot-apply, critical ones auto-restart. Debounce 300ms.
Strict validation: Unknown keys prevent Gateway startup.

For full reference, read references/configuration.md.

### Channels Quick Reference

ChannelSetupNotesDiscordopenclaw channels add discordBot API + Gateway; servers, DMs, threads, slash commands, voiceTelegramopenclaw channels add telegramgrammY; groups, forums, inline buttons, webhook modeWhatsAppopenclaw channels add whatsappBaileys; QR pairing, media, pollsSlackopenclaw channels add slackBolt SDK; socket or HTTP mode, native streamingSignalopenclaw channels add signalsignal-cli; privacy-focused, auto-daemoniMessageopenclaw channels add bluebubblesBlueBubbles; reactions, edits, groupsGoogle Chatopenclaw channels add googlechatHTTP webhook appIRCopenclaw channels add ircNickServ, channels + DMsMS Teamsopenclaw plugins install @openclaw/msteamsAdaptive Cards, pollsMatrixopenclaw plugins install @openclaw/matrixE2EE, threads, roomsMattermostopenclaw plugins install @openclaw/mattermostSelf-hostedNextcloud Talkopenclaw plugins install @openclaw/nextcloud-talkSelf-hostedWebChatBuilt-in web UIBrowser-based access at gateway URL

Access control: DM policy (pairing/allowlist/open/disabled), group policy, mention gating. Multi-account per channel supported.

For per-channel details, read references/channels.md.

### Memory System

Daily logs: memory/YYYY-MM-DD.md — today + yesterday loaded at session start
Long-term: MEMORY.md — curated facts, decisions, preferences (private sessions only)
Tools: memory_search (vector recall, ~400-token chunks) and memory_get (file reads)
Hybrid search: BM25 (exact tokens) + vector (semantic) with configurable weights
Post-processing: MMR deduplication (lambda 0.7) + temporal decay (30-day half-life)
Providers: auto-selects local → OpenAI → Gemini → Voyage → Mistral
QMD backend: Optional local-first sidecar (BM25 + vectors + reranking)
Auto flush: Silent agentic turn before context compaction preserves important memories

For full memory config, read references/memory.md.

### Tools Overview

ToolPurposeexecShell commands (sandbox/gateway/node hosts)processBackground process managementbrowserChromium automation (navigate, click, type, screenshot)web_searchBrave Search API queriesweb_fetchURL → markdown extractionmemory_searchSemantic vector search over memorymemory_getDirect memory file readsmessageCross-channel messaging (send, react, thread, pin, poll)sessions_spawnSub-agent runs (one-shot or persistent, up to depth 5)canvasNode Canvas UI (HTML display on connected devices)nodesPaired device control: camera snap/clip, screen record, notifications, canvas A2UIpdfNative PDF analysis (up to 10 PDFs, Anthropic/Google native mode, extraction fallback)

Access control: Profiles (minimal, coding, messaging, full), allow/deny lists, tool groups (group:fs, group:runtime, group:sessions, group:web, group:ui, group:automation).
Default profile (since v2026.3.2): onboarding defaults to messaging (not coding).

For full tools, skills, and hooks reference, read references/tools.md.

### Hooks & Automation

Hooks — event-driven TypeScript handlers in <workspace>/hooks/:

EventTriggercommand:new/reset/stopSession lifecycleagent:bootstrapPre-injection (can mutate bootstrap files)gateway:startupAfter channels loadmessage:received/sentMessage lifecycletool_result_persistSynchronous tool result transform

Automation — built into Gateway:

Cron: Scheduled jobs (cron expressions, intervals, one-shot). Isolated or main-session.
Webhooks: /hooks/wake (system events), /hooks/agent (isolated turns), custom mapped endpoints.
Heartbeat: Periodic check-ins (default 30min), batches multiple checks per turn.

Voice — macOS/iOS wake word + talk mode overlay; continuous voice on Android with ElevenLabs or system TTS; OpenAI-compatible STT endpoint (messages.tts.openai.baseUrl).

### Deployment Options

# Local service (default)
openclaw gateway install && openclaw gateway start

# One-liner Docker
./docker-setup.sh

# Manual Docker
docker build -t openclaw:local -f Dockerfile .
docker compose up -d openclaw-gateway

Cloud: Fly.io, Railway, Render, GCP, Hetzner, Cloudflare Workers, Ansible.
Sandbox: Docker isolation for untrusted sessions. Modes: off, non-main, all. Scopes: session, agent, shared.
Remote access: Tailscale/VPN preferred, SSH tunnel fallback.

For full deployment guide, read references/deployment.md.

### CLI Essentials

CommandPurposeopenclaw onboardInteractive first-time setupopenclaw gateway start/stop/statusService managementopenclaw channels add/list/status/loginChannel managementopenclaw models list/set/auth/scanModel config + authopenclaw skills list/info/checkSkill managementopenclaw hooks list/enable/disable/installHook managementopenclaw agent --message "..."Single agent turnopenclaw agents list/add/deleteMulti-agent managementopenclaw sessionsList/manage sessionsopenclaw browserBrowser control (50+ subcommands)openclaw cron list/add/runScheduled jobsopenclaw nodes statusList paired companion nodesopenclaw devices list/approveManage device pairing requestsopenclaw config get/set/unset/validateConfig helpers (validate checks file before startup)openclaw doctor [--fix]Health checks + auto-repairopenclaw security audit [--deep]Security auditopenclaw logs [--follow]Tail gateway logsopenclaw memory search "query"Vector searchopenclaw dns setupCoreDNS + Tailscale discoveryopenclaw tuiTerminal UI

Global flags: --dev, --profile <name>, --json, --no-color

### When to Read Reference Files

If you need…ReadFull openclaw.json, model providers, env vars, auth, OAuthreferences/configuration.mdPer-channel setup, routing, access control, streaming, multi-accountreferences/channels.mdMemory files, vector search, QMD, embeddings, hybrid searchreferences/memory.mdExec, browser, skills, hooks, tool access, sub-agents, nodesreferences/tools.mdDocker, cloud deploy, sandboxing, native install, securityreferences/deployment.mdMulti-agent config, bindings, broadcast, sub-agents, workspacesreferences/multi-agent.md
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: fcsouza
- Version: 1.2.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/openclaw-genie)
- [Send to Agent page](https://openagent3.xyz/skills/openclaw-genie/agent)
- [JSON manifest](https://openagent3.xyz/skills/openclaw-genie/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/openclaw-genie/agent.md)
- [Download page](https://openagent3.xyz/downloads/openclaw-genie)