用途：当用户要求“在团队服务器上开会话”“把这个交接给某人”或“为新代理总结并启动”时，把本地工作移交给共享 OpenClaw Gateway。目标须是位于身份感知代理（Cloudflare Access）之后的共享网关。整个流程只发一次 Gateway 请求，以操作者自身身份完成，不依赖浏览器自动化、SSH 或轮询。
主要能力与用法：脚本为 scripts/team-handoff.sh。每台机器需一次性配置 ${XDG_CONFIG_HOME:-~/.config}/openclaw/team-handoff.env，包含 OPENCLAW_HANDOFF_URL、OPENCLAW_HANDOFF_AGENT、OPENCLAW_HANDOFF_PROJECT，另有可选变量。脚本使用隔离的 CLI profile，不改动本地 Gateway 配置。人类需在每个 Access 会话周期登录一次：cloudflared access login https://gateway.example。常用命令包括 probe、create（可带 --label、--name、--base、--message-file）、status、archive。create 会输出会话 URL、session key 和 run id；创建在 worktree 准备好之前即返回，随后读到 worktree: null 属正常，status 只读一次，不要循环轮询。
载荷建议：优先用分支，提交工作并用 --base 指定分支，长交接写在分支内；否则全部写入 --message-file，首行为标题。需说明范围边界，避免两个代理开重复 PR。
限制与失败模式：本地文件在 Gateway 不可达，需提交或总结数字。可能遇到 worktree 容量租约丢失、分支已存在等错误；若登录过期（Exec provider 退出码 1 或升级时 HTTP 302），应请人类重新登录，不要自行切换到 SSH 回退。--via ssh 仅在人类要求时使用。不要用代理浏览器操作网关 UI，不要把本机主 openclaw.json 指向共享网关。