openclaw-openclaw/docs/cli/attach.md at a905eb42acda7083bbfcd70a21780cd954f61070

mirror of https://github.com/openclaw/openclaw.git synced 2026-07-07 08:01:51 +08:00

Files

Peter Steinberger f7d7148cf0 docs: rewrite published docs grounded in current source (#100142 )

Source-grounded rewrite of 529 published docs pages with per-unit information-loss verification: 1,713 factual corrections cited to src/**, generated surfaces regenerated, frontmatter titles preserved for i18n, release notes pages untouched. All docs gates green.

Closes #100141

2026-07-05 00:32:47 -04:00

1.3 KiB

Raw Blame History

summary, read_when, title

summary

read_when

title

CLI reference for `openclaw attach` (launch Claude Code with a scoped Gateway MCP grant)

You want Claude Code to use OpenClaw Gateway MCP tools

You need a temporary session-bound MCP grant for an external harness

Attach CLI

openclaw attach launches Claude Code with a strict temporary MCP config bound to one Gateway session.

openclaw attach
openclaw attach --session agent:main:telegram:123 --ttl 600000
openclaw attach --print-config

Options:

--session <key> binds the grant to a Gateway session. Defaults to the main session.
--ttl <ms> requests a positive grant TTL in milliseconds. The Gateway applies its own ceiling.
--bin <path> selects the Claude Code binary. Default: claude.
--print-config writes the temporary .mcp.json, prints the launch command and env, and leaves the grant live until TTL expiry (it does not spawn Claude Code or revoke the grant).

The bearer token is passed through environment variables, not argv. OpenClaw launches Claude Code with --strict-mcp-config --mcp-config <path> so ambient Claude MCP servers do not join the attached session. Normal launches (without --print-config) revoke the grant when the Claude Code process exits.

See also: Gateway CLI, MCP CLI, and ACP CLI.

1.3 KiB Raw Blame History

1.3 KiB

Raw Blame History