openclaw agents

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

مرتبط:

• مسیریابی چندعاملی
• فضای کاری عامل
• پیکربندی 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

پیوندهای مسیریابی

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

اگر برای هر عامل 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، پیوند اجباری حساب، یا تعداد حساب‌های پیکربندی‌شده کانال تعیین می‌کند.

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

قالب --bind

رفتار دامنه پیوند

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

نمونه‌ها:

# match all accounts on the channelopenclaw agents bind --agent work --bind telegram:* # match a specific accountopenclaw agents bind --agent work --bind telegram:ops # initial channel-only bindingopenclaw agents bind --agent work --bind telegram # later upgrade to account-scoped bindingopenclaw 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

unbind یا --all را می‌پذیرد یا یک یا چند مقدار --bind را، نه هر دو را.

سطح دستور

agents

اجرای openclaw agents بدون زیر‌دستور معادل openclaw agents list است.

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 ایستا به‌صورت پیش‌فرض). پروفایل‌های دارای توکن بازآوری 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

agents delete <id>

گزینه‌ها:

• --force
• --json

نکته‌ها:

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

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

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

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

مسیرهای آواتار نسبت به ریشه فضای کاری تعیین می‌شوند.

تنظیم هویت

set-identity فیلدها را در agents.list[].identity می‌نویسد:

• name
• theme
• emoji
• avatar (مسیر نسبی به فضای کاری، URL با http(s)، یا URI داده)

گزینه‌ها:

• --agent <id>
• --workspace <dir>
• --identity-file <path>
• --from-identity
• --name <name>
• --theme <theme>
• --emoji <emoji>
• --avatar <value>
• --json

نکته‌ها:

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