智能体的人设
QwenPaw 通过一组 Markdown 文件定义智能体的"人设"，这些文件会被加载到系统提示词（System Prompt）中，决定智能体的行为风格、工作方式和个性特征。你可以通过编辑这些文件，让智能体成为符合你需求的专属助手——无论是严谨的工作助理、温暖的生活伙伴，还是技术专家。
人设文件
QwenPaw 的人设由 Markdown 文件定义，默认位于智能体工作区目录下。工作区目录的位置取决于 QWENPAW_WORKING_DIR 环境变量（默认为 ~/.qwenpaw），完整路径为：
$QWENPAW_WORKING_DIR/workspaces/{agent_id}/人设文件是灵活可扩展的。下面展示的是默认配置，你可以自由地添加新的 Markdown 文件或删除现有文件。只要在控制台的「Agent → Workspace」页面中启用它们，任何 Markdown 文件都能加载到系统提示词中。
默认人设文件
以下是默认配置中的人设文件（默认会被加载到系统提示词）：
AGENTS.md - 工作流程、规则与指南
详细的操作规范和工作流程，包括记忆管理策略、安全准则、工具使用说明等。这是智能体的"操作手册"，告诉它如何完成各种任务。
主要内容：
记忆文件的使用方式（MEMORY.md、memory/YYYY-MM-DD.md）
安全与隐私准则
工具与 Skills 的使用说明
心跳（Heartbeat）相关规则（如果启用）
SOUL.md - 核心身份与行为原则
定义智能体的价值观、风格和行为准则。这是智能体的"灵魂"，决定它的个性特征和处事方式。
主要内容：
核心准则（如何与用户互动）
边界与底线（什么不能做）
风格与语气（正式、随意、专业等）
连续性说明（通过文件保持记忆）
PROFILE.md - 身份信息与用户资料
记录智能体的身份设定和用户的个人资料，让智能体更了解你，提供个性化服务。
主要内容：
身份 section：智能体的名字、定位（AI助手/机器人/其他）、风格
用户资料 section：用户的名字、称呼、偏好、背景信息
MEMORY.md - 长期记忆
虽然 MEMORY.md 也是工作区中的重要文件，但它不会默认加载到系统提示词中。智能体在需要时可以通过 memory_search 工具主动检索记忆内容，或使用 read_file 工具读取。
为什么不默认加载？ 避免过多历史信息占用上下文空间。智能体会按需查询，保持系统提示词精简高效。
MEMORY.md 用于存储经过提炼的长期记忆（重要决策、经验教训、用户偏好等）。
详细说明： 参见 记忆 文档。
BOOTSTRAP.md - 首次引导
首次运行 qwenpaw init 时会自动创建 BOOTSTRAP.md，它引导用户和智能体进行初次"对话"，共同定义身份、偏好和风格。完成引导后，智能体会将设定写入 PROFILE.md 和 SOUL.md，然后删除 BOOTSTRAP.md。
引导内容：
确定智能体的名字、定位、风格
了解用户的基本信息
讨论行为偏好和边界
将内容写入对应文件后删除 BOOTSTRAP.md
完成引导后，BOOTSTRAP.md 会被删除，所以它只在首次初始化时存在。
配置与管理
通过控制台管理
在控制台的 工作区 → 文件 页面，你可以：
查看所有人设文件：左侧面板列出工作区中的所有 Markdown 文件（仅显示
.md文件）在线编辑内容：点击文件后在右侧编辑器中修改内容，点击「保存」生效
启用/禁用文件：每个文件右侧有开关，控制是否加载到系统提示词
已启用（开关打开，显示绿色圆点）：文件内容会加载到系统提示词
已禁用（开关关闭）：文件不会加载到系统提示词
调整加载顺序：启用的文件可以拖拽排序，顺序影响它们在系统提示词中的拼接顺序（从上到下依次拼接，靠前的文件会先被加载）
上传/下载工作区：
上传 ZIP 文件（最大 100MB）批量导入人设文件到工作区（会覆盖同名文件，非
.md文件不会在界面显示但会被保留）下载整个工作区为 ZIP 文件进行备份
查看工作区路径：页面顶部显示当前工作区的完整路径
热重载： 修改人设文件后会自动生效，无需重启服务。
多智能体支持： 每个智能体都有独立的人设配置，互不干扰。在控制台顶部切换智能体后，看到的是该智能体的专属工作区文件。这意味着：
不同智能体可以有完全不同的 AGENTS.md、SOUL.md、PROFILE.md
修改一个智能体的人设文件不会影响其他智能体
每个智能体的人设独立演化，互不冲突
详见 多智能体。
通过配置文件管理
你也可以直接修改智能体配置文件（~/.qwenpaw/workspaces/{agent_id}/agent.json）中的 system_prompt_files 字段来管理人设文件的加载：
{
"system_prompt_files": ["AGENTS.md", "SOUL.md", "PROFILE.md"]}数组中的文件名对应工作区目录下的 Markdown 文件
数组顺序决定加载顺序
留空或使用空数组时，智能体会使用默认的 "You are a helpful assistant" 提示词
首次初始化
运行 qwenpaw init 时，系统会根据你选择的语言（zh / en / ru）自动创建模板文件：
AGENTS.md
SOUL.md
PROFILE.md
BOOTSTRAP.md（首次引导文件）
如果使用 qwenpaw init --defaults，则默认语言为 zh（中文）。
切换智能体语言
你可以在控制台的「工作区 → 运行配置」页面中切换智能体语言。切换后：
系统会用新语言的模板覆盖现有的人设文件（AGENTS.md、SOUL.md、PROFILE.md）
这是智能体自身的语言设置，决定系统提示词的语言
与控制台界面的显示语言无关（控制台语言在右上角切换）
注意：切换智能体语言会覆盖你对人设文件的自定义修改，请在切换前备份重要内容（可使用控制台的「下载」功能备份整个工作区）。
System Prompt 的完整内容
除了人设文件，系统提示词中还包含以下自动生成的内容，确保智能体正常工作：
整体结构示意
[智能体身份标识] ↓ [人设文件内容 - 按启用顺序拼接] AGENTS.md SOUL.md PROFILE.md ↓ [运行时上下文信息 - 动态注入] - 当前时间与时区 - 工作目录路径 - 可用工具列表 - Skills 列表与说明
智能体身份标识
# Agent Identity
Your agent id is `{agent_id}`. This is your unique identifier in the multi-agent system.在多智能体环境中，智能体需要知道自己的 ID，以便调用其他智能体或识别自己的工作区。
上下文信息（运行时注入）
系统会在每次对话时动态注入以下信息：
当前时间与时区：让智能体知道现在是几点，正确处理时间相关的任务
工作目录路径：智能体当前的工作区位置
可用工具列表：当前启用的内置工具和 MCP 工具
Skills 列表：当前启用的 Skills 及其描述
这些信息不会保存在文件中，而是每次对话时根据当前状态动态生成，确保智能体始终拥有最新的环境信息。
工具与 Skills 的详细说明
系统提示词中还包含工具和 Skills 的说明：
内置工具与 MCP 工具：参见 MCP 与内置工具
Skills：每个启用的 Skill 会加载其
SKILL.md的部分内容（name 和 description 字段），告诉智能体该 Skill 的用途。详见 Skills
人设管理机制设计受 OpenClaw 启发，在此表示感谢。
内置 QA 智能体
QwenPaw 在首次运行 qwenpaw init 时会自动创建一个名为 "QA Agent" 的内置智能体（ID：QwenPaw_QA_Agent_0.2）。
QA 智能体的特点
这是一个专门用于回答 QwenPaw 相关问题的智能体：
专属人设：使用专门为问答优化的人设文件（与普通智能体不同）
预装技能：自动启用
guidance和QA_source_index技能，可以查询 QwenPaw 官方文档和源码工具配置：默认只启用核心工具（execute_shell_command、read_file、write_file、edit_file、view_image），其他内置工具默认禁用
自动维护：每次运行
qwenpaw init时会自动确保该智能体存在
如何使用？
您可以在控制台右上角的智能体切换器中选择 "QA Agent"，然后向它提问关于 QwenPaw 的任何问题。
适合问什么：
"如何配置钉钉频道？"
"记忆系统是怎么工作的？"
"支持哪些 MCP 工具？"
不适合做什么：
复杂的编程任务
可以修改或删除吗？
可以修改：您可以像管理其他智能体一样，在"智能体 → 工作区"中编辑它的人设文件，或在"智能体 → 技能"中调整技能和工具
可以删除：在"设置 → 智能体管理"页面删除（删除后不影响其他智能体，下次
qwenpaw init会重新创建）工作区位置：
$QWENPAW_WORKING_DIR/workspaces/QwenPaw_QA_Agent_0.2/（默认为~/.qwenpaw/workspaces/QwenPaw_QA_Agent_0.2/）
多智能体
QwenPaw 支持多智能体，允许您在同一个 QwenPaw 实例中运行多个独立的 AI 智能体。
本功能在 v0.1.0 中引入。
本文档包含两部分内容：
多智能体工作区 - 如何创建和管理多个智能体，每个智能体拥有独立的配置、记忆、技能和对话历史
智能体间协作 - 如何启用协作技能，让智能体之间可以互相通信，共同完成复杂任务
第一部分：多智能体工作区
什么是多智能体？
简单来说，多智能体就是让您可以在一个 QwenPaw 中运行多个"分身"，每个分身：
有自己的性格和专长（通过不同的人设文件配置）
记住各自的对话（互不干扰）
使用不同的技能（一个擅长代码，一个擅长写作）
连接不同的频道（一个负责钉钉，一个负责 Discord）
就像您有多个助手，每个助手各司其职。
为什么需要多智能体？
场景一：按用途分工
您可能需要：
一个日常助手 - 闲聊、查资料、记待办
一个代码助手 - 专注代码审查和开发
一个写作助手 - 专注文档撰写和润色
每个智能体专注自己的领域，互不干扰。
场景二：按平台分离
您可能在多个平台使用 QwenPaw：
钉钉 - 工作相关对话
Discord - 社区讨论
控制台 - 私人使用
不同平台的对话和配置完全隔离，不会混在一起。
场景三：测试与生产隔离
您可能需要：
生产智能体 - 稳定配置，用于日常工作
测试智能体 - 实验新功能，不影响生产环境
如何使用？（推荐方式）
在控制台中管理智能体
这是最简单的方式，无需任何命令行操作。
1. 查看和切换智能体
启动 QwenPaw 后，在控制台左上角可以看到智能体切换器：
┌───────────────────────────────────┐ │ 当前智能体 [默认智能体 ▼] (1) │ └───────────────────────────────────┘
点击下拉框可以：
查看所有智能体的名称和描述
切换到其他智能体
看到当前智能体的 ID
切换后，页面会自动刷新，显示新智能体的配置和数据。
2. 创建新智能体
进入设置 → 智能体管理页面：
点击"创建智能体"按钮
填写信息：
名称：给智能体起个名字（如"代码助手"）
描述：说明这个智能体的专长和用途（重要）
ID：留空自动生成，或自定义（如"coder"）
点击"确定"
创建后，新智能体会出现在列表中，您可以立即切换过去使用。
重要提示：描述字段非常重要！如果您计划使用多智能体协作功能，请在描述中清晰说明这个智能体的专长领域和擅长的任务类型。例如："专注于 Python/JavaScript 代码审查和重构优化"。智能体间协作时会读取这个描述来判断应该调用哪个智能体。
3. 为智能体配置专属设置
切换到某个智能体后，您可以为它单独配置：
频道 - 去"控制 → 频道"页面，启用/配置频道
技能 - 去"工作区 → 技能"页面，启用/禁用技能
工具 - 去"工作区 → 工具"页面，开关内置工具
人设 - 去"工作区 → 文件"页面，编辑 AGENTS.md 和 SOUL.md
这些配置只影响当前智能体，不会影响其他智能体。
4. 编辑和删除智能体
在设置 → 智能体管理页面：
点击"编辑"按钮修改智能体的名称和描述（修改描述后，系统会自动更新 PROFILE.md）
点击"删除"按钮移除智能体（默认智能体不能删除）
使用场景示例
示例一：工作与生活分离
场景：您希望工作对话和私人对话分开。
配置：
在控制台创建两个智能体：
work- 工作助手personal- 私人助手为
work智能体：启用钉钉频道
启用代码、文档相关技能
配置正式的人设（AGENTS.md）
为
personal智能体：启用 Discord 或控制台
启用娱乐、新闻相关技能
配置轻松的人设
使用：在钉钉聊天时自动使用 work 智能体，在 Discord 聊天时使用 personal 智能体。
示例二：专业助手团队
场景：您希望有多个专业领域的助手。
配置：
创建三个智能体：
coder- 代码助手（启用代码审查、文件操作技能）writer- 写作助手（启用文档处理、新闻摘要技能）planner- 任务助手（启用定时任务、邮件技能）根据需要切换到对应的智能体使用。
优点：每个智能体专注自己的领域，人设更精准，对话历史不会混淆。
示例三：多语言支持
场景：您需要中英文两个助手。
配置：
创建两个智能体：
zh-assistant- 中文助手（language: "zh"）en-assistant- 英文助手（language: "en"）分别编辑它们的 AGENTS.md 和 SOUL.md 为对应语言。
使用：需要中文对话时切换到 zh-assistant，需要英文时切换到 en-assistant。
常见问题
Q: 我需要创建多个智能体吗？
不一定。如果您的使用场景简单，只用默认智能体完全足够。
建议创建多个智能体的情况：
需要明确的功能分离（工作/生活、开发/写作等）
连接多个平台，希望每个平台有独立的对话历史
需要测试新配置，不想影响日常使用的智能体
Q: 智能体切换会丢失对话吗？
不会。每个智能体的对话历史都是独立保存的，切换只是改变当前查看的智能体。
Q: 多个智能体会增加成本吗？
不会。智能体只在使用时才调用 LLM，闲置的智能体不会产生费用。
Q: 可以同时使用多个智能体吗？
可以。如果您在钉钉和 Discord 都配置了不同的智能体，它们可以同时响应各自频道的消息。
Q: 如何删除智能体？
在控制台的"设置 → 智能体管理"页面点击删除按钮。
注意：删除后工作区目录会保留（防止误删数据），如需彻底清理，请手动删除 ~/.qwenpaw/workspaces/{agent_id} 目录。
Q: 默认智能体可以删除吗？
不建议删除。default 智能体是系统的默认后备，删除可能导致兼容性问题。
Q: 智能体之间可以共享什么？
全局共享：
模型提供商配置（API Key、模型选择）
环境变量（TAVILY_API_KEY 等）
独立配置：
频道配置
技能启用状态
对话历史
定时任务
人设文件
从单智能体升级
如果您之前使用 QwenPaw v0.0.x，升级到 v0.1.0 时会自动迁移：
首次启动时自动迁移
旧的配置和数据会自动移动到
default智能体工作区您无需手动操作任何文件
验证迁移
启动 QwenPaw 后，在控制台查看智能体列表
应该能看到一个名为"默认智能体"的智能体
您的旧对话和配置都应该还在
备份建议 升级前备份工作目录：
cp -r ~/.qwenpaw ~/.qwenpaw.backup
第二部分：智能体间协作
智能体之间可以互相通信和协作，完成单个智能体难以完成的复杂任务。
什么是智能体协作？
多智能体协作（Multi-Agent Collaboration） 是一个内置技能，启用后，您的智能体可以：
请求其他智能体的专业能力（如让代码智能体审查代码，让写作智能体润色文档）
访问其他智能体的工作区数据（如读取另一个智能体的配置或文件）
寻求第二意见或专业复核
在用户明确要求时调用指定的智能体
如何启用协作功能？
方式一：在控制台中启用（推荐）
切换到需要启用协作的智能体
进入智能体 → 技能页面
找到 Multi-Agent Collaboration（多智能体协作） 技能
勾选启用
点击"保存"
方式二：使用 CLI 启用
# 为默认智能体启用qwenpaw skills config# 为特定智能体启用qwenpaw skills config --agent-id abc123# 在交互界面中：# - 使用 ↑/↓ 键找到 "multi_agent_collaboration"# - 按空格键勾选# - 按回车键确认保存
协作如何触发？
启用协作技能后，智能体会在以下情况自动发起协作：
触发方式一：用户明确要求
用户在对话中直接要求调用其他智能体：
示例：
用户：请让代码助手帮我审查这段代码
当前智能体会：
识别到用户要求调用"代码助手"
查询可用智能体列表
向"代码助手"发送审查请求
等待"代码助手"返回结果
将结果整合后回复用户
触发方式二：智能体主动判断
智能体在处理任务时，如果判断需要其他智能体的专业能力，会主动发起协作：
示例：
用户：帮我生成一份技术文档并用专业语言润色 当前智能体的处理流程： 1. [生成技术文档初稿] 2. [判断：润色需要写作专长，调用写作助手] 3. [将初稿发送给写作助手] 4. [接收写作助手返回的润色版本] 5. [返回最终文档给用户]
使用场景示例
场景一：跨领域协作
用户：请分析我的项目结构并生成架构文档 流程： 1. 代码智能体分析项目结构 2. 代码智能体调用写作智能体 3. 写作智能体生成专业文档 4. 代码智能体返回最终结果
场景二：专业复核
用户：这段代码有什么问题？让资深助手也看看 流程： 1. 当前智能体先分析代码 2. 识别用户要求"资深助手"参与 3. 调用"资深助手"进行复核 4. 综合两方意见返回给用户
场景三：数据共享
用户：把财务智能体的月度报告发给我 流程： 1. 当前智能体识别需要"财务智能体"的数据 2. 向财务智能体请求月度报告 3. 接收报告数据 4. 格式化后发送给用户
协作的优势
专业分工：每个智能体专注自己的领域，协作时发挥各自优势
上下文隔离：不同智能体的对话历史互不干扰，避免混淆
灵活组合：根据任务需要动态组合不同智能体的能力
可扩展性：添加新智能体即可扩展整个系统的能力
智能体描述的重要性
为了让智能体间协作更有效，需要为每个智能体提供清晰的描述信息。
智能体如何识别彼此？
当智能体 A 需要与智能体 B 协作时，会先查询可用智能体列表。系统会读取并展示每个智能体的：
名称（name）- 智能体的显示名称
ID（agent_id）- 唯一标识符
描述（description）- 用户在创建智能体时填写的专长和用途说明
PROFILE.md（自动生成）- 系统根据智能体的配置自动生成的详细能力描述
如何填写描述？
在创建智能体时，描述字段应清晰说明：
✅ 好的描述示例：
专注于 Python/JavaScript 代码审查、重构和性能优化
负责文档撰写、内容润色和技术写作，擅长中英文双语
处理财务数据分析、报表生成和预算管理
❌ 不好的描述示例：
我的助手
测试用
（留空）
描述的关键要素：
明确的专长领域（如"代码审查"、"文档撰写"）
具体的技能范围（如"Python/JavaScript"、"中英文双语"）
擅长的任务类型（如"重构优化"、"数据分析"）
PROFILE.md 自动生成
系统会根据智能体的配置（包括名称、描述、技能、人设文件等）自动生成 PROFILE.md 文件，存放在工作区目录：
~/.qwenpaw/workspaces/{agent_id}/PROFILE.md您可以在工作区 → 文件页面查看自动生成的 PROFILE.md。
查看智能体信息
使用 CLI 查看所有智能体的信息：
qwenpaw agents list# 输出示例：# Agent ID: code_reviewer# Name: 代码审查助手# Description: 专注于 Python/JavaScript 代码审查、重构和性能优化# Workspace: ~/.qwenpaw/workspaces/code_reviewer# Profile: [自动生成的详细能力描述]
智能体在协作时会综合参考 Description 和 PROFILE.md 来做出决策。
注意事项
需要先启用 skill：协作功能需要显式启用"多智能体协作"技能
填写清晰的描述：创建智能体时，在描述字段清晰说明其专长和擅长的任务类型
系统自动生成 Profile：PROFILE.md 由系统自动生成，无需手动编写
自动化处理：启用后，智能体会根据需要自动发起协作，用户无需手动操作
性能考虑：协作涉及多个智能体，可能需要更多时间和 API 调用
合理规划：建议根据实际需求创建 3-5 个智能体，避免过度复杂化
进阶：CLI 和 API
如果您不熟悉命令行或 API，可以跳过这部分。所有功能都可以在控制台中完成。
智能体协作相关 CLI
智能体在启用协作技能后，会在后台自动使用以下 CLI 命令：
查询可用智能体
qwenpaw agents list
此命令会列出所有已配置的智能体，包括：
Agent ID：智能体的唯一标识
Name：智能体名称
Description：用户创建智能体时填写的专长和用途说明
Workspace：工作区路径
Profile：系统自动生成的
PROFILE.md文件内容（如果存在）
示例输出：
Agent ID: code_reviewer Name: 代码审查助手 Description: 专注于 Python/JavaScript 代码审查、重构和性能优化 Workspace: ~/.qwenpaw/workspaces/code_reviewer Profile: [自动生成的详细能力描述，基于配置和人设文件] Agent ID: writer_bot Name: 写作助手 Description: 负责文档撰写、内容润色和技术写作，擅长中英文双语 Workspace: ~/.qwenpaw/workspaces/writer_bot Profile: [自动生成的详细能力描述]
智能体在决定调用哪个智能体时，会综合参考 Description 和 Profile 来做出最佳选择。
与其他智能体通信
# 发起新对话（实时模式，适合快速查询）qwenpaw agents chat \ --from-agent <current_agent> \ --to-agent <target_agent> \ --text "请求内容"# 多轮对话（保持上下文）qwenpaw agents chat \ --from-agent <current_agent> \ --to-agent <target_agent> \ --session-id "<session_id>" \ --text "继续请求"# 复杂任务（后台模式，适合数据分析、报告生成等）qwenpaw agents chat --background \ --from-agent <current_agent> \ --to-agent <target_agent> \ --text "复杂任务请求"# 返回 [TASK_ID: xxx] [SESSION: xxx]# 查询后台任务状态（查询时 --to-agent 为可选）qwenpaw agents chat --background \ --task-id <task_id># 状态流程：submitted → pending → running → finished# finished 时结果显示：completed（✅）或 failed（❌）
后台模式说明：
当任务比较复杂（如数据分析、批量处理、报告生成）时，使用 --background 可以避免阻塞当前智能体，让它可以继续处理其他工作。提交后会返回 task_id，稍后可以查询任务状态和结果。
任务状态流程：
submitted：任务已接受，等待开始pending：排队等待执行running：正在执行finished：已完成（需检查结果是completed或failed）
建议使用后台模式的场景：
数据分析和统计
批量文件处理
生成详细报告
调用慢速外部API
不确定执行时间的复杂任务
说明：这些命令由智能体自动执行，通常无需用户手动调用。详见 CLI - 智能体。
智能体管理 CLI
所有支持多智能体的 CLI 命令都接受 --agent-id 参数（默认为 default）：
# 查看特定智能体的配置qwenpaw channels list --agent-id abc123 qwenpaw cron list --agent-id abc123 qwenpaw skills list --agent-id abc123# 为特定智能体创建定时任务qwenpaw cron create \ --agent-id abc123 \ --type agent \ --name "检查待办" \ --cron "0 9 * * *" \ --channel console \ --target-user "user1" \ --target-session "session1" \ --text "我有什么待办事项？"
支持 --agent-id 的命令：
qwenpaw channels- 频道管理qwenpaw cron- 定时任务qwenpaw daemon- 运行状态qwenpaw chats- 对话管理qwenpaw skills- 技能管理
不支持 --agent-id 的命令（全局操作）：
qwenpaw init- 初始化qwenpaw providers- 模型提供商qwenpaw models- 模型配置qwenpaw env- 环境变量
REST API
智能体管理 API
智能体专属 API
所有智能体专属的 API 都支持 X-Agent-Id HTTP 头：
# 获取特定智能体的对话列表curl -H "X-Agent-Id: abc123" http://localhost:7860/api/chats# 为特定智能体创建定时任务curl -X POST http://localhost:7860/api/cron/jobs \
-H "X-Agent-Id: abc123" \
-H "Content-Type: application/json" \
-d '{ ... }'支持 X-Agent-Id 的 API 端点：
/api/chats/*- 对话管理/api/cron/*- 定时任务/api/config/*- 频道和心跳配置/api/skills/*- 技能管理/api/tools/*- 工具管理/api/mcp/*- MCP 客户端管理/api/agent/*- 工作区文件和记忆
配置文件结构
如果您需要直接编辑配置文件：
旧结构（v0.0.x）
~/.qwenpaw/ ├── config.json # 包含所有配置 ├── chats.json ├── jobs.json ├── AGENTS.md └── ...
新结构（v0.1.0+）
~/.qwenpaw/ ├── config.json # 全局配置（providers, agents.profiles） └── workspaces/ ├── default/ # 默认智能体工作区 │ ├── agent.json # 智能体专属配置 │ ├── chats.json │ ├── jobs.json │ ├── AGENTS.md │ └── ... └── abc123/ # 其他智能体 └── ...
最佳实践
合理规划智能体数量
✅ 推荐：3-5 个智能体，按主要功能或平台分类
❌ 不推荐：为每个小功能都创建智能体
过多智能体会增加管理复杂度，得不偿失。
使用清晰的名称
✅ 好的命名：
default- 默认智能体work-assistant- 工作助手code-reviewer- 代码审查助手
❌ 不好的命名：
abc123- 无意义的随机字符test1,test2- 不清楚用途
定期备份
重要智能体的工作区建议定期备份：
# 备份特定智能体cp -r ~/.qwenpaw/workspaces/abc123 ~/backups/agent-abc123-$(date +%Y%m%d)# 备份所有智能体cp -r ~/.qwenpaw/workspaces ~/backups/workspaces-$(date +%Y%m%d)