Overview
نمای کلی
از این صفحه برای انتخاب سطح مناسب قابلیتها استفاده کنید. ابزارها کنشهای قابل فراخوانی هستند، Skills به عاملها شیوهٔ کار را آموزش میدهند و افزونهها قابلیتهای زمان اجرا مانند ابزارها، ارائهدهندگان، کانالها، هوکها و Skills بستهبندیشده را اضافه میکنند.
این صفحه نمایی کلی و راهنمای مسیریابی است. برای جزئیات کامل خطمشی ابزارها، مقادیر پیشفرض، عضویت در گروهها، محدودیتهای ارائهدهندگان و فیلدهای پیکربندی، به ابزارها و ارائهدهندگان سفارشی مراجعه کنید.
از اینجا شروع کنید
برای بیشتر عاملها، ابتدا از دستههای ابزار داخلی استفاده کنید و فقط زمانی خطمشی را تنظیم کنید که عامل باید ابزارهای کمتری ببیند یا به دسترسی صریح به میزبان نیاز دارد.
| اگر میخواهید... | ابتدا از این استفاده کنید | سپس این را بخوانید |
|---|---|---|
| عامل با قابلیتهای موجود عمل کند | ابزارهای داخلی | دستههای ابزار |
| موارد قابل فراخوانی توسط عامل را کنترل کنید | خطمشی ابزار | ابزارها و ارائهدهندگان سفارشی |
| یک گردشکار را به عامل آموزش دهید | Skills | Skills، ایجاد Skills و کارگاه Skill |
| یک یکپارچهسازی یا سطح زمان اجرای جدید اضافه کنید | افزونهها | افزونهها و ساخت افزونهها |
| کار را بعداً یا در پسزمینه اجرا کنید | خودکارسازی | نمای کلی خودکارسازی |
| چند عامل یا چارچوب اجرایی را هماهنگ کنید | زیرعاملها | عاملهای ACP و ارسال عامل |
| در فهرست بزرگ ابزارهای OpenClaw جستوجو کنید | جستوجوی ابزار | جستوجوی ابزار |
انتخاب ابزارها، Skills یا افزونهها
زمانی از ابزار استفاده کنید که عامل باید عملی انجام دهد
ابزار تابعی نوعدار است که عامل میتواند آن را فراخوانی کند؛ مانند exec، browser،
web_search، message یا image_generate. زمانی از ابزارها استفاده کنید که عامل
باید دادهای را بخواند، فایلها را تغییر دهد، پیام بفرستد، ارائهدهندهای را فراخوانی کند یا
سامانهٔ دیگری را به کار بگیرد. ابزارهای قابل مشاهده بهصورت تعریفهای ساختیافتهٔ
تابع برای مدل ارسال میشوند.
مدل فقط ابزارهایی را میبیند که پس از اعمال نمایهٔ فعال، خطمشی مجاز/ممنوع، محدودیتهای ارائهدهنده، وضعیت محیط ایزوله، مجوزهای کانال و دسترسپذیری افزونه باقی میمانند.
زمانی از Skill استفاده کنید که عامل به دستورالعمل نیاز دارد
Skill یک بستهٔ دستورالعمل SKILL.md است که در اعلان عامل بارگذاری میشود. زمانی از
Skill استفاده کنید که عامل ابزارهای موردنیازش را در اختیار دارد، اما به یک
گردشکار تکرارپذیر، معیارنامهٔ بازبینی، توالی فرمانها یا محدودیت
عملیاتی نیاز دارد.
Skills میتوانند در فضای کاری، پوشهٔ مشترک Skills، ریشهٔ مدیریتشدهٔ Skills در OpenClaw یا بستهٔ افزونه قرار داشته باشند.
زمانی از افزونه استفاده کنید که OpenClaw به قابلیت جدیدی نیاز دارد
یک افزونه میتواند ابزارها، Skills، کانالها، ارائهدهندگان مدل، گفتار، صدای بلادرنگ، تولید رسانه، جستوجوی وب، دریافت محتوای وب، هوکها و دیگر قابلیتهای زمان اجرا را اضافه کند. زمانی از افزونه استفاده کنید که قابلیت موردنظر دارای کد، اطلاعات احراز هویت، هوکهای چرخهٔ عمر، فرادادهٔ مانیفست یا بستهبندی قابل نصب است. افزونههای موجود را میتوان از ClawHub، npm، git، پوشههای محلی یا بایگانیها نصب کرد.
دستههای ابزار داخلی
این جدول ابزارهای شاخص را فهرست میکند تا بتوانید این سطح را تشخیص دهید. این جدول مرجع کامل خطمشی نیست. برای گروههای دقیق، مقادیر پیشفرض و معنای مجاز/ممنوع، به ابزارها و ارائهدهندگان سفارشی مراجعه کنید.
| دسته | زمانی استفاده کنید که عامل باید... | ابزارهای شاخص | مطالعهٔ بعدی |
|---|---|---|---|
| زمان اجرا | فرمانها را اجرا کند، فرایندها را مدیریت کند یا از تحلیل Python مبتنی بر ارائهدهنده استفاده کند | exec، process، code_execution |
اجرای فرمان، اجرای کد |
| فایلها | فایلهای فضای کاری را بخواند و تغییر دهد | read، write، edit، apply_patch |
اعمال وصله |
| وب | وب یا پستهای X را جستوجو کند یا محتوای خوانای صفحه را دریافت کند | web_search، x_search، web_fetch |
ابزارهای وب، دریافت محتوای وب |
| مرورگر | یک نشست مرورگر را به کار بگیرد | browser |
مرورگر |
| پیامرسانی و کانالها | پاسخ یا کنشهای کانال را ارسال کند | message |
ارسال عامل |
| نشستها و عاملها | نشستها را بررسی کند، کار را واگذار کند، اجرای دیگری را هدایت کند یا وضعیت را گزارش دهد | sessions_*، subagents، agents_list، session_status، get_goal، create_goal، update_goal |
هدف، زیرعاملها، ابزار نشست |
| خودکارسازی | کار را زمانبندی کند یا به رویدادهای پسزمینه پاسخ دهد | cron، heartbeat_respond |
خودکارسازی |
| Gateway و Nodeها | وضعیت Gateway یا دستگاههای هدف جفتشده را بررسی کند | gateway، nodes |
پیکربندی Gateway، Nodeها |
| رسانه | رسانه را تحلیل یا تولید کند یا آن را به گفتار تبدیل کند | image، image_generate، music_generate، video_generate، tts |
نمای کلی رسانه |
| فهرستهای بزرگ OpenClaw | بدون ارسال همهٔ طرحوارهها به مدل، ابزارهای واجد شرایط بسیاری را جستوجو و فراخوانی کند | tool_search_code، tool_search، tool_describe |
جستوجوی ابزار |
ابزارهای ارائهشده توسط افزونهها
افزونهها میتوانند ابزارهای بیشتری ثبت کنند. نویسندگان افزونه ابزارها را از طریق
api.registerTool(...) و contracts.tools در مانیفست متصل میکنند؛ برای جزئیات
قراردادها به SDK افزونه و
مانیفست افزونه مراجعه کنید.
ابزارهای رایج ارائهشده توسط افزونهها شامل این موارد هستند:
- تفاوتها برای نمایش تفاوتهای فایل و markdown
- نمایش ویجت برای SVG و HTML درونخطی و مستقل در گفتوگوی وب
- وظیفهٔ LLM برای مراحل گردشکاری که فقط از JSON استفاده میکنند
- Lobster برای گردشکارهای نوعدار با تأییدهای قابل ازسرگیری
- Tokenjuice برای فشردهسازی خروجی شلوغ ابزارهای
execوbash - جستوجوی ابزار برای کشف و فراخوانی فهرستهای بزرگ ابزار بدون قراردادن همهٔ طرحوارهها در اعلان
- Canvas برای کنترل Canvas در Node و رندر A2UI
پیکربندی دسترسی و تأییدها
خطمشی ابزار پیش از فراخوانی مدل اعمال میشود. اگر خطمشی ابزاری را حذف کند، مدل طرحوارهٔ آن ابزار را برای نوبت جاری دریافت نمیکند. یک اجرا ممکن است بهدلیل پیکربندی سراسری، پیکربندی مختص عامل، خطمشی کانال، محدودیتهای ارائهدهنده، قواعد محیط ایزوله، خطمشی کانال/زمان اجرا یا دسترسپذیری افزونه، ابزارهایی را از دست بدهد.
- ابزارها و ارائهدهندگان سفارشی نمایههای ابزار، فهرستهای مجاز/ممنوع، محدودیتهای مختص ارائهدهنده، تشخیص حلقه و تنظیمات ابزارهای مبتنی بر ارائهدهنده را مستند میکند.
- تأییدهای اجرای فرمان خطمشی تأیید فرمانهای میزبان را مستند میکند.
- اجرای فرمان با دسترسی ارتقایافته اجرای کنترلشده در خارج از محیط ایزوله را مستند میکند.
- محیط ایزوله در برابر خطمشی ابزار در برابر دسترسی ارتقایافته توضیح میدهد کدام لایه دسترسی به فایلها و فرایندها را کنترل میکند.
- محیط ایزوله و محدودیتهای ابزار برای هر عامل محدودیتهای مختص عامل در اجراهای واگذارشده را مستند میکند.
گسترش قابلیتها
مسیر گسترش را بر اساس کاری انتخاب کنید که OpenClaw باید انجام دهد:
- با افزونهها یک افزونهٔ موجود را نصب یا مدیریت کنید.
- با ساخت افزونهها یک یکپارچهسازی، ارائهدهنده، کانال، ابزار یا هوک جدید بسازید.
- با Skills و ایجاد Skills دستورالعملهای قابل استفادهٔ مجدد عامل را اضافه یا تنظیم کنید.
- زمانی که به قراردادهای پیادهسازی نیاز دارید، از SDK افزونه و مانیفست افزونه استفاده کنید.
عیبیابی ابزارهای مفقود
اگر مدل نمیتواند ابزاری را ببیند یا فراخوانی کند، ابتدا خطمشی مؤثر برای نوبت جاری را بررسی کنید:
- نمایهٔ فعال،
tools.allowوtools.denyرا در ابزارها و ارائهدهندگان سفارشی بررسی کنید. - محدودیتهای مختص ارائهدهنده را در ابزارها و ارائهدهندگان سفارشی بررسی کنید و مطمئن شوید ارائهدهندهٔ مدل انتخابشده از ساختار ابزار پشتیبانی میکند.
- مجوزهای کانال، وضعیت محیط ایزوله و دسترسی ارتقایافته را با استفاده از محیط ایزوله در برابر خطمشی ابزار در برابر دسترسی ارتقایافته و اجرای فرمان با دسترسی ارتقایافته بررسی کنید.
- در افزونهها بررسی کنید که افزونهٔ مالک نصب و فعال شده باشد.
- برای اجراهای واگذارشده، محدودیتهای مختص عامل را در محیط ایزوله و محدودیتهای ابزار برای هر عامل بررسی کنید.
- برای فهرستهای بزرگ OpenClaw، مشخص کنید که اجرا از ارائهٔ مستقیم ابزار استفاده میکند یا جستوجوی ابزار.
مطالب مرتبط
- خودکارسازی برای cron، وظایف، heartbeat، تعهدات، هوکها، دستورهای دائمی و Task Flow
- عاملها برای مدل عامل، نشستها، حافظه و هماهنگی چندعاملی
- ابزارها و ارائهدهندگان سفارشی برای مرجع معیار خطمشی ابزار
- Pluginها برای نصب و مدیریت Plugin
- Plugin SDK برای مرجع نویسندگان Plugin
- Skills برای ترتیب بارگذاری، کنترل دسترسی و پیکربندی Skills
- کارگاه Skills برای ایجاد Skills تولیدشده و بازبینیشده
- جستوجوی ابزار برای کشف فشردهٔ فهرست ابزارهای OpenClaw
