Files
workspace/agents-config-analysis.md
aitest 15c4480db1 Add OpenClaw workspace configuration and tools
- Add agent configuration files (AGENTS.md, USER.md, IDENTITY.md, SOUL.md)
- Add git configuration and skills management scripts
- Add frontend/backend analysis tools and reports
- Add DingTalk media sender utilities and documentation
- Fix OpenClaw runtime environment (Node.js and Python)
- Configure git remotes and push scripts
2026-03-05 13:56:59 +09:00

3.6 KiB
Raw Permalink Blame History

OpenClaw Agents配置分析报告

配置概览

Agents List (代理列表)

  1. main - 主代理

    • 模型: glm5 (默认)
    • Workspace: C:\Users\ALC.openclaw\workspace
    • Agent配置: 存在 (agent/auth-profiles.json, agent/models.json)
  2. project - 项目代理

    • 模型: kimi
    • Workspace: C:\Users\ALC.openclaw\workspace-project
    • Agent配置: 缺失 (使用继承配置)
  3. coder - 编码代理

    • 模型: qwen3
    • Workspace: C:\Users\ALC.openclaw\workspace-coder
    • Agent配置: 缺失 (使用继承配置)

发现的问题

1. 配置不一致 ⚠️

  • openclaw.json中定义了project agent但引用的agentDir路径为C:\Users\ALC\.openclaw\agents\project\agent
  • 该目录不存在,只有C:\Users\ALC\.openclaw\agents\project\sessions目录

2. 缺失Agent配置文件 ⚠️

  • project和coder agent缺少agent配置目录和文件
  • 这可能导致它们无法使用自定义模型或认证配置

3. 模型别名不匹配 ⚠️

  • defaults中定义的primary模型是nvidia/z-ai/glm5
  • 但models别名中定义的是nvidia/z-ai/glm5: {alias: glm}
  • 当前session显示使用的是z-ai/glm4.7,与配置不一致

4. ACP配置可能不完整 ⚠️

  • acp.defaultAgent设置为coder
  • 但在agents.list中coder的ID和name都是coder
  • acp.allowedAgents包含maincoder但project不在列表中

优化建议

优先级高 🔴

  1. 修复Agent配置目录

    • 为project和coder创建agent配置目录
    • 或更新openclaw.json使用正确的路径
  2. 统一模型配置

    • 确认默认模型是glm5还是当前session使用的glm4.7
    • 更新models别名以匹配实际使用的模型
  3. 完善ACP配置

    • 如果project agent需要使用ACP功能添加到allowedAgents列表

优先级中 🟡

  1. Workspace命名规范

    • workspace-project和workspace-coder命名不够清晰
    • 建议改为workspace-kimi和workspace-qwen3以匹配模型
  2. 添加Agent描述

    • 在配置中添加每个agent的description字段
    • 便于理解每个agent的用途

优先级低 🟢

  1. 优化并发配置

    • maxConcurrent: 4 和 subagents.maxConcurrent: 8 看起来合理
    • 根据实际负载可以调整
  2. Compaction策略

    • 当前使用safeguard模式这是安全的默认选择
    • 可以根据使用情况考虑其他模式

配置正确性验证

Workspace目录都存在 模型API配置完整 ⚠️ Agent配置文件部分缺失 ⚠️ 模型版本存在不一致 认证配置正确 Gateway配置正常

建议的配置更新

修复agents.list配置

"list": [
  {
    "id": "main",
    "description": "Primary agent for main conversations"
  },
  {
    "id": "project",
    "name": "project",
    "description": "Agent for project management with Kimi model",
    "workspace": "C:\\Users\\ALC\\.openclaw\\workspace-project",
    "model": "kimi"
  },
  {
    "id": "coder",
    "name": "coder",
    "description": "Agent for coding tasks with Qwen3 model",
    "workspace": "C:\\Users\\ALC\\.openclaw\\workspace-coder",
    "model": "qwen3"
  }
]

添加缺失的Agent配置目录结构

需要创建:

  • C:\Users\ALC.openclaw\agents\project\agent\
  • C:\Users\ALC.openclaw\agents\coder\agent\

每个目录应包含:

  • auth-profiles.json
  • models.json (可选,如果使用继承配置则不需要)

总结

当前配置基本可用,但存在以下需要关注的问题:

  1. Agent配置文件缺失可能导致功能受限
  2. 模型版本不一致需要确认
  3. 建议添加描述和规范化命名

建议优先修复高优先级问题,中低优先级问题可以根据实际使用需求逐步优化。