ZeroClaw 🦀

Cero sobrecarga. Cero compromiso. 100% Rust. 100% Agnóstico.
⚡️ ¡Ejecuta en hardware de $10 con <5MB de RAM: ¡Eso es 99% menos memoria que OpenClaw y 98% más barato que un Mac mini!

Construido por estudiantes y miembros de las comunidades de Harvard, MIT y Sundai.Club.

🌐 Idiomas:🇺🇸 English · 🇨🇳 简体中文 · 🇯🇵 日本語 · 🇰🇷 한국어 · 🇻🇳 Tiếng Việt · 🇵🇭 Tagalog · 🇪🇸 Español · 🇧🇷 Português · 🇮🇹 Italiano · 🇩🇪 Deutsch · 🇫🇷 Français · 🇸🇦 العربية · 🇮🇳 हिन्दी · 🇷🇺 Русский · 🇧🇩 বাংলা · 🇮🇱 עברית · 🇵🇱 Polski · 🇨🇿 Čeština · 🇳🇱 Nederlands · 🇹🇷 Türkçe · 🇺🇦 Українська · 🇮🇩 Bahasa Indonesia · 🇹🇭 ไทย · 🇵🇰 اردو · 🇷🇴 Română · 🇸🇪 Svenska · 🇬🇷 Ελληνικά · 🇭🇺 Magyar · 🇫🇮 Suomi · 🇩🇰 Dansk · 🇳🇴 Norsk

Inicio Rápido | Configuración con Un Clic | Hub de Documentación | Tabla de Contenidos de Documentación

Accesos rápidos: Referencia · Operaciones · Solución de Problemas · Seguridad · Hardware · Contribuir

Infraestructura de asistente AI rápida, ligera y completamente autónoma
Despliega en cualquier lugar. Intercambia cualquier cosa.

ZeroClaw es el sistema operativo de runtime para flujos de trabajo de agentes — una infraestructura que abstrae modelos, herramientas, memoria y ejecución para construir agentes una vez y ejecutarlos en cualquier lugar.

Arquitectura basada en traits · runtime seguro por defecto · proveedor/canal/herramienta intercambiables · todo es conectable

📢 Anuncios

Usa esta tabla para avisos importantes (cambios de compatibilidad, avisos de seguridad, ventanas de mantenimiento y bloqueos de versión).

Fecha (UTC)	Nivel	Aviso	Acción
2026-02-19	Crítico	No estamos afiliados con `openagen/zeroclaw` o `zeroclaw.org`. El dominio `zeroclaw.org` apunta actualmente al fork `openagen/zeroclaw`, y este dominio/repositorio está suplantando nuestro sitio web/proyecto oficial.	No confíes en información, binarios, recaudaciones de fondos o anuncios de estas fuentes. Usa solo este repositorio y nuestras cuentas sociales verificadas.
2026-02-21	Importante	Nuestro sitio web oficial ahora está en línea: zeroclawlabs.ai. Gracias por tu paciencia durante la espera. Todavía detectamos intentos de suplantación: no participes en ninguna actividad de inversión/financiamiento en nombre de ZeroClaw si no se publica a través de nuestros canales oficiales.	Usa este repositorio como la única fuente de verdad. Sigue X (@zeroclawlabs), Telegram (@zeroclawlabs), Facebook (grupo), Reddit (r/zeroclawlabs), y Xiaohongshu para actualizaciones oficiales.
2026-02-19	Importante	Anthropic actualizó los términos de uso de autenticación y credenciales el 2026-02-19. La autenticación OAuth (Free, Pro, Max) es exclusivamente para Claude Code y Claude.ai; el uso de tokens OAuth de Claude Free/Pro/Max en cualquier otro producto, herramienta o servicio (incluyendo Agent SDK) no está permitido y puede violar los Términos de Uso del Consumidor.	Por favor, evita temporalmente las integraciones OAuth de Claude Code para prevenir cualquier pérdida potencial. Cláusula original: Authentication and Credential Use.

✨ Características

🏎️ Runtime Ligero por Defecto: Los flujos de trabajo CLI comunes y comandos de estado se ejecutan dentro de un espacio de memoria de pocos megabytes en builds de producción.
💰 Despliegue Económico: Diseñado para placas de bajo costo e instancias cloud pequeñas sin dependencias de runtime pesadas.
⚡ Inicios en Frío Rápidos: El runtime Rust de binario único mantiene el inicio de comandos y demonios casi instantáneo para operaciones diarias.
🌍 Arquitectura Portátil: Un flujo de trabajo de binario único en ARM, x86 y RISC-V con proveedor/canal/herramienta intercambiables.

Por qué los equipos eligen ZeroClaw

Ligero por defecto: binario Rust pequeño, inicio rápido, huella de memoria baja.
Seguro por diseño: emparejamiento, sandboxing estricto, listas permitidas explícitas, alcance de workspace.
Completamente intercambiable: los sistemas centrales son traits (proveedores, canales, herramientas, memoria, túneles).
Sin lock-in de proveedor: soporte de proveedor compatible con OpenAI + endpoints personalizados conectables.

Instantánea de Benchmark (ZeroClaw vs OpenClaw, Reproducible)

Benchmark rápido en máquina local (macOS arm64, feb. 2026) normalizado para hardware edge de 0.8 GHz.

	OpenClaw	NanoBot	PicoClaw	ZeroClaw 🦀
Lenguaje	TypeScript	Python	Go	Rust
RAM	> 1 GB	> 100 MB	< 10 MB	< 5 MB
Inicio (núcleo 0.8 GHz)	> 500s	> 30s	< 1s	< 10ms
Tamaño Binario	~28 MB (dist)	N/A (Scripts)	~8 MB	3.4 MB
Costo	Mac Mini $599	Linux SBC ~$50	Placa Linux $10	Cualquier hardware $10

Notas: Los resultados de ZeroClaw se miden en builds de producción usando /usr/bin/time -l. OpenClaw requiere el runtime Node.js (típicamente ~390 MB de sobrecarga de memoria adicional), mientras que NanoBot requiere el runtime Python. PicoClaw y ZeroClaw son binarios estáticos. Las cifras de RAM anteriores son memoria de runtime; los requisitos de compilación en tiempo de build son mayores.

Medición Local Reproducible

Las afirmaciones de benchmark pueden derivar a medida que el código y las toolchains evolucionan, así que siempre mide tu build actual localmente:

cargo build --release
ls -lh target/release/zeroclaw

/usr/bin/time -l target/release/zeroclaw --help
/usr/bin/time -l target/release/zeroclaw status

Ejemplo de muestra (macOS arm64, medido el 18 de febrero de 2026):

Tamaño de binario release: 8.8M
zeroclaw --help: tiempo real aprox 0.02s, huella de memoria máxima ~3.9 MB
zeroclaw status: tiempo real aprox 0.01s, huella de memoria máxima ~4.1 MB

Requisitos Previos

Windows

Windows — Requerido

Visual Studio Build Tools (proporciona el linker MSVC y el Windows SDK):
```
winget install Microsoft.VisualStudio.2022.BuildTools
```
Durante la instalación (o a través de Visual Studio Installer), selecciona la carga de trabajo "Desarrollo de escritorio con C++".
Toolchain Rust:
```
winget install Rustlang.Rustup
```
Después de la instalación, abre una nueva terminal y ejecuta rustup default stable para asegurar que la toolchain estable esté activa.
Verifica que ambos funcionan:
```
rustc --version
cargo --version
```

Windows — Opcional

Docker Desktop — requerido solo si usas el runtime sandboxed Docker (runtime.kind = "docker"). Instala vía winget install Docker.DockerDesktop.

Linux / macOS

Linux / macOS — Requerido

Herramientas de compilación esenciales:
- Linux (Debian/Ubuntu): sudo apt install build-essential pkg-config
- Linux (Fedora/RHEL): sudo dnf group install development-tools && sudo dnf install pkg-config
- macOS: Instala Xcode Command Line Tools: xcode-select --install

Toolchain Rust:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Ver rustup.rs para detalles.

Verifica:
```
rustc --version
cargo --version
```

Linux / macOS — Opcional

Docker — requerido solo si usas el runtime sandboxed Docker (runtime.kind = "docker").
- Linux (Debian/Ubuntu): ver docs.docker.com
- Linux (Fedora/RHEL): ver docs.docker.com
- macOS: instala Docker Desktop vía docker.com/products/docker-desktop

Inicio Rápido

Opción 1: Configuración automatizada (recomendada)

El script bootstrap.sh instala Rust, clona ZeroClaw, lo compila, y configura tu entorno de desarrollo inicial:

curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/bootstrap.sh | bash

Esto:

Instalará Rust (si no está presente)
Clonará el repositorio ZeroClaw
Compilará ZeroClaw en modo release
Instalará zeroclaw en ~/.cargo/bin/
Creará la estructura de workspace por defecto en ~/.zeroclaw/workspace/
Generará un archivo de configuración inicial ~/.zeroclaw/workspace/config.toml

Después del bootstrap, recarga tu shell o ejecuta source ~/.cargo/env para usar el comando zeroclaw globalmente.

Opción 2: Instalación manual

Clic para ver los pasos de instalación manual

# 1. Clona el repositorio
git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw

# 2. Compila en release
cargo build --release --locked

# 3. Instala el binario
cargo install --path . --locked

# 4. Inicializa el workspace
zeroclaw init

# 5. Verifica la instalación
zeroclaw --version
zeroclaw status

Después de la instalación

Una vez instalado (vía bootstrap o manualmente), deberías ver:

~/.zeroclaw/workspace/
├── config.toml          # Configuración principal
├── .pairing             # Secretos de emparejamiento (generado al primer inicio)
├── logs/                # Logs de daemon/agent
├── skills/              # Habilidades personalizadas
└── memory/              # Almacenamiento de contexto conversacional

Siguientes pasos:

Configura tus proveedores de AI en ~/.zeroclaw/workspace/config.toml
Revisa la referencia de configuración para opciones avanzadas
Inicia el agente: zeroclaw agent start
Prueba vía tu canal preferido (ver referencia de canales)

Configuración

Edita ~/.zeroclaw/workspace/config.toml para configurar proveedores, canales y comportamiento del sistema.

Referencia de Configuración Rápida

[providers.anthropic]
api_key = "sk-ant-..."
model = "claude-sonnet-4-20250514"

[providers.openai]
api_key = "sk-..."
model = "gpt-4o"

[channels.telegram]
enabled = true
bot_token = "123456:ABC-DEF..."

[channels.matrix]
enabled = true
homeserver_url = "https://matrix.org"
username = "@bot:matrix.org"
password = "..."

[memory]
kind = "markdown"  # o "sqlite" o "none"

[runtime]
kind = "native"    # o "docker" (requiere Docker)

Documentos de referencia completos:

Referencia de Configuración — todos los ajustes, validaciones, valores por defecto
Referencia de Proveedores — configuraciones específicas de proveedores de AI
Referencia de Canales — Telegram, Matrix, Slack, Discord y más
Operaciones — monitoreo en producción, rotación de secretos, escalado

Soporte de Runtime (actual)

ZeroClaw soporta dos backends de ejecución de código:

native (por defecto) — ejecución de proceso directo, camino más rápido, ideal para entornos de confianza
docker — aislamiento completo de contenedor, políticas de seguridad reforzadas, requiere Docker

Usa runtime.kind = "docker" si necesitas sandboxing estricto o aislamiento de red. Ver referencia de configuración para detalles completos.

Comandos

# Gestión de workspace
zeroclaw init                # Inicializa un nuevo workspace
zeroclaw status              # Muestra estado de daemon/agent
zeroclaw config validate     # Verifica sintaxis y valores de config.toml

# Gestión de daemon
zeroclaw daemon start        # Inicia el daemon en segundo plano
zeroclaw daemon stop         # Detiene el daemon en ejecución
zeroclaw daemon restart      # Reinicia el daemon (recarga de config)
zeroclaw daemon logs         # Muestra logs del daemon

# Gestión de agent
zeroclaw agent start         # Inicia el agent (requiere daemon ejecutándose)
zeroclaw agent stop          # Detiene el agent
zeroclaw agent restart       # Reinicia el agent (recarga de config)

# Operaciones de emparejamiento
zeroclaw pairing init        # Genera un nuevo secreto de emparejamiento
zeroclaw pairing rotate      # Rota el secreto de emparejamiento existente

# Tunneling (para exposición pública)
zeroclaw tunnel start        # Inicia un tunnel hacia el daemon local
zeroclaw tunnel stop         # Detiene el tunnel activo

# Diagnóstico
zeroclaw doctor              # Ejecuta verificaciones de salud del sistema
zeroclaw version             # Muestra versión e información de build

Ver Referencia de Comandos para opciones y ejemplos completos.

Arquitectura

┌─────────────────────────────────────────────────────────────────┐
│                        Canales (trait)                          │
│  Telegram │ Matrix │ Slack │ Discord │ Web │ CLI │ Custom       │
└─────────────────────────┬───────────────────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────────────────┐
│                      Orquestador Agent                          │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐          │
│  │   Ruteo      │  │   Contexto   │  │  Ejecución   │          │
│  │   Mensaje    │  │   Memoria    │  │   Herramienta│          │
│  └──────────────┘  └──────────────┘  └──────────────┘          │
└─────────────────────────┬───────────────────────────────────────┘
                          │
          ┌───────────────┼───────────────┐
          ▼               ▼               ▼
┌──────────────┐  ┌──────────────┐  ┌──────────────┐
│  Proveedores │  │   Memoria    │  │ Herramientas │
│   (trait)    │  │   (trait)    │  │   (trait)    │
├──────────────┤  ├──────────────┤  ├──────────────┤
│  Anthropic   │  │   Markdown   │  │  Filesystem  │
│   OpenAI     │  │    SQLite    │  │     Bash     │
│   Gemini     │  │     None     │  │   Web Fetch  │
│   Ollama     │  │    Custom    │  │   Custom     │
│   Custom     │  └──────────────┘  └──────────────┘
└──────────────┘
          │
          ▼
┌─────────────────────────────────────────────────────────────────┐
│                   Runtime (trait)                               │
│                  Native │ Docker                                │
└─────────────────────────────────────────────────────────────────┘

Principios clave:

Todo es un trait — proveedores, canales, herramientas, memoria, túneles
Los canales llaman al orquestador; el orquestador llama a proveedores + herramientas
El sistema de memoria gestiona contexto conversacional (markdown, SQLite, o ninguno)
El runtime abstrae la ejecución de código (nativo o Docker)
Sin lock-in de proveedor — intercambia Anthropic ↔ OpenAI ↔ Gemini ↔ Ollama sin cambios de código

Ver documentación de arquitectura para diagramas detallados y detalles de implementación.

Ejemplos

Bot de Telegram

[channels.telegram]
enabled = true
bot_token = "123456:ABC-DEF..."
allowed_users = [987654321]  # Tu ID de usuario de Telegram

Inicia el daemon + agent, luego envía un mensaje a tu bot en Telegram:

/start
¡Hola! ¿Podrías ayudarme a escribir un script Python?

El bot responde con código generado por AI, ejecuta herramientas si se solicita, y mantiene el contexto de conversación.

Matrix (cifrado extremo a extremo)

[channels.matrix]
enabled = true
homeserver_url = "https://matrix.org"
username = "@zeroclaw:matrix.org"
password = "..."
device_name = "zeroclaw-prod"
e2ee_enabled = true

Invita a @zeroclaw:matrix.org a una sala cifrada, y el bot responderá con cifrado completo. Ver Guía Matrix E2EE para configuración de verificación de dispositivo.

Multi-Proveedor

[providers.anthropic]
enabled = true
api_key = "sk-ant-..."
model = "claude-sonnet-4-20250514"

[providers.openai]
enabled = true
api_key = "sk-..."
model = "gpt-4o"

[orchestrator]
default_provider = "anthropic"
fallback_providers = ["openai"]  # Failover en error de proveedor

Si Anthropic falla o tiene rate-limit, el orquestador hace failover automáticamente a OpenAI.

Memoria Personalizada

[memory]
kind = "sqlite"
path = "~/.zeroclaw/workspace/memory/conversations.db"
retention_days = 90  # Purga automática después de 90 días

O usa Markdown para almacenamiento legible por humanos:

[memory]
kind = "markdown"
path = "~/.zeroclaw/workspace/memory/"

Ver Referencia de Configuración para todas las opciones de memoria.

Soporte de Proveedor

Proveedor	Estado	API Key	Modelos de Ejemplo
Anthropic	✅ Estable	`ANTHROPIC_API_KEY`	`claude-sonnet-4-20250514`, `claude-opus-4-20250514`
OpenAI	✅ Estable	`OPENAI_API_KEY`	`gpt-4o`, `gpt-4o-mini`, `o1`, `o1-mini`
Google Gemini	✅ Estable	`GOOGLE_API_KEY`	`gemini-2.0-flash-exp`, `gemini-exp-1206`
Ollama	✅ Estable	N/A (local)	`llama3.3`, `qwen2.5`, `phi4`
Cerebras	✅ Estable	`CEREBRAS_API_KEY`	`llama-3.3-70b`
Groq	✅ Estable	`GROQ_API_KEY`	`llama-3.3-70b-versatile`
Mistral	🚧 Planificado	`MISTRAL_API_KEY`	TBD
Cohere	🚧 Planificado	`COHERE_API_KEY`	TBD

Endpoints Personalizados

ZeroClaw soporta endpoints compatibles con OpenAI:

[providers.custom]
enabled = true
api_key = "..."
base_url = "https://api.your-llm-provider.com/v1"
model = "your-model-name"

Ejemplo: usa LiteLLM como proxy para acceder a cualquier LLM vía interfaz OpenAI.

Ver Referencia de Proveedores para detalles de configuración completos.

Soporte de Canal

Canal	Estado	Autenticación	Notas
Telegram	✅ Estable	Bot Token	Soporte completo incluyendo archivos, imágenes, botones inline
Matrix	✅ Estable	Contraseña o Token	Soporte E2EE con verificación de dispositivo
Slack	🚧 Planificado	OAuth o Bot Token	Requiere acceso a workspace
Discord	🚧 Planificado	Bot Token	Requiere permisos de guild
WhatsApp	🚧 Planificado	Twilio o API oficial	Requiere cuenta business
CLI	✅ Estable	Ninguno	Interfaz conversacional directa
Web	🚧 Planificado	API Key o OAuth	Interfaz de chat basada en navegador

Ver Referencia de Canales para instrucciones de configuración completas.

Soporte de Herramientas

ZeroClaw proporciona herramientas integradas para ejecución de código, acceso al sistema de archivos y recuperación web:

Herramienta	Descripción	Runtime Requerido
bash	Ejecuta comandos shell	Nativo o Docker
python	Ejecuta scripts Python	Python 3.8+ (nativo) o Docker
javascript	Ejecuta código Node.js	Node.js 18+ (nativo) o Docker
filesystem_read	Lee archivos	Nativo o Docker
filesystem_write	Escribe archivos	Nativo o Docker
web_fetch	Obtiene contenido web	Nativo o Docker

Seguridad de Ejecución

Runtime Nativo — se ejecuta como proceso de usuario del daemon, acceso completo al sistema de archivos
Runtime Docker — aislamiento completo de contenedor, sistemas de archivos y redes separados

Configura la política de ejecución en config.toml:

[runtime]
kind = "docker"
allowed_tools = ["bash", "python", "filesystem_read"]  # Lista permitida explícita

Ver Referencia de Configuración para opciones de seguridad completas.

Despliegue

Despliegue Local (Desarrollo)

zeroclaw daemon start
zeroclaw agent start

Despliegue en Servidor (Producción)

Usa systemd para gestionar el daemon y agent como servicios:

# Instala el binario
cargo install --path . --locked

# Configura el workspace
zeroclaw init

# Crea archivos de servicio systemd
sudo cp deployment/systemd/zeroclaw-daemon.service /etc/systemd/system/
sudo cp deployment/systemd/zeroclaw-agent.service /etc/systemd/system/

# Habilita e inicia los servicios
sudo systemctl enable zeroclaw-daemon zeroclaw-agent
sudo systemctl start zeroclaw-daemon zeroclaw-agent

# Verifica el estado
sudo systemctl status zeroclaw-daemon
sudo systemctl status zeroclaw-agent

Ver Guía de Despliegue de Red para instrucciones completas de despliegue en producción.

Docker

# Compila la imagen
docker build -t zeroclaw:latest .

# Ejecuta el contenedor
docker run -d \
  --name zeroclaw \
  -v ~/.zeroclaw/workspace:/workspace \
  -e ANTHROPIC_API_KEY=sk-ant-... \
  zeroclaw:latest

Ver Dockerfile para detalles de build y opciones de configuración.

Hardware Edge

ZeroClaw está diseñado para ejecutarse en hardware de bajo consumo:

Raspberry Pi Zero 2 W — ~512 MB RAM, núcleo ARMv8 único, < $5 costo de hardware
Raspberry Pi 4/5 — 1 GB+ RAM, multi-núcleo, ideal para workloads concurrentes
Orange Pi Zero 2 — ~512 MB RAM, quad-core ARMv8, costo ultra-bajo
SBCs x86 (Intel N100) — 4-8 GB RAM, builds rápidos, soporte Docker nativo

Ver Guía de Hardware para instrucciones de configuración específicas por dispositivo.

Tunneling (Exposición Pública)

Expón tu daemon ZeroClaw local a la red pública vía túneles seguros:

zeroclaw tunnel start --provider cloudflare

Proveedores de tunnel soportados:

Cloudflare Tunnel — HTTPS gratis, sin exposición de puertos, soporte multi-dominio
Ngrok — configuración rápida, dominios personalizados (plan de pago)
Tailscale — red mesh privada, sin puerto público

Ver Referencia de Configuración para opciones de configuración completas.

Seguridad

ZeroClaw implementa múltiples capas de seguridad:

Emparejamiento

El daemon genera un secreto de emparejamiento al primer inicio almacenado en ~/.zeroclaw/workspace/.pairing. Los clientes (agent, CLI) deben presentar este secreto para conectarse.

zeroclaw pairing rotate  # Genera un nuevo secreto e invalida el anterior

Sandboxing

Runtime Docker — aislamiento completo de contenedor con sistemas de archivos y redes separados
Runtime Nativo — se ejecuta como proceso de usuario, con alcance de workspace por defecto

Listas Permitidas

Los canales pueden restringir acceso por ID de usuario:

[channels.telegram]
enabled = true
allowed_users = [123456789, 987654321]  # Lista permitida explícita

Cifrado

Matrix E2EE — cifrado extremo a extremo completo con verificación de dispositivo
Transporte TLS — todo el tráfico de API y tunnel usa HTTPS/TLS

Ver Documentación de Seguridad para políticas y prácticas completas.

Observabilidad

ZeroClaw registra logs en ~/.zeroclaw/workspace/logs/ por defecto. Los logs se almacenan por componente:

~/.zeroclaw/workspace/logs/
├── daemon.log           # Logs del daemon (inicio, solicitudes API, errores)
├── agent.log            # Logs del agent (ruteo de mensajes, ejecución de herramientas)
├── telegram.log         # Logs específicos del canal (si está habilitado)
└── matrix.log           # Logs específicos del canal (si está habilitado)

Configuración de Logging

[logging]
level = "info"                           # debug, info, warn, error
path = "~/.zeroclaw/workspace/logs/"
rotation = "daily"                       # daily, hourly, size
max_size_mb = 100                        # Para rotación basada en tamaño
retention_days = 30                      # Purga automática después de N días

Ver Referencia de Configuración para todas las opciones de logging.

Métricas (Planificado)

Soporte de métricas Prometheus para monitoreo en producción próximamente. Seguimiento en #234.

Habilidades (Skills)

ZeroClaw soporta habilidades personalizadas — módulos reutilizables que extienden las capacidades del sistema.

Definición de Habilidad

Las habilidades se almacenan en ~/.zeroclaw/workspace/skills/<skill-name>/ con esta estructura:

skills/
└── my-skill/
    ├── skill.toml       # Metadatos de habilidad (nombre, descripción, dependencias)
    ├── prompt.md        # Prompt de sistema para la AI
    └── tools/           # Herramientas personalizadas opcionales
        └── my_tool.py

Ejemplo de Habilidad

# skills/web-research/skill.toml
[skill]
name = "web-research"
description = "Busca en la web y resume resultados"
version = "1.0.0"

[dependencies]
tools = ["web_fetch", "bash"]

<!-- skills/web-research/prompt.md -->

Eres un asistente de investigación. Cuando te pidan buscar algo:

1. Usa web_fetch para obtener el contenido
2. Resume los resultados en un formato fácil de leer
3. Cita las fuentes con URLs

Uso de Habilidades

Las habilidades se cargan automáticamente al inicio del agent. Referéncialas por nombre en conversaciones:

Usuario: Usa la habilidad web-research para encontrar las últimas noticias de AI
Bot: [carga la habilidad web-research, ejecuta web_fetch, resume resultados]

Ver sección Habilidades (Skills) para instrucciones completas de creación de habilidades.

Open Skills

ZeroClaw soporta Open Skills — un sistema modular y agnóstico de proveedores para extender capacidades de agentes AI.

Habilitar Open Skills

[skills]
open_skills_enabled = true
# open_skills_dir = "/path/to/open-skills"  # opcional

También puedes sobrescribir en runtime con ZEROCLAW_OPEN_SKILLS_ENABLED y ZEROCLAW_OPEN_SKILLS_DIR.

Desarrollo

cargo build              # Build de desarrollo
cargo build --release    # Build release (codegen-units=1, funciona en todos los dispositivos incluyendo Raspberry Pi)
cargo build --profile release-fast    # Build más rápido (codegen-units=8, requiere 16 GB+ RAM)
cargo test               # Ejecuta el suite de pruebas completo
cargo clippy --locked --all-targets -- -D clippy::correctness
cargo fmt                # Formato

# Ejecuta el benchmark de comparación SQLite vs Markdown
cargo test --test memory_comparison -- --nocapture

Hook pre-push

Un hook de git ejecuta cargo fmt --check, cargo clippy -- -D warnings, y cargo test antes de cada push. Actívalo una vez:

git config core.hooksPath .githooks

Solución de Problemas de Build (errores OpenSSL en Linux)

Si encuentras un error de build openssl-sys, sincroniza dependencias y recompila con el lockfile del repositorio:

git pull
cargo build --release --locked
cargo install --path . --force --locked

ZeroClaw está configurado para usar rustls para dependencias HTTP/TLS; --locked mantiene el grafo transitivo determinista en entornos limpios.

Para saltar el hook cuando necesites un push rápido durante desarrollo:

git push --no-verify

Colaboración y Docs

Comienza con el hub de documentación para un mapa basado en tareas:

Hub de Documentación: docs/README.md
Tabla de Contenidos Unificada de Docs: docs/SUMMARY.md
Referencia de Comandos: docs/commands-reference.md
Referencia de Configuración: docs/config-reference.md
Referencia de Proveedores: docs/providers-reference.md
Referencia de Canales: docs/channels-reference.md
Runbook de Operaciones: docs/operations-runbook.md
Solución de Problemas: docs/troubleshooting.md
Inventario/Clasificación de Docs: docs/docs-inventory.md
Snapshot de Triage de PR/Issue (al 18 de feb. de 2026): docs/project-triage-snapshot-2026-02-18.md

Referencias principales de colaboración:

Hub de Documentación: docs/README.md
Plantilla de Documentación: docs/doc-template.md
Checklist de Cambio de Documentación: docs/README.md#4-documentation-change-checklist
Referencia de Configuración de Canales: docs/channels-reference.md
Operaciones de Salas Cifradas Matrix: docs/matrix-e2ee-guide.md
Guía de Contribución: CONTRIBUTING.md
Política de Flujo de Trabajo PR: docs/pr-workflow.md
Playbook del Revisor (triage + revisión profunda): docs/reviewer-playbook.md
Mapa de Propiedad y Triage CI: docs/ci-map.md
Política de Divulgación de Seguridad: SECURITY.md

Para despliegue y operaciones de runtime:

Guía de Despliegue de Red: docs/network-deployment.md
Playbook de Agent Proxy: docs/proxy-agent-playbook.md

Apoyar a ZeroClaw

Si ZeroClaw ayuda a tu trabajo y deseas apoyar el desarrollo continuo, puedes donar aquí:

🙏 Agradecimientos Especiales

Un sincero agradecimiento a las comunidades e instituciones que inspiran y alimentan este trabajo de código abierto:

Harvard University — por fomentar la curiosidad intelectual y empujar los límites de lo posible.
MIT — por defender el conocimiento abierto, el código abierto, y la convicción de que la tecnología debería ser accesible para todos.
Sundai Club — por la comunidad, la energía, y la voluntad incesante de construir cosas que importan.
El Mundo y Más Allá 🌍✨ — a cada contribuyente, soñador, y constructor allá afuera que hace del código abierto una fuerza para el bien. Esto es por ti.

Construimos en código abierto porque las mejores ideas vienen de todas partes. Si estás leyendo esto, eres parte de esto. Bienvenido. 🦀❤️

⚠️ Repositorio Oficial y Advertencia de Suplantación

Este es el único repositorio oficial de ZeroClaw:

https://github.com/zeroclaw-labs/zeroclaw

Cualquier otro repositorio, organización, dominio o paquete que afirme ser "ZeroClaw" o que implique afiliación con ZeroClaw Labs es no autorizado y no está afiliado con este proyecto. Los forks no autorizados conocidos serán listados en TRADEMARK.md.

Si encuentras suplantación o uso indebido de marca, por favor abre un issue.

Licencia

ZeroClaw tiene doble licencia para máxima apertura y protección de contribuyentes:

Licencia	Casos de Uso
MIT	Código abierto, investigación, académico, uso personal
Apache 2.0	Protección de patentes, institucional, despliegue comercial

Puedes elegir cualquiera de las dos licencias. Los contribuyentes otorgan automáticamente derechos bajo ambas — ver CLA.md para el acuerdo de contribuyente completo.

Marca

El nombre ZeroClaw y el logo son marcas registradas de ZeroClaw Labs. Esta licencia no otorga permiso para usarlos para implicar aprobación o afiliación. Ver TRADEMARK.md para usos permitidos y prohibidos.

Protecciones del Contribuyente

Mantienes los derechos de autor de tus contribuciones
Concesión de patentes (Apache 2.0) te protege contra reclamos de patentes por otros contribuyentes
Tus contribuciones son atribuidas permanentemente en el historial de commits y NOTICE
No se transfieren derechos de marca al contribuir

Contribuir

Ver CONTRIBUTING.md y CLA.md. Implementa un trait, envía una PR:

Guía de flujo de trabajo CI: docs/ci-map.md
Nuevo Provider → src/providers/
Nuevo Channel → src/channels/
Nuevo Observer → src/observability/
Nuevo Tool → src/tools/
Nueva Memory → src/memory/
Nuevo Tunnel → src/tunnel/
Nueva Skill → ~/.zeroclaw/workspace/skills/<n>/

ZeroClaw — Cero sobrecarga. Cero compromiso. Despliega en cualquier lugar. Intercambia cualquier cosa. 🦀

FilesExpand file tree

README.es.md

Latest commit

History