🤖 内置智能体

ClawGoal 内置了多个开箱即用的智能体角色（Agent Role），每个角色拥有独立的人格设定（Soul）、能力边界（Capabilities）、权限范围（Permissions） 和工作流程（Pipeline Graph）。创建 Agent 时选择一个角色，即可获得对应的能力和行为模式。

角色总览

英文标识	中文名称	一句话描述	文档
`supervisor`	超级管理员	拥有完整工具权限，协调管理整个团队的系统管理员	查看详情
`researcher`	研究员	整合网络搜索、页面阅读和记忆查询的深度研究助理	查看详情
`writer`	内容写手	擅长博客文章、营销文案和 SEO 内容的专业写作助手	查看详情
`programer`	程序员	能够读写调试代码、支持远程节点执行的专业软件工程师	查看详情
`sparkCatcher`	灵感捕手	自动识别并保存每条消息（包括图片）中创意想法的灵感捕手	查看详情

角色配置结构

每个角色对应一个 YAML 配置文件，包含以下核心字段：

# 基础信息
name: supervisor          # 角色英文标识（与目录名一致）
title: 超级管理员           # 角色显示名称
description: ...          # 角色功能描述
avatar: system:supervisor # 默认头像

# 人格设定
soul: ...                 # 初始人格定义（Markdown 格式）

# 模型参数
model:
maxToolRounds: 20       # 每轮对话最大工具调用轮次

# 模型槽位
models:
default:
name: default          # 引用全局模型别名
temperature: 0.2       # 推理温度
maxTokens: 8192        # 最大输出 Token 数
systemPrompt: |        # 系统提示词
...

# 能力与权限
capabilities:
tools: [...]            # 允许使用的工具列表
skills: [...]           # 允许使用的技能列表
mcps: [...]             # 允许使用的 MCP 服务列表

permissions:
globalMemoryRead: true   # 是否允许读取全局记忆
globalMemoryUpdate: false# 是否允许更新全局记忆

# 自定义参数（仅部分角色）
param:
- name: codespace
title: 代码根路径
type: text
defaultValue: ''
required: true

# 工作流图（仅部分角色）
agents:
pipelineName:
description: ...
graph:
entryPoint: ...
nodes: [...]
edges: [...]

如何选择合适的角色

┌─ 需要管理协调、跨 Agent 调度？   → 超级管理员 (supervisor)
├─ 需要深度调研、多源信息查证？     → 研究员 (researcher)
├─ 需要文章写作、内容创作？         → 内容写手 (writer)
├─ 需要编码开发、远程执行？         → 程序员 (programer)
├─ 需要捕捉灵感、随手记录？         → 灵感捕手 (sparkCatcher)
└─ 不需要任何预设能力，完全自定义？  → 创建一个自定义 Agent

自定义 Agent vs 内置角色

内置角色开箱即用，但如果它们无法满足你的需求，你也可以创建自定义 Agent：

选择一个内置角色作为基础模板，在其上调整系统提示词
或者完全从零开始，自由配置系统提示词、工具权限和技能
自定义 Agent 的 config.yaml 存放在 data/agentRoles/<roleName>/ 目录下，优先级高于内置角色

💡 建议先尝试内置角色，再根据实际使用场景微调。