核心用法
Multi-Workplace 是一套面向多项目开发的智能工作空间管理系统，核心解决开发者在多个代码库间切换时的上下文丢失、配置混乱问题。通过 workplace init 初始化项目后，系统自动识别 .git 目录结构，为每个项目创建隔离的 .workplace/ 目录，包含专属代理定义、记忆日志、技能库和部署配置。
命令体系覆盖完整生命周期：扫描发现(scan/link)、切换管理(switch/list)、代理控制(agent start/stop/kernel)、数据流通(export/import/sync)。特别值得注意的是 Swarm 风格的代理编排——通过 agents/*.md 定义角色，借助 chat.md 实现代理间结构化通信，Rust 文件监控服务器实时解析消息流转。
IDE 同步是差异化亮点，自动将工作空间上下文转换为 Cursor 的 .cursor/rules、Claude Code 的 CLAUDE.md、OpenCode 的 opencode.jsonc，实现"一处配置，多处生效"。
显著优点
- 隔离性优秀：记忆、技能、代理配置完全按 UUID 隔离，配合 Supermemory 的
containerTag实现跨会话状态保持 - 生态兼容性强：原生支持三大主流 AI 编码工具，降低迁移成本
- 架构清晰：注册表-工作空间双层结构，父/链接工作空间概念支持复杂项目拓扑
- 可观测性好：
process-status.json和结构化 chat 协议便于调试代理协作
潜在局限
- 依赖 Rust 二进制：跨平台支持需自行编译
workplace-server，增加了部署复杂度 - 记忆管理粗放：按日期的
YYYY-MM-DD.md日志结构，长期项目可能面临检索效率问题 - 缺乏权限控制：
.workplace/目录内敏感配置（如 deploy 文档）无加密或访问控制机制 - IDE 同步单向：从工作空间到 IDE 的规则推送，反向同步（IDE 修改回写）未明确说明
适合人群
- 同时维护 3+ 个代码库的全栈开发者或技术负责人
- 采用多代理协作（Multi-Agent）工作流的早期采用者
- 需要在 Cursor/Claude Code/OpenCode 间无缝切换的跨工具用户
- 追求项目级上下文持久化的团队，而非单次会话的临时任务
常规风险
- 数据泄露风险：
deploy/目录可能包含服务器凭证、API 密钥，导出 ZIP 时若未正确排除内存日志，可能导致敏感信息外泄 - 代理循环风险：Swarm handoff 机制若配置不当，可能出现代理间无限循环调用
- 注册表损坏：
~/.openclaw/workspace/.workplaces/的 JSON 文件若被手动篡改或并发写入，可能导致工作空间识别失败 - 子模块嵌套复杂度：自动将 Git 子模块识别为嵌套工作空间，深层嵌套可能引发路径解析异常