Guía de instalación

Instala primero por chat, con ClawHub como ruta secundaria.

La ruta recomendada para el usuario ahora es conversacional: instala el skill de instalación de Clawin, pide el agente adecuado por chat, confirma la recomendación y deja que OpenClaw complete el flujo de instalación. ClawHub sigue siendo la ruta secundaria de distribución del skill.

Recomendado ahora

Copia un prompt de instalación, envíalo a tu OpenClaw y deja que el chat haga el resto.

Esta es la ruta más limpia antes de que el skill se publique en ClawHub. El prompt instala el skill conversacional desde archivos públicos y luego OpenClaw puede recomendar e instalar agentes según tu necesidad.

Prompt de instalación

Copia esto en tu chat de OpenClaw

Please install the OpenClaw skill `clawin-agent-match-install` from these public files.

Files:
- SKILL.md: https://agents.clawin.club/downloads/skills/clawin-agent-match-install/SKILL.md
- catalog_match.py: https://agents.clawin.club/downloads/skills/clawin-agent-match-install/scripts/catalog_match.py
- response-patterns.md: https://agents.clawin.club/downloads/skills/clawin-agent-match-install/references/response-patterns.md

What to do:
1. Create ~/.openclaw/workspace/skills/clawin-agent-match-install if it does not exist.
2. Download the files above into matching paths under that folder.
3. Verify the installed folder contains SKILL.md, scripts/catalog_match.py, and references/response-patterns.md.
4. If OpenClaw needs a restart to load the new skill, restart safely.
5. After installation, report the installed path and whether the skill is ready to use.

Do not claim success unless the files are actually installed.
1. Copia el prompt y envíalo a tu OpenClaw.
2. Deja que instale el skill y confirme que está listo.
3. Luego pide por chat el agente que quieres.
Ruta secundaria

Si prefieres una instalación estilo package manager, conserva ClawHub como ruta de respaldo.

Esta ruta es útil cuando el skill ya esté publicado en ClawHub. Instala el skill en sí; el descubrimiento e instalación de agentes sigue ocurriendo por chat.

Secundaria Úsala después de publicarlo
Comando de ClawHub clawhub install clawin-agent-match-install
  • Instala el skill por ClawHub.
  • Después usa el chat para describir el agente que necesitas.
  • Confirma antes de que OpenClaw ejecute la instalación.
1

Prepara tu OpenClaw local una vez

En la ruta recomendada, no necesitas operar el CLI manualmente, pero tu entorno de OpenClaw aún necesita tener disponibles su runtime local y herramientas de instalación en segundo plano.

OpenClaw instalado localmente Clawin CLI disponible para OpenClaw
2

Arranca el skill de instalación

La ruta preferida ahora es enviar el prompt de instalación de arriba a tu propio chat de OpenClaw. La ruta secundaria es usar ClawHub cuando el skill esté publicado allí.

Copiar prompt de instalación → enviarlo a OpenClaw clawhub install clawin-agent-match-install
3

Instala agentes por chat

Una vez disponible el skill, el flujo para el usuario es conversacional: describe el objetivo, revisa la shortlist, confirma la recomendación y deja que OpenClaw complete la instalación del agente elegido.

Pregunta por chat: “Encuéntrame un agente de Clawin para trabajo de performance frontend.” Luego confirma la instalación cuando OpenClaw lo pida.
Qué obtienes

Un punto de partida invocable dentro de OpenClaw.

  • Un paquete específico por rol instalado dentro de tu entorno local de OpenClaw.
  • El flujo directo recomendado también resuelve el registro y el acceso de llamada desde main.
  • La documentación, el material de workspace y la guía de config llegan juntos.
Qué sigue siendo local

Clawin acorta el setup, pero la responsabilidad local sigue importando.

  • API keys del proveedor y acceso a modelos.
  • Estado de autenticación del canal y bindings específicos del destinatario.
  • Configuración del entorno y ruteo específicos de la máquina.
  • Cualquier revisión de seguridad necesaria antes del uso real.
Buena primera instalación

Empieza con un paquete fácil de evaluar.

Una buena ruta de software es web performance engineer; una buena ruta de research es company research analyst.

  • clawin info software-it-web-performance-engineer-js-ts
  • clawin install software-it-web-performance-engineer-js-ts --allow-main
  • clawin info financial-research-company-research-analyst
Bloqueos comunes

La mayoría de la confusión de instalación es predecible.

  • OpenClaw sigue teniendo que existir localmente.
  • La ruta skill-first no elimina la dependencia en segundo plano del Clawin CLI; solo evita que el usuario tenga que ejecutar esos comandos manualmente.
  • El catálogo público no sustituye tu configuración local del proveedor.
  • Algunos paquetes todavía requieren configuración local adicional después de instalarse.
  • La instalación conversacional te ayuda a elegir, pero puede pedir confirmación antes de ejecutarse.

Install Clawin Agents from the Public Catalog

Clawin now supports two practical install paths:

  1. Discover by chat when you do not know the right agent yet
  2. Install by known ID when you already know the exact package you want

Both paths use the same public catalog and end in the same local OpenClaw install flow.


Prerequisites

  • Node.js and npm available on the target machine
  • an existing OpenClaw installation
  • permission to edit the target OpenClaw config
  • a working model/provider setup for the machine where the agent will run

Path A — Discover and install by chat

Use this path when you want OpenClaw to help you find the right Clawin package first.

1. Install or update the Clawin install skill

clawhub install clawin-agent-match-install

2. Make sure the public Clawin CLI is available locally

npm install -g agents.clawin
clawin init

3. Refresh from the current public catalog release

clawin catalog refresh --catalog https://agents.clawin.club/releases/2026-03-18-p6-full-catalog-1395-agent/catalogs/published/catalog.json

4. Ask OpenClaw to find the right agent

Example prompts:

  • Find me a Clawin agent for frontend performance work.
  • I need a Clawin agent for financial research company analysis.
  • Recommend a Clawin agent for growth and attribution work.

Expected flow:

  • the skill searches the public Clawin catalog
  • it recommends one or more candidate agents
  • it may compare options or explain tradeoffs
  • it should ask for confirmation before the actual install step

5. Confirm the install

After confirmation, use the recommended install path for the chosen agent. If you want to run the final install step yourself, use the direct path below.


Path B — Install directly by known agent ID

Use this path when you already know the exact package you want.

1. Install the Clawin CLI

npm install -g agents.clawin

2. Initialize Clawin on the machine

clawin init

This prepares the local Clawin workspace and config wiring used for catalog-driven installs.

3. Refresh from a published catalog

Catalog URL pattern:

https://agents.clawin.club/releases/<release>/catalogs/published/catalog.json

Current full-catalog public release:

clawin catalog refresh --catalog https://agents.clawin.club/releases/2026-03-18-p6-full-catalog-1395-agent/catalogs/published/catalog.json

Current scoped financial research release (52 agents):

clawin catalog refresh --catalog https://agents.clawin.club/releases/2026-03-16-p5-financial-research-v2-52-agent/catalogs/published/catalog.json

Use the published release you want. The URL always points to a release-scoped catalog snapshot under /releases/<release>/catalogs/published/catalog.json.

4. Search and inspect agents

Search the catalog you just refreshed. For the full public catalog, a software example is:

clawin search "web performance"

For the financial research slice, an example is:

clawin search "financial research"

Inspect one package before install. Example financial research package:

clawin info financial-research-company-research-analyst

The scoped financial research release publishes 52 agent ids across the broader financial research industry roster, including equity analysis, screening and comparison, market monitoring, event and earnings monitoring, and portfolio research support.

5. Install the agent

Recommended direct command:

clawin install financial-research-company-research-analyst --allow-main

The recommended direct path installs the agent and completes the registration steps needed so main can call it.

If you prefer the older explicit mental model, this is the modern one-step equivalent of install + register + allow-main.

The install command handles the package fetch and local placement for you. You do not need to manually copy a folder from categories/... into ~/.openclaw/agents/<agentId>/.

6. Review status and local config follow-up

Check the local install result:

clawin status financial-research-company-research-analyst

After install, finish the local-only pieces required by your environment:

  • review the generated registration/config output
  • keep provider credentials and other secrets local
  • apply any environment-specific routing or recipient bindings

If the installed package ships a config entry or snippet, treat it as local configuration material. In safe-mode flows, review the generated registration/config snippet before enabling the agent in your own OpenClaw setup.

7. Reload OpenClaw if needed

If your OpenClaw process does not hot-reload the new registration automatically, reload or restart it so the agent becomes available.


Good first installs

Software / developer path:

clawin info software-it-web-performance-engineer-js-ts
clawin install software-it-web-performance-engineer-js-ts --allow-main

Research path:

clawin info financial-research-company-research-analyst
clawin install financial-research-company-research-analyst --allow-main

Important notes

  • Do not commit your local secrets back into this repository.
  • The public catalog is release-scoped; refresh the catalog again when you want a newer published release.
  • Bundled agent-specific skills still live under workspace/skills/ inside installed packages when included.
  • Clawin packages intentionally keep required skills inside each agent package so a single install remains usable on its own.
  • The conversational install skill helps you choose, but it may still ask you to confirm before the final install runs.
  • Provider API keys, channel auth state, recipient-specific bindings, and environment-specific routing choices remain local responsibilities.
Theme