openclaw agents

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

مرتبط:

• مسیریابی چندعاملی
• فضای کاری عامل
• پیکربندی Skills: پیکربندی قابلیت مشاهدهٔ 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.list[].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، اتصال اجباری حساب یا تعداد حساب‌های پیکربندی‌شدهٔ کانال تعیین می‌کند.

اگر برای bind یا unbind گزینهٔ --agent را حذف کنید، 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.list[].identity می‌نویسد: name، theme، emoji، avatar (مسیر نسبی به فضای کاری، نشانی اینترنتی http(s) یا URI داده).

• --agent یا --workspace عامل هدف را انتخاب می‌کند. اگر --workspace با بیش از یک عامل مطابقت داشته باشد، فرمان با خطا مواجه می‌شود و از شما می‌خواهد --agent را ارائه دهید.
• فایل‌های تصویر آواتار محلی با مسیر نسبی به فضای کاری به ۲ مگابایت محدود هستند. نشانی‌های 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
• مسیریابی چندعاملی
• فضای کاری عامل