# openclaw nodes

Nodeهای جفت‌شده (دستگاه‌ها) را مدیریت کنید و قابلیت‌های Node را فراخوانی کنید.

مرتبط:

• نمای کلی Nodeها: Nodeها
• دوربین: Nodeهای دوربین
• تصاویر: Nodeهای تصویر

گزینه‌های رایج:

• --url, --token, --timeout, --json

# فرمان‌های رایج

openclaw nodes list
openclaw nodes list --connected
openclaw nodes list --last-connected 24h
openclaw nodes pending
openclaw nodes approve <requestId>
openclaw nodes reject <requestId>
openclaw nodes remove --node <id|name|ip>
openclaw nodes rename --node <id|name|ip> --name <displayName>
openclaw nodes status
openclaw nodes status --connected
openclaw nodes status --last-connected 24h

nodes list جدول‌های در انتظار/جفت‌شده را چاپ می‌کند. ردیف‌های جفت‌شده شامل سن جدیدترین اتصال هستند (Last Connect). از --connected برای نمایش فقط Nodeهایی که در حال حاضر متصل هستند استفاده کنید. از --last-connected <duration> برای فیلتر کردن به Nodeهایی استفاده کنید که در یک بازه زمانی متصل شده‌اند (مثلاً 24h، 7d). از nodes remove --node <id|name|ip> برای حذف رکورد جفت‌سازی Node قدیمی متعلق به Gateway استفاده کنید.

نکته تأیید:

• openclaw nodes pending فقط به دامنه جفت‌سازی نیاز دارد.
• gateway.nodes.pairing.autoApproveCidrs می‌تواند مرحله در انتظار را فقط برای جفت‌سازی دستگاه role: node برای نخستین بار، به‌صورت صریح مورد اعتماد، رد کند. این گزینه به‌صورت پیش‌فرض خاموش است و ارتقاها را تأیید نمی‌کند.
• openclaw nodes approve <requestId> الزامات دامنه اضافی را از درخواست در انتظار به ارث می‌برد:
  • درخواست بدون فرمان: فقط جفت‌سازی
  • فرمان‌های Node غیر exec: جفت‌سازی + نوشتن
  • system.run / system.run.prepare / system.which: جفت‌سازی + مدیر

# فراخوانی

openclaw nodes invoke --node <id|name|ip> --command <command> --params <json>

پرچم‌های فراخوانی:

• --params <json>: رشته شیء JSON (پیش‌فرض {}).
• --invoke-timeout <ms>: مهلت زمانی فراخوانی Node (پیش‌فرض 15000).
• --idempotency-key <key>: کلید idempotency اختیاری.
• system.run و system.run.prepare اینجا مسدود هستند؛ برای اجرای shell از ابزار exec با host=node استفاده کنید.

برای اجرای shell روی یک Node، به‌جای openclaw nodes run از ابزار exec با host=node استفاده کنید. CLI مربوط به nodes اکنون بر قابلیت‌ها متمرکز است: RPC مستقیم از طریق nodes invoke، به‌علاوه جفت‌سازی، دوربین، صفحه‌نمایش، مکان، canvas و اعلان‌ها.

# مرتبط

• مرجع CLI
• Nodeها