当前推荐

复制一段安装 Prompt 发给你的 OpenClaw，后续就交给聊天完成。

这是这个 skill 上架 ClawHub 前最干净的用户路径。先通过公开文件安装聊天安装 skill，之后就可以让 OpenClaw 按需求推荐并安装 agent。

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. 复制 Prompt 并发给你的 OpenClaw。

2. 让它安装 skill，并确认已经可用。

3. 然后直接在聊天里说出你想要的 agent 需求。

次选路径

如果你更偏好包管理器式安装，可以把 ClawHub 作为备用路径。

这条路径适合 skill 上架 ClawHub 之后使用。它安装的是 skill 本身；真正的 agent 发现和安装仍然会在聊天里完成。

次选上架后使用

ClawHub 命令 clawhub install clawin-agent-match-install

通过 ClawHub 安装 skill 本身。
然后在聊天里描述你想要的 agent。
在 OpenClaw 执行安装前完成确认。

1

先把本地 OpenClaw 准备好

在推荐的用户路径里，你不需要手动操作 CLI，但你的 OpenClaw 环境仍然需要在后台具备本地 runtime 和安装工具。

本地已安装 OpenClaw OpenClaw 可调用 Clawin CLI

2

先把安装 skill 装起来

当前首选：把上面的安装 Prompt 发给你自己的 OpenClaw 聊天。次选路径：等这个 skill 上架 ClawHub 后再通过 ClawHub 安装。

复制安装 Prompt → 发给 OpenClaw clawhub install clawin-agent-match-install

3

通过聊天安装 agent

一旦 skill 可用，面向用户的流程就是对话式的：描述需求、查看候选、确认推荐结果，然后让 OpenClaw 为你完成选定 agent 的安装。

在聊天里说：“帮我找一个适合前端性能工作的 Clawin agent。” 然后在 OpenClaw 询问时确认安装。

装完后你会得到什么

你得到的是一个能在 OpenClaw 里直接调用的起点。

一个按角色组织的 package，被安装到你的本地 OpenClaw 环境里。
推荐的直接安装流程会一并处理注册和 main 调用权限。
包文档、workspace 材料和配置指引一起到位。

哪些东西仍然必须本地处理

Clawin 缩短安装路径，但本地归属仍然重要。

Provider API keys 和模型访问。
频道鉴权状态和收件人专属绑定。
机器相关的环境配置和路由选择。
正式使用前任何必要的安全复核。

推荐第一装

先从容易评估的 package 开始。

默认软件路线可以先装 web performance engineer；默认研究路线可以先装 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

常见阻塞项

大多数安装困惑都能提前解释。

本地仍然需要已经有 OpenClaw。
skill-first 路径并没有消除对 Clawin CLI 的后台依赖，只是用户不需要手动输入这些命令。
public catalog 不能替代你的本地 provider 配置。
有些 package 安装后仍需要本地后续配置。
对话式安装能帮你做选择，但执行安装前仍可能要求你确认。

Install Clawin Agents from the Public Catalog

Clawin now supports two practical install paths:

Discover by chat when you do not know the right agent yet
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.

优先通过聊天安装，ClawHub 作为次选路径。