核心用法
multi-workplace 是一套面向多项目开发的智能工作空间管理系统，通过中心化注册表与分布式 .workplace/ 目录实现项目级隔离。用户可通过 workplace init/switch/scan 等命令快速初始化、切换或发现基于 Git 的工作空间，每个空间拥有独立的代理配置、记忆存储和部署文档。
系统采用 Swarm 风格的多代理架构：在 .workplace/agents/ 中定义角色（如 kernel、coder、reviewer），通过 YAML frontmatter 配置触发条件与交接逻辑；运行时利用 sessions_spawn 启动子代理，借助 chat.md 实现结构化消息传递，并由 Rust 文件监控服务器实时解析输出 JSON 流。
记忆层按 UUID 隔离，以 containerTag 对接 supermemory，支持跨会话项目状态感知。IDE 集成功能可将上下文自动同步至 Cursor（.cursor/rules）、Claude Code（CLAUDE.md）及 OpenCode（opencode.jsonc），降低多工具切换的认知负荷。
显著优点
- 深度隔离：项目级代理、记忆、技能完全独立，避免交叉污染
- 智能发现：自动识别
.git目录与子模块，降低手动维护成本 - 灵活编排：Swarm 式代理交接 + 结构化消息协议，支持复杂协作流程
- 生态兼容：原生支持主流 AI 编程工具，导出/导入便于团队共享配置
潜在局限
- 架构复杂度：需要理解注册表、工作空间目录、代理系统三层结构，学习曲线陡峭
- 平台依赖：Rust 服务器需针对目标平台编译，跨环境部署需额外构建步骤
- 存储膨胀：长期运行的项目会积累大量按日切割的记忆文件（
memory/YYYY-MM-DD.md） - IDE 覆盖风险：
workplace sync会直接覆写 Cursor/Claude Code 的配置文件，可能冲突
适合人群
- 同时维护 3+ 个代码仓库的全栈开发者或技术负责人
- 需要为不同项目配置差异化代理角色的AI 辅助编程重度用户
- 团队内追求工作环境标准化、可复现的DevOps/Platform 工程师
常规风险
- 注册表损坏：
~/.openclaw/workspace/.workplaces/的 JSON 文件若遭破坏，可能导致工作空间丢失或切换失败，建议定期导出备份 - 代理循环：Swarm 交接逻辑配置不当可能引发代理间无限循环调用
- 敏感信息泄露：
.workplace/目录可能包含部署凭证，导出 ZIP 时需确认排除策略