W
AI-Wiki
ENTITY

agency-agents

基本定义

agency-agents是OpenClaw生态下的预定义Agent模板集合，本质为预打包的workspace资源包，不属于OpenClaw内置功能，仅作为标准化角色资源库存在，帮助用户避免从零搭建Agent的角色定位、能力边界等基础配置，快速搭建多Agent协作体系。

核心构成

每个agency-agents模板都包含完整的Agent运行所需配置，对应OpenClaw单Agent存储结构的工作区部分：

  1. 「SOUL.md」：定义Agent的角色定位、说话风格、任务边界等核心身份属性
  2. 「TOOLS.md」：定义Agent可调用的工具清单、权限范围
  3. 「memory/目录」：存储Agent的初始上下文记忆、行业知识库等内容

当前官方模板库覆盖SEO专家、前端工程师、文案写手、数据分析师、项目管理等主流专业角色。

激活生效流程

agency-agents模板不会自动被系统识别启用，必须完成以下三个步骤才算正式「入职」，可被调用参与OpenClaw多Agent协作机制|多Agent协作：

  1. workspace落地：将选中的角色模板放置到指定工作区目录，默认路径为~/.openclaw/agency-agents/[角色ID]/，也可自定义路径，后续在配置中关联即可
  2. agentDir创建：创建Agent的系统状态目录，用于存储模型配置、认证信息、运行状态等系统层内容，默认路径为~/.openclaw/agents/[角色ID]/agent/
  3. openclaw.json注册：通过命令行执行openclaw agents add [角色ID]，将Agent的ID、工作区路径、状态目录路径、可调用子Agent白名单等信息录入系统核心配置文件openclaw.json，完成注册

边界说明：OpenClaw不会自动扫描磁盘目录识别Agent，仅以openclaw.json中的注册信息为准，即使目录中存在模板文件，未完成注册也无法被系统调用。

快捷导入方式

agency-agents支持直接导入公开GitHub仓库进行批量注册，用户只需将模板仓库地址提供给OpenClaw，系统会自动完成模板拉取、workspace落地、agentDir创建、配置注册全流程，无需手动逐个配置，可大幅降低多Agent体系搭建成本。

相关条目