Handoff（共享版）是一个专为知识工作者设计的协作工具，旨在帮助团队成员在共享的 Obsidian 知识库中快速创建临时交接文档，并推动永久性知识的沉淀与更新。它通过 Telegram 原生技能接口 `/handoff ` 触发，自动在本地文件系统 `$HOME/.openclaw/shared/` 下组织两类核心内容：临时性的交接文档和长期维护的知识资产。该工具特别适用于需要频繁跨团队或跨阶段传递工作进展、技术决策背景或调试路径的场景，确保关键信息不会因人员变动而丢失。 系统采用分层存储结构，将不同项目的临时交接记录按日期归档于 `handoff///` 目录下，而永久性知识则统一存放于 `knowledge//` 中。这种设计既保证了当前任务的灵活性和可追踪性，又为未来复用积累了结构化经验。当用户调用 `/handoff load ` 时，工具会智能检索最近的相关交接文件，提供摘要概览并询问是否更新或新建；而在常规模式下，则会引导用户撰写包含明确目标、已完成事项、当前状态及下一步行动的标准交接模板。 整个交互流程强调安全性和可控性——所有写入操作前必须显示完整路径并获得用户确认；对于涉及永久知识库的操作，系统会先读取目标文档，分析其风格与用途，输出清晰的补丁建议，仅在获得双重授权后才执行修改。此外，工具还支持生成详细的工作日志 `_work_log.md`，记录命令执行过程、文件变更摘要以及关键假设与错误排查思路，避免重复叙述交接文档中的宏观信息。
核心功能特点
- 基于 Telegram 原生技能接口 `/handoff ` 触发，支持默认模式与加载模式两种调用方式
- 自动管理临时交接文档与永久知识资产的分离存储结构，提升信息组织效率
- 强制预写确认机制，所有文件操作前必须展示完整路径并请求用户授权
- 永久知识更新采用‘提议-确认’流程，先输出结构化补丁再决定是否应用
- 内置标准化交接文档模板，涵盖目标、进展、状态与后续步骤等关键要素
- 可选生成独立工作日志文件，记录具体操作、输出结果与技术决策细节
适用场景
Handoff 特别适合敏捷开发团队在每日站会或迭代交接时使用。例如，某前端工程师完成了一个新组件的开发后，可通过 `/handoff frontend-ui` 快速创建一个当日交接文档，记录组件 API 设计、已解决的兼容性问题以及待测试用例，同时链接到相关的架构规范文档。若发现原有文档存在过时描述，还可提出更新建议供团队评审，实现知识同步与版本演进的双重价值。 另一个典型场景是跨职能协作项目中的问题复盘环节。当后端与运维团队联合调试一个生产环境故障时，使用 `/handoff ops-incident –log` 不仅能生成当天的应急处理记录，还能关联此前积累的监控策略文档，形成从临时响应到长期优化的闭环。由于交接文档被标记为临时性质，团队可在事后归档或删除，避免信息冗余，而关键结论则被沉淀至永久知识库供未来参考。 此外，远程工作的个人开发者也可利用此工具维护自己的知识流水线。无论是搭建本地实验环境还是研究新技术方案，每次会话结束时生成一份标准化的 handoff 文档，既能防止思路中断，也为后续回归提供了清晰上下文。结合 `–permanent` 参数，甚至可以将临时洞察转化为可复用的操作指南或最佳实践条目，逐步构建个人知识图谱。