Agent Recruiter

招聘 Agent 工具 - 创建、配置和管理 OpenClaw Agent。 参考 [agency-agents](https://github.com/msitarzewski/agency-agents) 的专业 agent 模板结构。 **当以下情况时使用此 Skill**: (1) 需要创建新的 Agen...

Security Scan

The skill generally does what its name says (creates and wires up OpenClaw agents), but it omits required runtime dependencies and will copy authentication files (potentially copying secrets) without warning—so the behavior is coherent but has risky/undocumented aspects you should review before installing.

Purpose & Capability

The name/description match the included files and script: it creates agent directories, generates agent.json, updates openclaw.json and restarts the gateway. However, the package metadata claims no required binaries while the runtime script expects node and the openclaw CLI to be present; that mismatch should be fixed or disclosed.

Instruction Scope

SKILL.md and scripts instruct the agent to read and modify user configuration under ~/.openclaw, copy models.json and auth-profiles.json from existing agents, and restart the gateway. These actions are in-scope for agent creation but include copying auth-profiles.json (which may contain secrets) and performing system-wide changes (openclaw.json modification and gateway restart) without explicit safeguards.

Install Mechanism

This is an instruction-only skill with an included shell script and templates — there is no external download or package installation. No high-risk installers or remote URLs are used in the files provided.

Credentials

The skill declares no required environment variables or credentials, but it will copy auth-profiles.json from another agent if present. That file is likely to contain authentication information; duplicating it into new agent directories can spread sensitive credentials. Also the script uses node and openclaw binaries but does not declare them as required.

Persistence & Privilege

The skill does not request always:true or any special platform privileges. It does modify OpenClaw configuration files and restarts the gateway (normal for this purpose), which is an expected level of system change for an agent-creation tool.

What to consider before installing

This skill appears to implement an agent-creation workflow, but take these precautions before installing or running it: - Verify prerequisites: ensure node and the openclaw CLI are installed; the script calls `node -e` and `openclaw gateway restart` but the skill metadata lists no required binaries. - Backup before running: save a copy of ~/.openclaw/openclaw.json (and any other config) so you can restore if changes are unintended. - Inspect auth-profiles.json: the script may copy ~/.openclaw/agents/mike/agent/auth-profiles.json into the new agent; review that file for API keys or secrets and decide whether you want to duplicate those credentials. - Dry run / test with non-sensitive data: try creating a test agent id and verify outcome before using real group IDs or production model/auth files. - Confirm restart impact: restarting the gateway affects all agents; schedule the operation to avoid disrupting live workflows. If you want this skill to be less risky, ask the maintainer to: (1) declare required binaries (node, openclaw), (2) add an explicit prompt/confirmation before copying auth files, and (3) provide a dry-run mode and safer handling of secrets.

Agent Recruiter - 招聘 Agent 工具

🎯 一键招聘（推荐）

用法:

# 基础用法 - 创建常驻 Agent（绑定群聊）
~/.openclaw/workspace-recruiter/skills/agent-recruiter/scripts/recruit-agent.sh <agent_id> <agent_name> [群聊 ID]

# 示例：创建 Tim 维护专员，绑定到指定群
~/.openclaw/workspace-recruiter/skills/agent-recruiter/scripts/recruit-agent.sh tim "Tim 维护专员" <群聊 ID>

脚本会自动完成:

1. ✅ 创建 Agent 目录结构 (~/.openclaw/agents/<id>/agent/ + ~/.openclaw/workspace-<id>/)
2. ✅ 生成 agent.json 配置
3. ✅ 复制 models.json 和 auth-profiles.json
4. ✅ 生成 SOUL.md、AGENTS.md、IDENTITY.md 模板
5. ✅ 更新 openclaw.json（添加 agent 和 binding）
6. ✅ 重启 Gateway

---

📁 Agent 文件结构（参考 agency-agents）

每个 Agent 包含以下核心文件：

~/.openclaw/
├── agents/
│   └── <agent_id>/
│       └── agent/
│           ├── agent.json           # Agent 基本配置
│           ├── models.json          # 模型配置
│           └── auth-profiles.json   # 认证配置
│
├── workspace-<agent_id>/
│   ├── SOUL.md                      # ⭐ Agent 人格和身份（核心）
│   ├── AGENTS.md                    # 工作区规范
│   ├── IDENTITY.md                  # 名称、Emoji、Vibe
│   ├── TOOLS.md                     # 本地工具配置
│   ├── USER.md                      # 用户信息
│   ├── HEARTBEAT.md                 # 定期任务清单
│   └── memory/
│       ├── YYYY-MM-DD.md            # 每日日志
│       └── MEMORY.md                # 长期记忆
│
└── openclaw.json
    ├── agents.list[]                # Agent 注册列表
    └── bindings[]                   # 消息路由绑定

核心文件说明

文件	作用	必填
SOUL.md	Agent 的人格、使命、工作流程、成功指标	⭐ 必填
AGENTS.md	工作区使用规范、记忆系统、工具指南	✅ 推荐
IDENTITY.md	名称、Emoji、Vibe、专业领域	✅ 推荐
agent.json	OpenClaw 注册配置	⭐ 必填

---

📋 SOUL.md 模板结构（参考 agency-agents）

# SOUL.md - Who You Are

## 🧠 Your Identity & Memory
- **Role**: [核心角色定位]
- **Personality**: [性格特点]
- **Memory**: [记住的成功模式]
- **Experience**: [经历过的案例]

## 🎯 Your Core Mission
### [核心职责 1]
- [具体任务]
- [可量化目标]

### [核心职责 2]
- [具体任务]
- [交付标准]

## 🚨 Critical Rules You Must Follow
### [规则类别 1]
- [必须遵守的规则]

## 📋 Your Technical Deliverables
### [交付物示例]
```code
// 代码或模板示例

🔄 Your Workflow Process

Step 1: [阶段名]

• [行动]
• [产出]

💭 Your Communication Style

• Be [特质]: "示例表达"

📊 Your Success Metrics

You're successful when:

• [可量化指标 1]
• [可量化指标 2]

---

## 🚀 手动创建 Agent（学习用）

### 步骤 1: 创建目录结构
```bash
mkdir -p ~/.openclaw/agents/<agent_id>/agent
mkdir -p ~/.openclaw/workspace-<agent_id>

步骤 2: 创建 agent.json

{
  "id": "<agent_id>",
  "name": "<agent_name>",
  "workspace": "/Users/junchen/.openclaw/workspace-<agent_id>",
  "agentDir": "/Users/junchen/.openclaw/agents/<agent_id>/agent",
  "model": "modelstudio/qwen3.5-plus"
}

步骤 3: 复制模型和认证配置

cp ~/.openclaw/agents/mike/agent/models.json ~/.openclaw/agents/<agent_id>/agent/
cp ~/.openclaw/agents/mike/agent/auth-profiles.json ~/.openclaw/agents/<agent_id>/agent/

步骤 4: 创建核心文件

# 使用模板
cp ~/.openclaw/workspace-recruiter/skills/agent-recruiter/templates/SOUL.md.template ~/.openclaw/workspace-<agent_id>/SOUL.md
cp ~/.openclaw/workspace-recruiter/skills/agent-recruiter/templates/AGENTS.md.template ~/.openclaw/workspace-<agent_id>/AGENTS.md
cp ~/.openclaw/workspace-recruiter/skills/agent-recruiter/templates/IDENTITY.md.template ~/.openclaw/workspace-<agent_id>/IDENTITY.md

# 编辑内容
vim ~/.openclaw/workspace-<agent_id>/SOUL.md
vim ~/.openclaw/workspace-<agent_id>/IDENTITY.md

步骤 5: 更新 openclaw.json

在 agents.list 添加：

{
  "id": "<agent_id>",
  "name": "<agent_name>",
  "workspace": "/Users/junchen/.openclaw/workspace-<agent_id>",
  "agentDir": "/Users/junchen/.openclaw/agents/<agent_id>/agent",
  "model": "modelstudio/qwen3.5-plus"
}

在 bindings 添加（绑定群聊）：

{
  "type": "route",
  "agentId": "<agent_id>",
  "match": {
    "channel": "feishu",
    "peer": {
      "kind": "group",
      "id": "<群聊 ID>"
    }
  }
}

步骤 6: 重启 Gateway

openclaw gateway restart

---

📚 示例 Agent

Tim - 维护专员

参考模板：templates/examples/tim/SOUL.md 和 templates/examples/tim/IDENTITY.md

职责:

• 每小时系统健康巡检
• cron/agent/skill 监控
• 异常告警和修复

配置:

# 创建 Tim
./scripts/recruit-agent.sh tim "Tim 维护专员" <群聊 ID>

# 自定义 SOUL.md
vim ~/.openclaw/workspace-tim/SOUL.md

---

🔧 工具函数

检查 Agent 是否存在

ls ~/.openclaw/agents/<agent_id>/agent/agent.json 2>/dev/null && echo "✅ 存在" || echo "❌ 不存在"

查看 Agent 配置

cat ~/.openclaw/agents/<agent_id>/agent/agent.json
cat ~/.openclaw/workspace-<agent_id>/SOUL.md

查看 Binding 路由

cat ~/.openclaw/openclaw.json | grep -A8 '"agentId": "<agent_id>"'

测试 Gateway 状态

openclaw gateway status

列出所有 Agent

cat ~/.openclaw/openclaw.json | jq '.agents.list[].id'

---

⚠️ 注意事项

1. agent_id 必须唯一 - 不能与现有 agent 重复
2. workspace 目录必须存在 - 否则 agent 启动会失败
3. SOUL.md 是核心 - 定义 Agent 的人格和行为
4. models.json 和 auth-profiles.json 必须配置 - 否则无法调用模型
5. Binding 路由的群 ID 必须正确 - 否则消息无法路由
6. 修改 openclaw.json 后必须重启 Gateway - 配置才能生效

---

📚 参考资源

• agency-agents: https://github.com/msitarzewski/agency-agents

  • 144 个专业化 Agent 模板
  • 涵盖 Engineering、Design、Marketing、Sales 等 12 个部门
  • 专业的 SOUL.md 结构和成功指标定义

• Agent 目录: ~/.openclaw/agents/

• Workspace 目录: ~/.openclaw/workspace-<agent_id>/

• 配置文件: ~/.openclaw/openclaw.json

• Gateway 日志: /tmp/openclaw/openclaw-*.log

• OpenClaw 文档: /opt/homebrew/lib/node_modules/openclaw/docs

---

🔄 优化现有 Agent 的 SOUL/IDENTITY

适用场景

• Agent 已创建，但 SOUL.md/IDENTITY.md 还是模板
• 需要根据具体职责定制人格和工作流程
• 参考 agency-agents 的 144 个专业模板来匹配角色

优化流程

Step 1: 读取现有配置

cat ~/.openclaw/workspace-<agent_id>/SOUL.md
cat ~/.openclaw/workspace-<agent_id>/IDENTITY.md

识别: 哪些是模板占位符（如 [Agent 显示名称]），哪些已有内容

Step 2: 参考 agency-agents 模板

• 浏览 https://github.com/msitarzewski/agency-agents
• 找最匹配的角色类别（Engineering、Sales、Marketing 等）
• 参考对应模板的 SOUL.md 结构

常见角色参考:

角色类型	agency-agents 参考
系统维护/DevOps	engineering-devops-automator.md
资讯分析师	research-news-analyst.md
金融分析师	sales-sales-pipeline-analyst.md
客服支持	support-customer-success.md

Step 3: 结合用户需求定制

• 问清楚 Agent 的具体职责（4 大板块以内）
• 确定使用的工具/技能（如 Tavily、cron、API 等）
• 明确输出格式和交付标准

Step 4: 更新 SOUL.md + IDENTITY.md

保持 agency-agents 结构:

• 🧠 Identity & Memory
• 🎯 Core Mission（分板块，每板块有默认要求）
• 🚨 Critical Rules
• 📋 Technical Deliverables（含模板示例）
• 🔄 Workflow Process（Step 1-4）
• 💭 Communication Style
• 📊 Success Metrics（可量化）

IDENTITY.md 精简版:

• Name/Creature/Vibe/Emoji
• Specialty（一句话）
• Personality Traits（3-4 个）
• When to Use（使用场景）
• Success Metrics

实战示例：David 资讯专家

背景: Agent 已创建，但 SOUL/IDENTITY 是模板

优化过程:

1. 读取发现是模板 → 需要填充实际内容
2. 参考 agency-agents 资讯分析类模板
3. 结合需求：Tavily 搜索 + AI 资讯 + 政治 + 金融
4. 按 agency-agents 结构重写 SOUL.md 和 IDENTITY.md

关键改进:

• ✅ 明确 4 大职责板块（AI 大模型、AI 行业、国际政治、金融）
• ✅ 强调必须用 Tavily 搜索（不依赖训练数据）
• ✅ 每条信息必须标注来源 URL
• ✅ 成功指标可量化（30 秒掌握、100% 可追溯）
• ✅ 加了 Instructions Reference 段落

---

🎯 最佳实践

1. SOUL.md 要具体

❌ 坏例子："你是一个有用的助手" ✅ 好例子："你是系统维护专员，每小时巡检 cron/agent/skill 状态，连续错误≥3 次必须告警"

2. 成功指标要可量化

❌ 坏例子："系统运行良好" ✅ 好例子："系统异常发现时间 <1 小时，cron 连续错误率 <5%"

3. 工作流程要清晰

❌ 坏例子："检查系统状态" ✅ 好例子："Step1: 执行 gateway status → Step2: 读取 jobs.json → Step3: 生成报告"

4. 人格特质要鲜明

❌ 坏例子："友好、专业" ✅ 好例子："细致、主动、预防性思维、系统化"

5. 复用 agency-agents 模板

❌ 坏例子：自己瞎写结构 ✅ 好例子：参考 agency-agents 的专业模板，保持一致性