---
title: HybridClaw Docs
description: User, operator, and developer documentation for HybridClaw installation, channels, workflows, extensibility, and runtime internals.
sidebar_position: 1
---

# HybridClaw Docs

Welcome to the HybridClaw handbook — the operator, contributor, and
advanced-user manual for running, extending, and understanding HybridClaw. The
chapters are organized around what you are trying to do rather than how the
repository is laid out. **Getting Started** walks through installation,
onboarding, and your first run. **Channels** is the transport reference across
Discord, Slack, Telegram, Signal, Threema, email, WhatsApp, iMessage, and
Microsoft Teams.
**Guides** collects task-focused walkthroughs for everyday operational work,
**Tutorials** provides practical owner, GTM, marketing, sales, and community
workflows, **Extensibility** covers tools, skills, plugins, and the extension
architecture, and the **Developer Guide** goes deeper into architecture and
maintainer-facing internals. When you just need a fact — a command, a config
key, a diagnostic — **Reference** is the place to land.

Every page in the browser docs shell keeps its raw `.md` source one click
away: open it directly from the header, or copy the full page markdown for
sharing and quoting. If you prefer a single markdown index that links every
doc at once, start from [For Agents](./agents.md).

## Latest Highlights

- Native `image_generate` and `video_generate` tools produce managed media
  artifacts through configured image and video providers.
- Bundled skills cover Airtable, FastBill, Firecrawl, HeyGen, Google Ads, and
  SearXNG-backed web/news/image search workflows.
- Threema Gateway Basic mode is available for outbound operator messaging in
  DACH-regulated or privacy-sensitive deployments.
- A2A federation includes JSON-RPC Agent Card inbound delivery, signed
  delegation bearer tokens, and a public-key trust ledger.
- Browser automation supports local Playwright profiles, Camofox profiles, and
  Browser Use Cloud sessions with SecretRef-gated credential fills.
- Trace-judge eval gates and behavioral anomaly reranking give tool-call and
  skill-trace review a deterministic test path.
- `npm run desktop` launches a native macOS wrapper around the local chat UI,
  with gateway reuse/startup and admin access from the app menu.
- Canonical user and agent identity helpers now include DNS-style discovery for
  mapping remote identities to peer URLs and public keys.
- Approval policy evaluation runs through a hook-fed rule pipeline that keeps
  built-in trust behavior while allowing explicit policy ordering and plugin
  visibility.
- Web chat session history and active-agent switching are more stable across
  route changes and resumed sessions.
- The `download-platform-invoices` skill harvests official monthly SaaS
  invoice PDFs and normalized records across billing APIs, browser-backed
  portals, Google Ads, cloud providers, and DATEV handoff flows.
- The `warehouse-sql` skill reviews and runs read-only natural-language SQL
  against cached warehouse schemas.
- Signal joins the channel catalog with a full `signal-cli` daemon setup guide,
  private-by-default DM policy, group controls, and admin QR linking.
- `.confidential.yml` rules can redact NDA-class business data before model
  calls, while `hybridclaw audit scan-leaks` scans historical audit logs for
  possible leaks.
- Web chat shows live context-window usage, supports `/context`, searches
  recent sessions, and can switch the active agent from the composer.
- The admin console includes statistics and agent-scoreboard pages for
  sessions, messages, tokens, cost trends, skill scores, reliability, timing,
  and CV links.
- Packaged business skills can declare manifests, capabilities, required
  credentials, supported channels, lifecycle snapshots, and rollback history.
- Deployment config can describe cloud/local mode and tunnel provider intent;
  the built-in ngrok, Tailscale, and Cloudflare providers read runtime auth
  secrets from encrypted storage.
- `HYBRIDAI_FALLBACK_CHAIN` can route auth and rate-limit provider failures to
  alternate models/providers with primary-provider cooldowns.
- Model info, usage summaries, and the admin Models page surface discovered
  context windows, output limits, capabilities, pricing, and monthly spend
  where providers expose the metadata.
- Installation options include npm, source checkout, a multi-arch Nix flake,
  a NixOS module, and a preview Homebrew formula for `--HEAD` builds.

## Browse By Section

- [HybridClaw: The AI Coworker Who's Already On It](./manifesto.md) — the product principles HybridClaw is built around: what we will and will not ship
- [Getting Started](./getting-started/README.md) for installation,
  onboarding, provider authentication, and connecting the first transport
- [Channels](./channels/README.md) for the full supported channel catalog and
  transport-specific setup details
- [Guides](./guides/README.md) for local providers, MCP, bundled skills,
  remote access, voice/TTS, and optional office tooling
- [Tutorials](./tutorials/README.md) for practical owner, GTM, marketing,
  sales, and community workflows
- [Extensibility](./extensibility/README.md) for tools, skills, plugins,
  agent packages, and extension-specific operator workflows
- [Developer Guide](./developer-guide/README.md) for architecture, runtime
  behavior, session routing, testing, and release mechanics
- [Reference](./reference/README.md) for model selection, configuration,
  diagnostics, commands, and FAQ

## Fast Paths

- Need to install HybridClaw quickly? Go to
  [Installation](./getting-started/installation.md).
- Need the shortest path to a running gateway and chat UI? Go to
  [Quick Start](./getting-started/quickstart.md).
- Need to connect one transport without reading the full channel manual? Go to
  [Connect Your First Channel](./getting-started/first-channel.md).
- Need command lookup or troubleshooting help? Go to
  [Commands](./reference/commands.md) and
  [Diagnostics](./reference/diagnostics.md).
- Need setup answers before deploying? Go to [FAQ](./reference/faq.md).
- Need to reach `/chat`, `/agents`, or `/admin` from another machine? Go to
  [Remote Access](./guides/remote-access.md).
- Need one markdown page that links the whole docs tree? Go to
  [For Agents](./agents.md).
