---
read_when:
    - باید مسیریابی پروکسی تحت مدیریت اپراتور را پیش از استقرار اعتبارسنجی کنید
    - برای اشکال‌زدایی، باید ترافیک انتقال OpenClaw را به‌صورت محلی ضبط کنید
    - می‌خواهید نشست‌های پروکسی اشکال‌زدایی، blobها، یا پیش‌تنظیم‌های پرس‌وجوی داخلی را بررسی کنید
summary: مرجع CLI برای `openclaw proxy`، شامل اعتبارسنجی پراکسیِ مدیریت‌شده توسط اپراتور و بازرس ضبط پراکسی اشکال‌زدایی محلی
title: پروکسی
x-i18n:
    generated_at: "2026-05-04T11:59:14Z"
    model: gpt-5.5
    provider: openai
    source_hash: 092c4e946dcab5e78e37d6fc77bb067b7a649368f8571fa127e462a85fa14ce5
    source_path: cli/proxy.md
    workflow: 16
---

# `openclaw proxy`

مسیریابی پراکسی مدیریت‌شده توسط اپراتور را اعتبارسنجی کنید، یا پراکسی اشکال‌زدایی صریح محلی را اجرا کنید
و ترافیک ضبط‌شده را بررسی کنید.

از `validate` برای پیش‌بررسی یک پراکسی فوروارد مدیریت‌شده توسط اپراتور پیش از فعال‌سازی
مسیریابی پراکسی OpenClaw استفاده کنید. دستورهای دیگر ابزارهای اشکال‌زدایی برای
بررسی در سطح انتقال هستند: می‌توانند یک پراکسی محلی را راه‌اندازی کنند، یک دستور فرزند را
با ضبط فعال اجرا کنند، نشست‌های ضبط را فهرست کنند، الگوهای رایج ترافیک را پرس‌وجو کنند، blobهای
ضبط‌شده را بخوانند، و داده‌های ضبط محلی را پاک‌سازی کنند.

## دستورات

```bash
openclaw proxy start [--host <host>] [--port <port>]
openclaw proxy run [--host <host>] [--port <port>] -- <cmd...>
openclaw proxy validate [--json] [--proxy-url <url>] [--allowed-url <url>] [--denied-url <url>] [--apns-reachable] [--apns-authority <url>] [--timeout-ms <ms>]
openclaw proxy coverage
openclaw proxy sessions [--limit <count>]
openclaw proxy query --preset <name> [--session <id>]
openclaw proxy blob --id <blobId>
openclaw proxy purge
```

## اعتبارسنجی

`openclaw proxy validate` نشانی مؤثر پراکسی مدیریت‌شده توسط اپراتور را از
`--proxy-url`، پیکربندی، یا `OPENCLAW_PROXY_URL` بررسی می‌کند. وقتی
هیچ پراکسی‌ای فعال و پیکربندی نشده باشد، یک مشکل پیکربندی گزارش می‌کند؛ برای یک پیش‌بررسی موردی
پیش از تغییر پیکربندی، از `--proxy-url` استفاده کنید. به‌طور پیش‌فرض تأیید می‌کند که یک مقصد عمومی
از طریق پراکسی موفق می‌شود و پراکسی نمی‌تواند به یک نشانگر بازگشتی موقت برسد.
مقصدهای منع‌شده سفارشی fail-closed هستند: پاسخ‌های HTTP و خطاهای مبهم
انتقال هر دو شکست محسوب می‌شوند، مگر اینکه بتوانید یک نشانه منع مخصوص استقرار را
جداگانه تأیید کنید. `--apns-reachable` را اضافه کنید تا همچنین یک تونل HTTP/2 CONNECT
برای APNs را از طریق پراکسی باز کند و تأیید کند APNs محیط سندباکس پاسخ می‌دهد؛ این کاوش از یک
توکن ارائه‌دهنده عمداً نامعتبر استفاده می‌کند، بنابراین پاسخ APNs با `403 InvalidProviderToken`
نشانه موفق دسترس‌پذیری است.

گزینه‌ها:

- `--json`: JSON قابل‌خواندن برای ماشین چاپ می‌کند.
- `--proxy-url <url>`: این نشانی پراکسی را به‌جای پیکربندی یا محیط اعتبارسنجی می‌کند.
- `--allowed-url <url>`: مقصدی را اضافه می‌کند که انتظار می‌رود از طریق پراکسی موفق شود. برای بررسی چند مقصد تکرار کنید.
- `--denied-url <url>`: مقصدی را اضافه می‌کند که انتظار می‌رود توسط پراکسی مسدود شود. برای بررسی چند مقصد تکرار کنید.
- `--apns-reachable`: همچنین تأیید می‌کند HTTP/2 مربوط به APNs محیط سندباکس از طریق پراکسی در دسترس است.
- `--apns-authority <url>`: مرجع APNs برای کاوش با `--apns-reachable` (`https://api.sandbox.push.apple.com` به‌طور پیش‌فرض؛ محیط تولید `https://api.push.apple.com` است).
- `--timeout-ms <ms>`: مهلت زمانی هر درخواست بر حسب میلی‌ثانیه.

برای راهنمایی استقرار و معناشناسی منع، [پراکسی شبکه](/fa/security/network-proxy) را ببینید.

## پیش‌تنظیم‌های پرس‌وجو

`openclaw proxy query --preset <name>` این موارد را می‌پذیرد:

- `double-sends`
- `retry-storms`
- `cache-busting`
- `ws-duplicate-frames`
- `missing-ack`
- `error-bursts`

## نکات

- `start` به‌طور پیش‌فرض از `127.0.0.1` استفاده می‌کند، مگر اینکه `--host` تنظیم شده باشد.
- `run` یک پراکسی اشکال‌زدایی محلی را راه‌اندازی می‌کند و سپس دستور پس از `--` را اجرا می‌کند.
- فوروارد مستقیم بالادستی در پراکسی اشکال‌زدایی، سوکت‌های بالادستی را برای عیب‌یابی باز می‌کند. وقتی حالت پراکسی مدیریت‌شده OpenClaw فعال است، فوروارد مستقیم برای درخواست‌های پراکسی و تونل‌های CONNECT به‌طور پیش‌فرض غیرفعال است؛ `OPENCLAW_DEBUG_PROXY_ALLOW_DIRECT_CONNECT_WITH_MANAGED_PROXY=1` را فقط برای عیب‌یابی محلی تأییدشده تنظیم کنید.
- `validate` وقتی پیکربندی پراکسی یا بررسی‌های مقصد شکست بخورند، با کد 1 خارج می‌شود.
- ضبط‌ها داده‌های اشکال‌زدایی محلی هستند؛ پس از پایان کار از `openclaw proxy purge` استفاده کنید.

## مرتبط

- [مرجع CLI](/fa/cli)
- [پراکسی شبکه](/fa/security/network-proxy)
- [احراز هویت پراکسی مورد اعتماد](/fa/gateway/trusted-proxy-auth)