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, 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 A2A envelopes, and route work through approval-aware channels.

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
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
Multi-agent workflows across installations	Local agents, hosted proxy agents, A2A trust, explicit addressing, inbound envelopes, and admin-visible peer pairing
Credentials the model cannot read	Encrypted runtime secrets and SecretRef-backed execution paths that keep raw keys and passwords out of prompts and tool results
Assistants that can act, not just chat	A gateway, web chat, 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, WhatsApp, email, voice, web, and more through the same runtime
Operational memory	Local files, SQLite state, semantic recall, session compaction, and optional HybridAI cloud memory
Repeatable expert workflows	Per-agent workspaces, budgets, model routing, A2A trust, proxy agents, .claw archives, and human-distillation workflows

Install

Fastest managed launch: HybridClaw on HybridAI Cloud.

Linux/macOS 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. 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, slash commands, model and agent switching
Admin Console	http://127.0.0.1:9090/admin	Channels, agents, approvals, audit, config, secrets, skills, distillation
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, use the GitHub Releases page.

Desktop wrapper from source:

npm install
npm run desktop

What You Get

Area	Built in
Skills	76 bundled skills, production business helpers, eval fixtures, packaged skill lifecycle, and human-distillation workflows
Channels	Discord, Slack, Signal, WhatsApp, Telegram, Microsoft Teams, email, iMessage, fax, Twilio voice, web, and incoming webhooks
Runtime	Gateway service, TUI client, web chat, admin console, loopback OpenAI-compatible API, Docker or host execution
Governance	Encrypted runtime secrets, SecretRef credential isolation, approval policies, sandbox controls, audit trails with hash-chain integrity
Memory	Local memory files, SQLite persistence, semantic recall, session compaction, optional HybridAI cloud memory sync
Agents	Per-agent workspaces, models, budgets, prompt files, explicit addressing, proxy agents, A2A trust, peer-instance communication
Extensibility	Packaged business skills, plugins, MCP servers, SecretRef-backed HTTP tools

Product Strengths

• Validated business skills: production skills use deterministic helpers, fixtures, eval scenarios, and targeted tests so small models can perform useful work through structured actions.
• Multi-agent operations: agents can coordinate across local workspaces, hosted HybridAI proxies, and trusted peer HybridClaw instances with A2A pairing, explicit addressing, inbound envelopes, and admin-visible trust.
• Prompt-level credential isolation: encrypted secrets and SecretRefs keep credential values out of model context while tools receive only the scoped credential material needed at execution time.
• One runtime for many surfaces: web, terminal, Discord, Slack, Teams, email, voice, webhooks, and local API clients all use the same gateway, memory, policy, and audit model.
• Secure by default: LLM output is treated as untrusted, risky actions route through approval policy, and every sensitive boundary is visible in audit.
• Model freedom: use HybridAI, major hosted providers, local engines, or named OpenAI-compatible endpoints from the same model picker and config surface.
• Operator visibility: /admin covers channels, approvals, audit, statistics, output guard, secrets, fleet topology, A2A inbox/trust, and distillation without requiring shell access.
• Business-ready extension model: packaged skills, plugins, MCP servers, and SecretRef-backed HTTP tools share the same approval and credential boundaries.
• Practical migration path: preview compatible imports from OpenClaw or Hermes, then package agents as portable .claw archives.

Common Commands

hybridclaw gateway status
hybridclaw tui --resume <sessionId>
hybridclaw config get <key>
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, scheduler, SQLite persistence, audit, A2A, admin surfaces.
• Container runtime: sandboxed tool execution, provider adapters, browser automation, media/search tooling, file-based IPC.
• TUI client: thin HTTP client for terminal-first operation.
• Console: web chat 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
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

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