openclaw logs

لاگ‌های فایل Gateway را از طریق RPC دنبال کنید (در حالت راه‌دور کار می‌کند).

مرتبط:

• نمای کلی لاگ‌گیری: لاگ‌گیری
• CLI Gateway: gateway

گزینه‌ها

• --limit <n>: حداکثر تعداد خطوط لاگ برای بازگرداندن (پیش‌فرض 200)
• --max-bytes <n>: حداکثر بایت‌هایی که از فایل لاگ خوانده می‌شود (پیش‌فرض 250000)
• --follow: دنبال کردن جریان لاگ
• --interval <ms>: فاصله نظرسنجی هنگام دنبال کردن (پیش‌فرض 1000)
• --json: انتشار رویدادهای JSON جداشده با خط
• --plain: خروجی متن ساده بدون قالب‌بندی سبک‌دار
• --no-color: غیرفعال کردن رنگ‌های ANSI
• --local-time: نمایش زمان‌ها در منطقه زمانی محلی شما (پیش‌فرض)
• --utc: نمایش زمان‌ها در UTC

گزینه‌های مشترک RPC Gateway

openclaw logs همچنین پرچم‌های استاندارد کلاینت Gateway را می‌پذیرد:

• --url <url>: نشانی WebSocket Gateway
• --token <token>: توکن Gateway
• --timeout <ms>: مهلت زمانی بر حسب میلی‌ثانیه (پیش‌فرض 30000)
• --expect-final: وقتی فراخوانی Gateway با پشتیبانی عامل انجام می‌شود، منتظر پاسخ نهایی بمانید

وقتی --url را می‌دهید، CLI پیکربندی یا اعتبارنامه‌های محیط را به‌طور خودکار اعمال نمی‌کند. اگر Gateway هدف به احراز هویت نیاز دارد، --token را صریحاً وارد کنید.

نمونه‌ها

openclaw logsopenclaw logs --followopenclaw logs --follow --interval 2000openclaw logs --limit 500 --max-bytes 500000openclaw logs --jsonopenclaw logs --plainopenclaw logs --no-coloropenclaw logs --limit 500openclaw logs --local-timeopenclaw logs --utcopenclaw logs --follow --local-timeopenclaw logs --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"

نکته‌ها

• زمان‌ها به‌طور پیش‌فرض در منطقه زمانی محلی شما نمایش داده می‌شوند. برای خروجی UTC از --utc استفاده کنید.
• اگر Gateway ضمنی local loopback درخواست جفت‌سازی کند، هنگام اتصال بسته شود، یا پیش از پاسخ دادن logs.tail مهلت زمانی‌اش تمام شود، openclaw logs به‌طور خودکار به لاگ فایل Gateway پیکربندی‌شده بازمی‌گردد. اهداف صریح --url از این بازگشت استفاده نمی‌کنند.
• openclaw logs --follow پس از شکست‌های ضمنی RPC Gateway محلی، بازگشت‌های فایل پیکربندی‌شده را دنبال نمی‌کند. در Linux، هر زمان در دسترس باشد از ژورنال Gateway فعال user-systemd بر اساس PID استفاده می‌کند و منبع لاگ انتخاب‌شده را چاپ می‌کند؛ در غیر این صورت به‌جای دنبال کردن یک فایل کنار‌به‌کنار که ممکن است کهنه باشد، تلاش دوباره برای Gateway زنده را ادامه می‌دهد.
• هنگام استفاده از --follow، قطع‌های گذرای Gateway (بسته شدن WebSocket، پایان مهلت زمانی، قطع اتصال) باعث اتصال مجدد خودکار با عقب‌نشینی نمایی می‌شوند (تا 8 تلاش دوباره، با سقف 30 ثانیه بین تلاش‌ها). در هر تلاش دوباره، یک هشدار در stderr چاپ می‌شود و پس از موفق شدن یک نظرسنجی، یک اعلان [logs] gateway reconnected چاپ می‌شود. در حالت --json، هم هشدار تلاش دوباره و هم گذار اتصال مجدد به‌صورت رکوردهای {"type":"notice"} در stderr منتشر می‌شوند. خطاهای غیرقابل‌بازیابی (شکست احراز هویت، پیکربندی نادرست) همچنان بلافاصله خارج می‌شوند.
• در حالت --follow --json، گذارهای منبع لاگ به‌صورت رکوردهای {"type":"meta"} منتشر می‌شوند. مصرف‌کنندگان باید نشانگرها را برای هر sourceKind جداگانه دنبال کنند: یک جریان می‌تواند از خروجی فایل Gateway (sourceKind: "file") به بازگشت ژورنال محلی (sourceKind: "journal"،‏ localFallback: true، همراه با service.pid/service.unit) و پس از بازیابی دوباره به خروجی فایل Gateway منتقل شود. یک منبع یا نشانگر پایدار برای کل نشست دنبال‌کردن فرض نکنید، و وقتی بازیابی نشانگر فایل Gateway را بازپخش می‌کند، خطوط هم‌پوشان را تحمل کنید.

مرتبط

• مرجع CLI
• لاگ‌گیری Gateway