CLI commands

Nodeها

Edit source

`openclaw nodes`

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

مرتبط:

نمای کلی گره‌ها: گره‌ها
دوربین: گره‌های دوربین
تصاویر: گره‌های تصویر

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

--url، --token، --timeout، --json

دستورهای رایج

bash

openclaw nodes listopenclaw nodes list --connectedopenclaw nodes list --last-connected 24hopenclaw nodes pendingopenclaw 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 statusopenclaw nodes status --connectedopenclaw nodes status --last-connected 24h

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

نکته تأیید:

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

فراخوانی

bash

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

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

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

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

مرتبط

Was this useful?