HybridClaw

Business Skills That Work On Smaller Models

HybridClaw's main promise is practical business work. The bundled CRM, marketing, analytics, finance, cloud, office, and operations skills are implemented as tested helpers with eval scenarios, credential boundaries, and approval tiers, and are validated against Qwen/Qwen3.6-27B-FP8 as the small-model baseline.

That is the useful difference: a compact model can operate Salesforce, HubSpot, GA4, Google Ads, Lexware, Airtable, Miro, Zoho, Microsoft 365, warehouse SQL, invoices, cloud ops, and office documents through structured rails instead of fragile free-form prompting.

HybridClaw also treats agents as networked coworkers. Local agents, hosted HybridAI proxy agents, and trusted peer HybridClaw instances can address one another, exchange end-to-end encrypted A2A envelopes, and route work through approval-aware channels. An A2A local mode keeps peer delivery and authenticated administration reachable while disabling other external gateway and channel surfaces.

First-run onboarding is built around hatching: a new agent asks about the user's work, records useful context, keeps setup links visible in chat, and can send a tailored first-jobs welcome email when an email route is available. The bootstrap lifecycle is recorded as structured onboarding audit events, including messages, welcome mail, workspace file updates, completion, and abort paths.

Credentials stay outside the model context. Secrets live in the encrypted runtime store and SecretRef-backed tools resolve them at execution time, so LLMs see the requested action and approval context, not raw API keys, passwords, or bearer tokens.

Run one local assistant, operate a fleet of role-specific coworkers, or launch HybridClaw on HybridAI Cloud in a few minutes at hybridclaw.io.

Quick Start · Launch Cloud · Installation · Docs · Configuration · Commands · Contributing

Why HybridClaw

| You need | HybridClaw gives you | | --- | --- | | A first run that becomes useful quickly | Guided hatching with setup links, tailored first-job suggestions, optional onboarding-specific model routing, welcome-email handoff, and structured audit events | | Business workflows that survive real use | Production skill helpers with fixtures, eval scenarios, targeted tests, approval tiers, and a Qwen/Qwen3.6-27B-FP8 validation baseline | | Local inference on your Mac | Memory-aware MLX model setup, start/stop controls, live activity, and local model selection on supported Apple silicon Macs | | Generated work artifacts you can reuse | An Apps gallery for self-contained HTML apps, dashboards, documents, games, tools, live connector-backed views, sharing links, and Teams tabs | | Multi-agent workflows across installations | Local agents, hosted proxy agents, encrypted A2A trust, explicit addressing, inbound envelopes, reply-back delivery, admin-visible peer pairing, and an A2A-only deployment mode | | Credentials the model cannot read | Encrypted runtime secrets, SecretRef-backed execution paths, and scoped gateway API tokens that keep raw keys and passwords out of prompts and tool results | | Assistants that can act, not just chat | A gateway, web chat, Apps gallery, TUI, admin console, scheduler, tools, and OpenAI-compatible API behind one local service | | Control over sensitive work | Approval policy, sandbox boundaries, output guardrails, and hash-chained audit trails | | Agents that fit existing teams | Discord, Slack, Teams, Telegram, email, voice, web, and more through the same runtime, with WhatsApp available as an install-on-demand plugin | | Operational memory | Local files, SQLite state, semantic recall, session compaction, and optional HybridAI cloud memory | | Repeatable expert workflows | Per-agent workspaces, budgets, deterministic model-tier routing, A2A trust, proxy agents, .claw archives, and human-distillation workflows |

Install

Fastest managed launch: HybridClaw on HybridAI Cloud.

Apple Desktop App for macOS:

• Download the signed and notarized Apple Silicon DMG from

• Open the DMG, drag HybridClaw.app into /Applications, and launch it.
• The desktop app starts the local gateway and opens the chat, agents, and

Linux/macOS CLI one-line installer:

curl -fsSL https://raw.githubusercontent.com/HybridAIOne/hybridclaw/main/scripts/install.sh | bash

Manual npm install:

npm install -g @hybridaione/hybridclaw
hybridclaw onboarding
hybridclaw gateway
hybridclaw tui

Requirements: Node.js >=22.23.4 <23. Docker is recommended for the default sandbox.

First Run

After the gateway starts, open:

| Surface | URL / command | Use it for | | --- | --- | --- | | Web Chat | http://127.0.0.1:9090/chat | Chat, ideas, outputs, notifications, model and agent switching | | Apps Gallery | http://127.0.0.1:9090/apps | Generated web apps, documents, games, tools, live connector-backed views, and sharing | | Admin Console | http://127.0.0.1:9090/admin | Searchable settings plus agents, automation, activity, connectivity, security, and federation workflows | | Agents UI | http://127.0.0.1:9090/agents | Agent fleet overview and prompt-file editing | | TUI | hybridclaw tui | Terminal chat, approvals, status, resume | | OpenAI-compatible API | http://127.0.0.1:9090/v1/chat/completions | Local evals and compatible clients |

For signed macOS desktop builds and future architectures, use the GitHub Releases page.

Desktop wrapper from source:

npm install
npm run desktop

What You Get

| Area | Built in | | --- | --- | | Skills | 79 bundled skills, production business helpers, eval fixtures, packaged skill lifecycle, and human-distillation workflows | | Channels | Discord, Slack, Signal, LINE self-chat, Telegram, Microsoft Teams, email, iMessage, fax, web, incoming webhooks, and install-on-demand WhatsApp, Twilio voice, and Vonage voice plugins | | Runtime | Gateway service, TUI client, web chat with Ideas, Outputs and notifications, Apps gallery, searchable admin console, loopback OpenAI-compatible API, and Docker or host execution with document and spreadsheet tooling | | Local models | Managed MLX setup on Apple silicon with macOS 15+, memory-aware model recommendations, live activity, configurable starter tools and skills, and optional local Laya routing | | Governance | Encrypted runtime secrets, scoped API tokens and device pairing, SecretRef credential isolation, per-session approval modes, sandbox controls, hash-chained audit trails, dependency license gates, SBOMs, and third-party notices | | Memory | Local memory files, SQLite persistence, semantic recall, persistent tool exchanges, session compaction, optional HybridAI cloud memory sync | | Agents | Guided hatching, per-agent workspaces, models, budgets, prompt files, deterministic tier routing, explicit addressing, proxy agents, encrypted A2A trust, peer-instance communication, and reply delivery status | | Extensibility | Packaged business skills, install-on-demand channel plugins, MCP servers, Published Tools endpoints for external MCP hosts, admin connector flows, and SecretRef-backed HTTP tools |

Product Strengths

• Validated business skills: production skills use deterministic helpers,

• Guided onboarding: hatching collects useful work context, keeps setup

• Multi-agent operations: agents can coordinate across local workspaces,

• Prompt-level credential isolation: encrypted secrets and SecretRefs keep

• One runtime for many surfaces: web, terminal, Discord, Slack, Teams,

• Generated apps from chat: describe an app, dashboard, document, game, or

• Secure by default: LLM output is treated as untrusted, risky actions

• Model freedom: use HybridAI, the direct OpenAI Responses API, Codex OAuth,

• Local Mac models: Labs → Local Models installs and checks a pinned

• Operator visibility: /admin groups Activity, Agents, Automation,

• Business-ready extension model: packaged skills, plugins, MCP servers,

• Practical migration path: preview compatible imports from OpenClaw or

PDF attachments and image reads send selected pages or pixels directly to supported multimodal models. ZIP attachments let agents work with bundles of documents or data. Read the tools reference for page selection and coverage, and the notification guide for browser and phone setup.

Todos and repeating habits carry due dates, streaks, and reminders; goals and tracked items carry outcomes, steps, and scheduled check-ins. See the command reference. Companion apps can share device data, upload files, and call the agent through paired device tokens. Mobile chats keep their conversation across automatic reset windows. Local and Mac browser calls provide live frames, and placing an order requires approval for each attempt; see approvals. Opening a page or clicking returns the resulting page in the same tool call. Saved website sign-ins fill login fields without exposing credentials to the model. Use /name to set what the agent calls you.

Common Commands

hybridclaw gateway status
hybridclaw tui --resume <sessionId>
hybridclaw config get <key>
hybridclaw token list
hybridclaw skill list
hybridclaw agent list
hybridclaw doctor
hybridclaw update --yes

Migration preview:

hybridclaw migrate openclaw --dry-run
hybridclaw migrate hermes --dry-run

HybridAI Platform

HybridClaw runs self-hosted. HybridAI is the optional platform layer around it:

• managed HybridClaw launch at hybridclaw.io
• enterprise shared RAG and cloud memory
• managed access to current models
• observability across multiple agents
• hosted email addresses for agents
• ready-to-run virtual coworkers

Architecture

User message
  -> Gateway (HTTP, web chat, TUI, Discord, Slack, email, etc.)
  -> ContainerInput JSON
  -> Host or Docker runtime
  -> Agent loop, tools, approvals, memory, MCP
  -> ContainerOutput JSON
  -> Gateway response, session store, audit trail

Core pieces:

• Gateway service: command handling, channel transports, REST APIs,

• Container runtime: sandboxed tool execution, provider adapters, browser

• TUI client: thin HTTP client for terminal-first operation.
• Console: web chat, Apps gallery, and admin UI served by the gateway.

Docs By Goal

| Goal | Start here | | --- | --- | | Install and launch | Quick Start, Installation | | Configure providers and models | Authentication, Model Selection | | Run models on your Mac | Mac Local Model Setup, Local Providers | | Connect an API client | OpenAI-compatible API | | Build generated apps | Apps Gallery | | Connect channels | Connect Your First Channel, Channels | | Use bundled skills | Bundled Skills, Skills Catalog | | Distill a coworker | Human Distillation | | Operate securely | Security, Trust Model, Approvals | | Inspect commands | Commands, Diagnostics | | Extend HybridClaw | Extensibility, Plugins, MCP | | Build desktop releases | Desktop Release Builds | | Contribute | CONTRIBUTING.md, docs/content/README.md |

Latest release: v0.41.5. Release notes: CHANGELOG.md

Development

npm install
npm run setup
npm run build
npm run typecheck
npm run test:unit

Useful dev commands:

npm run dev          # gateway in hot-reload mode
npm run tui          # terminal client
npm run check        # Biome check
npm run format       # Biome write

For docs-only changes, verify links, commands, and examples. For code changes, run npm run typecheck, npm run lint, and targeted tests for the touched area.

Community

• Discord: discord.gg/jsVW4vJw27
• Issues: github.com/HybridAIOne/hybridclaw/issues
• Discussions: github.com/HybridAIOne/hybridclaw/discussions
• Support guide: SUPPORT.md
• Community standards: CODE_OF_CONDUCT.md