mirror of
https://github.com/openclaw/openclaw.git
synced 2026-08-17 08:02:12 -06:00
Peter Steinberger
75 lines
3.0 KiB
Markdown
75 lines
3.0 KiB
Markdown
---
|
|
summary: "CLI reference for attaching the TUI to a recent Gateway session"
|
|
read_when:
|
|
- You want to continue an existing Gateway session in the terminal
|
|
- You want to find a recent session by key, display name, or label
|
|
- You connect the TUI to a remote Gateway
|
|
title: "Resume"
|
|
---
|
|
|
|
# `openclaw resume`
|
|
|
|
Attach the terminal UI to an existing Gateway session. The session stays on
|
|
the Gateway; `resume` selects it and opens the existing [TUI](/cli/tui).
|
|
|
|
```bash
|
|
openclaw resume
|
|
openclaw resume <query>
|
|
```
|
|
|
|
With no query, OpenClaw displays up to 50 sessions active in the last seven
|
|
days. With a query, an exact session key wins; otherwise OpenClaw requires a
|
|
unique substring or fuzzy match across session keys, display names, and labels.
|
|
|
|
The picker omits bare `global` rows because they do not identify an owning
|
|
agent. To attach one, pass a fully qualified key such as
|
|
`openclaw resume agent:main:global`.
|
|
|
|
If a query is ambiguous, OpenClaw prints the matching candidates and exits with
|
|
status 1. If no recent session matches, it suggests the picker and
|
|
[`openclaw sessions`](/cli/sessions), then exits with status 1.
|
|
|
|
## Options
|
|
|
|
| Flag | Default | Description |
|
|
| ---------------------------- | -------------------------------- | ------------------------------------------------------------------- |
|
|
| `--url <url>` | `gateway.remote.url` from config | Gateway WebSocket URL. |
|
|
| `--token <token>` | (none) | Gateway token if required. |
|
|
| `--password <pass>` | (none) | Gateway password if required. |
|
|
| `--tls-fingerprint <sha256>` | `gateway.remote.tlsFingerprint` | Expected TLS certificate fingerprint for a pinned `wss://` Gateway. |
|
|
|
|
`resume` uses the same Gateway URL, authentication, and TLS resolution as
|
|
[`openclaw tui`](/cli/tui). It never starts a Gateway automatically. If the
|
|
configured Gateway is unavailable, start or repair it and rerun the command.
|
|
|
|
`resume` resolves configured Gateway auth SecretRefs for token/password auth
|
|
when possible (`env`/`file`/`exec`/`store` providers).
|
|
|
|
Gateway target precedence is explicit `--url`, then `OPENCLAW_GATEWAY_URL`,
|
|
then `gateway.remote.url` when `gateway.mode` is `remote`, then the local
|
|
loopback Gateway. For that local Gateway, `OPENCLAW_GATEWAY_PORT` takes
|
|
precedence over the active port recorded by a running Gateway, which takes
|
|
precedence over the configured or default `gateway.port`.
|
|
|
|
## Examples
|
|
|
|
```bash
|
|
# Choose from recent sessions
|
|
openclaw resume
|
|
|
|
# Exact key
|
|
openclaw resume agent:main:bugfix
|
|
|
|
# Unique display-name or label fragment
|
|
openclaw resume bugfix
|
|
|
|
# Remote Gateway override
|
|
openclaw resume bugfix --url wss://gateway.example.com --token <token>
|
|
```
|
|
|
|
## Related
|
|
|
|
- [TUI](/cli/tui)
|
|
- [Sessions](/cli/sessions)
|
|
- [TUI guide](/web/tui)
|