نمای کلی

از این صفحه برای انتخاب سطح مناسب قابلیت‌ها استفاده کنید. ابزارها کنش‌های قابل فراخوانی هستند، Skills به عامل‌ها می‌آموزند چگونه کار کنند، و Pluginها قابلیت‌های زمان اجرا مانند ابزارها، ارائه‌دهندگان، کانال‌ها، هوک‌ها، و Skills بسته‌بندی‌شده اضافه می‌کنند.

این صفحه یک نمای کلی و صفحه مسیریابی است. برای سیاست کامل ابزارها، پیش‌فرض‌ها، عضویت گروه‌ها، محدودیت‌های ارائه‌دهنده، و فیلدهای پیکربندی، از ابزارها و ارائه‌دهندگان سفارشی استفاده کنید.

از اینجا شروع کنید

برای بیشتر عامل‌ها، با دسته‌های ابزار داخلی شروع کنید، سپس فقط وقتی سیاست را تنظیم کنید که عامل باید ابزارهای کمتری ببیند یا به دسترسی صریح میزبان نیاز دارد.

اگر لازم دارید...	ابتدا از این استفاده کنید	سپس بخوانید
اجازه دهید یک عامل با قابلیت‌های موجود عمل کند	ابزارهای داخلی	دسته‌های ابزار
کنترل کنید یک عامل چه چیزی را می‌تواند فراخوانی کند	سیاست ابزار	ابزارها و ارائه‌دهندگان سفارشی
یک گردش‌کار را به عامل آموزش دهید	Skills	Skills و ایجاد Skills
یک ادغام جدید یا سطح زمان اجرا اضافه کنید	Pluginها	Pluginها و ساخت Pluginها
کار را بعدا یا در پس‌زمینه اجرا کنید	اتوماسیون	نمای کلی اتوماسیون
چند عامل یا هارنس را هماهنگ کنید	زیرعامل‌ها	عامل‌های ACP و ارسال عامل
یک کاتالوگ بزرگ ابزار PI را جستجو کنید	جستجوی ابزار	جستجوی ابزار

ابزارها، Skills، یا Pluginها را انتخاب کنید

دسته‌های ابزار داخلی

این جدول ابزارهای نماینده را فهرست می‌کند تا بتوانید سطح را تشخیص دهید. این مرجع کامل سیاست نیست. برای گروه‌های دقیق، پیش‌فرض‌ها، و معناشناسی مجاز/ممنوع، از ابزارها و ارائه‌دهندگان سفارشی استفاده کنید.

دسته	وقتی استفاده کنید که عامل لازم دارد...	ابزارهای نماینده	بعدی را بخوانید
زمان اجرا	فرمان‌ها را اجرا کند، فرایندها را مدیریت کند، یا از تحلیل Python پشتیبانی‌شده توسط ارائه‌دهنده استفاده کند	exec، process، code_execution	Exec، اجرای کد
فایل‌ها	فایل‌های فضای کاری را بخواند و تغییر دهد	read، write، edit، apply_patch	اعمال patch
وب	وب را جستجو کند، پست‌های X را جستجو کند، یا محتوای خوانای صفحه را واکشی کند	web_search، x_search، web_fetch	ابزارهای وب، واکشی وب
مرورگر	یک نشست مرورگر را به کار بگیرد	browser	مرورگر
پیام‌رسانی و کانال‌ها	پاسخ‌ها یا کنش‌های کانال را ارسال کند	message	ارسال عامل
نشست‌ها و عامل‌ها	نشست‌ها را بررسی کند، کار را واگذار کند، اجرای دیگری را هدایت کند، یا وضعیت را گزارش کند	sessions_*، subagents، agents_list، session_status	زیرعامل‌ها، ابزار نشست
اتوماسیون	کار را زمان‌بندی کند یا به رویدادهای پس‌زمینه پاسخ دهد	cron، heartbeat_respond	اتوماسیون
Gateway و گره‌ها	وضعیت Gateway یا دستگاه‌های هدف جفت‌شده را بررسی کند	gateway، nodes	پیکربندی Gateway، گره‌ها
رسانه	رسانه را تحلیل کند، تولید کند، یا بیان کند	image، image_generate، music_generate، video_generate، tts	نمای کلی رسانه
کاتالوگ‌های بزرگ PI	ابزارهای واجد شرایط زیادی را بدون ارسال هر schema به مدل جستجو و فراخوانی کند	tool_search_code، tool_search، tool_describe	جستجوی ابزار

ابزارهای ارائه‌شده توسط Plugin

Pluginها می‌توانند ابزارهای اضافی ثبت کنند. نویسندگان Plugin ابزارها را از طریق api.registerTool(...) و contracts.tools در manifest سیم‌کشی می‌کنند؛ برای جزئیات قرارداد از SDK Plugin و manifest Plugin استفاده کنید.

ابزارهای رایج ارائه‌شده توسط Plugin شامل این‌ها هستند:

• Diffها برای رندر کردن diffهای فایل و markdown
• وظیفه LLM برای گام‌های گردش‌کار فقط JSON
• Lobster برای گردش‌کارهای تایپ‌شده با تاییدهای قابل ازسرگیری
• Tokenjuice برای فشرده‌سازی خروجی پرنویز ابزارهای exec و bash
• جستجوی ابزار برای کشف و فراخوانی کاتالوگ‌های بزرگ ابزار بدون قرار دادن هر schema در پرامپت
• Canvas برای کنترل Canvas گره و رندر A2UI

پیکربندی دسترسی و تاییدها

سیاست ابزار پیش از فراخوانی مدل اعمال می‌شود. اگر سیاست ابزاری را حذف کند، مدل schema آن ابزار را برای آن نوبت دریافت نمی‌کند. یک اجرا ممکن است ابزارها را به‌دلیل پیکربندی سراسری، پیکربندی هر عامل، سیاست کانال، محدودیت‌های ارائه‌دهنده، قواعد سندباکس، دروازه‌گذاری فقط مالک، یا دسترس‌پذیری Plugin از دست بدهد.

• ابزارها و ارائه‌دهندگان سفارشی پروفایل‌های ابزار، فهرست‌های مجاز/ممنوع، محدودیت‌های مختص ارائه‌دهنده، تشخیص حلقه، و تنظیمات ابزار پشتیبانی‌شده توسط ارائه‌دهنده را مستند می‌کند.
• تاییدهای Exec سیاست تایید فرمان میزبان را مستند می‌کند.
• exec ارتقایافته اجرای کنترل‌شده بیرون از سندباکس را مستند می‌کند.
• سندباکس در برابر سیاست ابزار در برابر ارتقایافته توضیح می‌دهد کدام لایه دسترسی فایل و فرایند را کنترل می‌کند.
• سندباکس و محدودیت‌های ابزار برای هر عامل محدودیت‌های مختص عامل برای اجراهای واگذارشده را مستند می‌کند.

گسترش قابلیت‌ها

مسیر گسترش را بر اساس کاری که لازم دارید OpenClaw انجام دهد انتخاب کنید:

• یک Plugin موجود را با Pluginها نصب یا مدیریت کنید.
• یک ادغام، ارائه‌دهنده، کانال، ابزار، یا هوک جدید را با ساخت Pluginها بسازید.
• دستورالعمل‌های عامل قابل استفاده مجدد را با Skills و ایجاد Skills اضافه یا تنظیم کنید.
• وقتی گردش‌کار باید در یک بسته skill توزیع‌شده با Plugin قرار بگیرد، مواد گردش‌کار قابل استفاده مجدد را با کارگاه skill بسته‌بندی کنید.
• وقتی به قراردادهای پیاده‌سازی نیاز دارید، از SDK Plugin و manifest Plugin استفاده کنید.

عیب‌یابی ابزارهای گمشده

اگر مدل نمی‌تواند ابزاری را ببیند یا فراخوانی کند، با سیاست موثر برای نوبت فعلی شروع کنید:

1. پروفایل فعال، tools.allow، و tools.deny را در ابزارها و ارائه‌دهندگان سفارشی بررسی کنید.
2. محدودیت‌های مختص ارائه‌دهنده را در ابزارها و ارائه‌دهندگان سفارشی بررسی کنید و تایید کنید ارائه‌دهنده مدل انتخاب‌شده از شکل ابزار پشتیبانی می‌کند.
3. مجوزهای کانال، وضعیت سندباکس، و دسترسی ارتقایافته را با سندباکس در برابر سیاست ابزار در برابر ارتقایافته و exec ارتقایافته بررسی کنید.
4. بررسی کنید آیا Plugin مالک در Pluginها نصب و فعال شده است.
5. برای اجراهای واگذارشده، محدودیت‌های هر عامل را در سندباکس و محدودیت‌های ابزار برای هر عامل بررسی کنید.
6. برای کاتالوگ‌های بزرگ PI، تایید کنید آیا اجرا از ارائه مستقیم ابزار یا جستجوی ابزار استفاده می‌کند.

مرتبط

• اتوماسیون برای cron، وظایف، heartbeat، تعهدات، هوک‌ها، دستورهای پایدار، و جریان وظیفه
• عامل‌ها برای مدل عامل، نشست‌ها، حافظه، و هماهنگی چندعاملی
• ابزارها و ارائه‌دهندگان سفارشی برای مرجع canonical سیاست ابزار
• Pluginها برای نصب و مدیریت Plugin
• SDK Plugin برای مرجع نویسنده Plugin
• Skills برای ترتیب بارگذاری skill، دروازه‌گذاری، و پیکربندی
• جستجوی ابزار برای کشف فشرده کاتالوگ ابزار PI