CLI 命令
附CLI
openclaw attach 会启动 Claude Code,并附带一个严格的临时 MCP 配置,该配置仅绑定到一个 Gateway 会话。
target 接受 Control UI 会话 URL、简写的 host/agent/ref、裸短引用或字面量 agent:... 会话键。URL 或主机目标会权威地选择该 Gateway;裸引用使用已配置的或默认的 Gateway。
选项:
--session <key>将授权绑定到 Gateway 会话。默认为主会话。--url <url>为裸引用或--session键选择 Gateway。不要将其与 URL 目标结合使用。--token <token>和--password <password>提供显式的 Gateway 身份验证。--tls-fingerprint <sha256>固定 Gateway TLS 证书。--ttl <ms>请求以毫秒为单位的正授权 TTL。Gateway 会应用其自身的上限。--bin <path>选择 Claude Code 二进制文件。默认值:claude。--print-config写入临时.mcp.json,打印启动命令和环境变量,并使授权保持有效直到 TTL 到期(不会启动 Claude Code,也不会撤销授权)。
请传递位置目标或 --session,但不能同时传递两者。短引用会在生成受限 attach 授权之前解析;缺失的会话不会被隐式创建。
URL 或主机目标绝不会重复使用已配置的凭据或 OPENCLAW_GATEWAY_TOKEN / OPENCLAW_GATEWAY_PASSWORD。它使用存储的设备令牌来获取确切的网关源,或显式的 --token/--password 凭据。第一次联系时,传递其中一个凭据一次,批准该网关的 Control UI 中的配对请求,然后重试;请参阅 Devices。会话 URL 必须保持无凭据:用户信息和敏感查询或片段参数(例如 token 和 password)将被拒绝。
目标解析使用与 openclaw tui 相同的会话目标错误矩阵。
承载令牌通过环境变量传递,而不是通过 argv。OpenClaw 会使用 --strict-mcp-config --mcp-config <path> 启动 Claude Code,因此环境中的 Claude MCP 服务器不会加入所附加的会话。普通启动(不使用 --print-config)会在 Claude Code 进程退出时撤销授权。
如果附加工具询问结构化问题,请通过 Control UI 或本机应用程序中的问题控件回答。附加授予范围工具到会话,但不识别活动的 OpenClaw 运行或其原始调用者权限,因此普通通道文本无法声明该问题。请参阅 询问用户 。
另请参阅:Control UI URLs、Devices、Gateway CLI、MCP CLI 和 ACP CLI。