安装指南

拷贝包、合并配置、填好 secrets,就能跑。

这套流程对齐仓库契约:选择 agent 文件夹 → 放到本地 OpenClaw agents 目录 → 合并 config entry/snippet。

最快路径

三步心智模型

  1. 选择与你目标角色匹配的包。
  2. 拷贝到 ~/.openclaw/agents/<agentId>/
  3. 合并配置、补齐本地 secrets、重载 OpenClaw。
注意

哪些信息必须本地持有

  • Provider API keys
  • 频道鉴权状态
  • 收件人专属绑定
  • 任何环境相关的路由选择

Install an Agent from this Repository

Prerequisites

  • an existing OpenClaw installation
  • a working model/provider configuration on the target machine
  • permission to edit the target OpenClaw config

Install steps

1. Choose an agent package

Pick one agent folder from:

categories/<industry-id>/agents/<role-family-key>/<agentId>/

Example:

categories/industry-1-software-it/agents/engineering/i1-backend-engineer-java/

2. Copy the folder into your local OpenClaw agents directory

Target path:

~/.openclaw/agents/<agentId>/

Example:

~/.openclaw/agents/i1-backend-engineer-java/

3. Merge the provided config

Each package provides:

  • config/openclaw.agent.<agentId>.entry.json
  • config/openclaw.agent.<agentId>.snippet.json

Use:

  • entry.json if you are adding one agent entry into agents.list
  • snippet.json if you prefer a wrapper fragment for config merging

4. Fill local secrets and provider choices

Read:

config/SECRETS.md

Provide your own local configuration for:

  • model/provider credentials
  • any recipient-specific routing or environment decisions

5. Reload OpenClaw

Reload or restart OpenClaw so the new agent is available.

6. Start using the agent

Open a chat with the installed agent and give it a task that matches its role.

Important notes

  • Do not commit your local secrets back into this repository.
  • These packages are meant to be install-ready folders, not standalone apps.
  • Bundled agent-specific skills live under workspace/skills/ when included.
  • Clawin packages intentionally keep required skills inside each agent package so a single copied folder remains usable on its own.