openclaw agents

عامل‌های ایزوله (فضاهای کاری + احراز هویت + مسیریابی) را مدیریت کنید. اجرای openclaw agents بدون زیر‌دستور، معادل openclaw agents list است.

مرتبط:

• مسیریابی چندعاملی
• فضای کاری عامل
• پیکربندی Skills: پیکربندی نمایان‌بودن مهارت‌ها.

مثال‌ها

openclaw agents listopenclaw agents list --bindingsopenclaw agents add work --workspace ~/.openclaw/workspace-workopenclaw agents add work --workspace ~/.openclaw/workspace-work --bind telegram:*openclaw agents add ops --workspace ~/.openclaw/workspace-ops --bind telegram:ops --non-interactiveopenclaw agents bindingsopenclaw agents bind --agent work --bind telegram:opsopenclaw agents unbind --agent work --bind telegram:opsopenclaw agents set-identity --workspace ~/.openclaw/workspace --from-identityopenclaw agents set-identity --agent main --avatar avatars/openclaw.pngopenclaw agents delete work

سطح دستورات

agents list

گزینه‌ها: --json، --bindings (قواعد کامل مسیریابی را شامل می‌شود، نه فقط تعداد/خلاصه‌های هر عامل).

agents add [name]

گزینه‌ها: --workspace <dir>، --model <id>، --agent-dir <dir>، --bind <channel[:accountId]> (قابل تکرار)، --non-interactive، --json.

• ارائه هر پرچم صریح افزودن، دستور را به مسیر غیرتعاملی تغییر می‌دهد.
• حالت غیرتعاملی هم به نام عامل و هم به --workspace نیاز دارد.
• main رزروشده است و نمی‌توان از آن به‌عنوان شناسه عامل جدید استفاده کرد.
• حالت تعاملی، احراز هویت را با کپی‌کردن صرفاً اعتبارنامه‌های ایستای قابل‌انتقال (api_key و پروفایل‌های ایستای token) مقداردهی اولیه می‌کند، مگر اینکه اعتبارنامه‌ای با copyToAgents: false از این کار انصراف دهد؛ پروفایل‌های توکن نوسازی OAuth کپی نمی‌شوند، مگر اینکه ارائه‌دهنده‌ای با copyToAgents: true آن را بپذیرد. بدون کپی، OAuth فقط از طریق وراثت خواندنی از مخزن عامل واقعی main در دسترس می‌ماند. اگر عامل پیش‌فرض پیکربندی‌شده main نیست، برای پروفایل‌های OAuth در عامل جدید جداگانه وارد شوید.

agents bindings

گزینه‌ها: --agent <id>، --json.

agents bind

گزینه‌ها: --agent <id> (پیش‌فرض، عامل پیش‌فرض فعلی است)، --bind <channel[:accountId]> (قابل تکرار)، --json.

agents unbind

گزینه‌ها: --agent <id> (پیش‌فرض، عامل پیش‌فرض فعلی است)، --bind <channel[:accountId]> (قابل تکرار)، --all، --json. یا --all یا یک یا چند مقدار --bind را می‌پذیرد، نه هر دو را.

agents set-identity

گزینه‌ها: --agent <id>، --workspace <dir>، --identity-file <path>، --from-identity، --name <name>، --theme <theme>، --emoji <emoji>، --avatar <value>، --json. بخش تنظیم هویت را در ادامه ببینید.

agents delete <id>

گزینه‌ها: --force، --json.

• main را نمی‌توان حذف کرد.
• بدون --force، تأیید تعاملی الزامی است (در نشست غیر TTY ناموفق می‌شود؛ با --force دوباره اجرا کنید).
• دایرکتوری‌های فضای کاری، وضعیت عامل و رونوشت نشست به سطل زباله منتقل می‌شوند و به‌طور قطعی حذف نمی‌شوند. اگر سطل زباله در دسترس نباشد، حذف پیکربندی عامل همچنان موفق می‌شود و مسیرهایی را که به پاک‌سازی دستی نیاز دارند گزارش می‌کند.
• وقتی Gateway در دسترس باشد، حذف از طریق Gateway مسیریابی می‌شود تا پاک‌سازی پیکربندی و مخزن نشست از همان نویسنده‌ای استفاده کند که ترافیک زمان اجرا استفاده می‌کند. اگر Gateway در دسترس نباشد، CLI به مسیر محلی آفلاین بازمی‌گردد.
• اگر فضای کاری عامل دیگری همان مسیر باشد، داخل این فضای کاری قرار داشته باشد یا این فضای کاری را دربر گیرد، فضای کاری حفظ می‌شود و --json مقادیر workspaceRetained، workspaceRetainedReason و workspaceSharedWith را گزارش می‌کند.

اتصال‌های مسیریابی

از اتصال‌های مسیریابی برای ثابت‌کردن ترافیک ورودی کانال به یک عامل مشخص استفاده کنید.

اگر همچنین می‌خواهید Skills قابل‌مشاهده برای هر عامل متفاوت باشند، agents.defaults.skills و agents.entries.*.skills را در openclaw.json پیکربندی کنید. پیکربندی Skills و مرجع پیکربندی را ببینید.

فهرست‌کردن اتصال‌ها:

openclaw agents bindingsopenclaw agents bindings --agent workopenclaw agents bindings --json

افزودن اتصال‌ها:

openclaw agents bind --agent work --bind telegram:ops --bind discord:guild-a

همچنین می‌توانید هنگام ایجاد عامل، اتصال‌ها را اضافه کنید:

openclaw agents add work --workspace ~/.openclaw/workspace-work --bind telegram:* --bind discord:*

اگر accountId (--bind <channel>) را حذف کنید، OpenClaw آن را از هوک‌های راه‌اندازی Plugin، اتصال اجباری حساب یا تعداد حساب‌های پیکربندی‌شده کانال تعیین می‌کند.

اگر --agent را برای bind یا unbind حذف کنید، OpenClaw عامل پیش‌فرض فعلی را هدف قرار می‌دهد.

قالب --bind

رفتار دامنه اتصال

• یک اتصال ذخیره‌شده بدون accountId فقط با حساب پیش‌فرض کانال مطابقت دارد.
• accountId: "*" حالت جایگزین کل کانال (همه حساب‌ها) است و نسبت به اتصال صریح حساب، اختصاصی‌بودن کمتری دارد.
• اگر همان عامل از قبل اتصال کانال منطبقی بدون accountId داشته باشد و بعداً با یک accountId صریح یا تعیین‌شده اتصال ایجاد کنید، OpenClaw به‌جای افزودن مورد تکراری، همان اتصال موجود را درجا ارتقا می‌دهد.

مثال‌ها:

# تطبیق با همه حساب‌های کانالopenclaw agents bind --agent work --bind telegram:* # تطبیق با یک حساب مشخصopenclaw agents bind --agent work --bind telegram:ops # اتصال اولیه فقط در سطح کانالopenclaw agents bind --agent work --bind telegram # ارتقای بعدی به اتصال در سطح حسابopenclaw agents bind --agent work --bind telegram:alerts

پس از ارتقا، مسیریابی آن اتصال به telegram:alerts محدود می‌شود. اگر مسیریابی حساب پیش‌فرض را نیز می‌خواهید، آن را صریحاً اضافه کنید (برای مثال --bind telegram:default).

حذف اتصال‌ها:

openclaw agents unbind --agent work --bind telegram:opsopenclaw agents unbind --agent work --all

فایل‌های هویت

هر فضای کاری عامل می‌تواند در ریشه فضای کاری شامل یک IDENTITY.md باشد:

• مسیر نمونه: ~/.openclaw/workspace/IDENTITY.md
• set-identity --from-identity از ریشه فضای کاری (یا یک --identity-file صریح) می‌خواند.

مسیرهای آواتار نسبت به ریشه فضای کاری تعیین می‌شوند و حتی از طریق پیوند نمادین نیز نمی‌توانند از آن خارج شوند.

تنظیم هویت

set-identity فیلدهای زیر را در agents.entries.*.identity می‌نویسد: name، theme، emoji، avatar (مسیر نسبی به فضای کاری، نشانی اینترنتی http(s) یا URI داده).

• --agent یا --workspace عامل هدف را انتخاب می‌کند. اگر --workspace با بیش از یک عامل مطابقت داشته باشد، دستور ناموفق می‌شود و از شما می‌خواهد --agent را ارائه کنید.
• فایل‌های تصویر آواتار محلی با مسیر نسبی به فضای کاری به 2 MB محدود هستند. نشانی‌های اینترنتی HTTP(S) و URIهای data: در برابر محدودیت اندازه فایل محلی بررسی نمی‌شوند.
• وقتی هیچ فیلد هویت صریحی ارائه نشود، دستور داده‌های هویت را از IDENTITY.md می‌خواند.

بارگذاری از IDENTITY.md:

openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity

بازنویسی صریح فیلدها:

openclaw agents set-identity --agent main --name "OpenClaw" --emoji "🦞" --avatar avatars/openclaw.png

نمونه پیکربندی:

{  agents: {    list: [      {        id: "main",        identity: {          name: "OpenClaw",          theme: "space lobster",          emoji: "🦞",          avatar: "avatars/openclaw.png",        },      },    ],  },}

مرتبط

• مرجع CLI
• مسیریابی چندعاملی
• فضای کاری عامل