mirror of
https://github.com/openclaw/openclaw.git
synced 2026-04-29 04:57:09 +02:00
51 lines
1.4 KiB
Markdown
51 lines
1.4 KiB
Markdown
---
|
|
summary: "CLI reference for `openclaw proxy`, the local debug proxy and capture inspector"
|
|
read_when:
|
|
- You need to capture OpenClaw transport traffic locally for debugging
|
|
- You want to inspect debug proxy sessions, blobs, or built-in query presets
|
|
title: "Proxy"
|
|
---
|
|
|
|
# `openclaw proxy`
|
|
|
|
Run the local explicit debug proxy and inspect captured traffic.
|
|
|
|
This is a debugging command for transport-level investigation. It can start a
|
|
local proxy, run a child command with capture enabled, list capture sessions,
|
|
query common traffic patterns, read captured blobs, and purge local capture
|
|
data.
|
|
|
|
## Commands
|
|
|
|
```bash
|
|
openclaw proxy start [--host <host>] [--port <port>]
|
|
openclaw proxy run [--host <host>] [--port <port>] -- <cmd...>
|
|
openclaw proxy coverage
|
|
openclaw proxy sessions [--limit <count>]
|
|
openclaw proxy query --preset <name> [--session <id>]
|
|
openclaw proxy blob --id <blobId>
|
|
openclaw proxy purge
|
|
```
|
|
|
|
## Query presets
|
|
|
|
`openclaw proxy query --preset <name>` accepts:
|
|
|
|
- `double-sends`
|
|
- `retry-storms`
|
|
- `cache-busting`
|
|
- `ws-duplicate-frames`
|
|
- `missing-ack`
|
|
- `error-bursts`
|
|
|
|
## Notes
|
|
|
|
- `start` defaults to `127.0.0.1` unless `--host` is set.
|
|
- `run` starts a local debug proxy and then runs the command after `--`.
|
|
- Captures are local debugging data; use `openclaw proxy purge` when finished.
|
|
|
|
## Related
|
|
|
|
- [CLI reference](/cli)
|
|
- [Trusted proxy auth](/gateway/trusted-proxy-auth)
|