Overview
نمای کلی
از این صفحه برای انتخاب سطح قابلیتهای مناسب استفاده کنید. ابزارها اقدامهای قابل فراخوانی هستند، Skills شیوهٔ کار را به عاملها میآموزند و Pluginها قابلیتهای زمان اجرا مانند ابزارها، ارائهدهندگان، کانالها، هوکها و Skills بستهبندیشده را اضافه میکنند.
این صفحه نمایی کلی و راهنمای مسیریابی است. برای جزئیات کامل خطمشی ابزارها، پیشفرضها، عضویت در گروهها، محدودیتهای ارائهدهندگان و فیلدهای پیکربندی، به ابزارها و ارائهدهندگان سفارشی مراجعه کنید.
از اینجا شروع کنید
برای بیشتر عاملها، ابتدا از دستههای ابزار داخلی شروع کنید و سپس فقط زمانی خطمشی را تنظیم کنید که عامل باید ابزارهای کمتری ببیند یا به دسترسی صریح به میزبان نیاز داشته باشد.
| اگر نیاز دارید... | ابتدا از این استفاده کنید | سپس بخوانید |
|---|---|---|
| به عامل اجازه دهید با قابلیتهای موجود اقدام کند | ابزارهای داخلی | دستههای ابزار |
| مواردی را که عامل میتواند فراخوانی کند کنترل کنید | خطمشی ابزار | ابزارها و ارائهدهندگان سفارشی |
| یک گردشکار را به عامل بیاموزید | Skills | Skills، ایجاد Skills، کارگاه Skill و خودآموزی |
| یک یکپارچهسازی یا سطح زمان اجرای جدید اضافه کنید | Pluginها | Pluginها و ساخت Pluginها |
| کار را بعداً یا در پسزمینه اجرا کنید | خودکارسازی | نمای کلی خودکارسازی |
| چند عامل یا هارنس را هماهنگ کنید | زیرعاملها | عاملهای ACP و ارسال عامل |
| عاملهای همزمان را از طریق کد هماهنگسازی کنید | ازدحام | حالت کد و زیرعاملها |
| در کاتالوگ بزرگ ابزارهای OpenClaw جستوجو کنید | جستوجوی ابزار | جستوجوی ابزار |
| چند ابزار را در یک برنامهٔ فشرده ترکیب کنید | حالت کد | حالت کد |
ابزارها، Skills یا Pluginها را انتخاب کنید
وقتی عامل باید اقدام کند، از ابزار استفاده کنید
ابزار تابعی نوعدار است که عامل میتواند آن را فراخوانی کند، مانند exec، browser،
web_search، message یا image_generate. وقتی عامل
باید دادهای را بخواند، فایلها را تغییر دهد، پیام بفرستد، یک ارائهدهنده را فراخوانی کند یا
سامانهٔ دیگری را به کار گیرد، از ابزارها استفاده کنید. ابزارهای قابل مشاهده بهصورت
تعریفهای ساختیافتهٔ تابع برای مدل ارسال میشوند.
مدل فقط ابزارهایی را میبیند که پس از اعمال پروفایل فعال، خطمشی مجاز/غیرمجاز، محدودیتهای ارائهدهنده، وضعیت سندباکس، مجوزهای کانال و دسترسپذیری Plugin باقی میمانند.
وقتی عامل به دستورالعمل نیاز دارد، از Skill استفاده کنید
Skill یک بستهٔ دستورالعمل SKILL.md است که در پرامپت عامل بارگذاری میشود. وقتی
عامل از قبل ابزارهای موردنیاز خود را دارد، اما به یک
گردشکار تکرارپذیر، معیار بازبینی، توالی فرمانها یا محدودیت
عملیاتی نیاز دارد، از Skill استفاده کنید.
Skills میتوانند در یک فضای کاری، دایرکتوری مشترک Skills، ریشهٔ مدیریتشدهٔ Skills در OpenClaw یا بستهٔ Plugin قرار داشته باشند.
Skills | کارگاه Skill | خودآموزی | ایجاد Skills | پیکربندی Skills
وقتی OpenClaw به قابلیتی جدید نیاز دارد، از Plugin استفاده کنید
یک Plugin میتواند ابزارها، Skills، کانالها، ارائهدهندگان مدل، گفتار، صدای بلادرنگ، تولید رسانه، جستوجوی وب، واکشی وب، هوکها و دیگر قابلیتهای زمان اجرا را اضافه کند. وقتی قابلیت دارای کد، اعتبارنامه، هوکهای چرخهٔ حیات، فرادادهٔ مانیفست یا بستهبندی قابل نصب است، از Plugin استفاده کنید. Pluginهای موجود را میتوان از ClawHub، npm، git، دایرکتوریهای محلی یا بایگانیها نصب کرد.
دستههای ابزار داخلی
این جدول ابزارهای نمونه را فهرست میکند تا بتوانید این سطح را تشخیص دهید. این جدول مرجع کامل خطمشی نیست. برای گروهها، پیشفرضها و معنای دقیق مجاز/غیرمجاز، به ابزارها و ارائهدهندگان سفارشی مراجعه کنید.
| دسته | زمانی استفاده کنید که عامل باید... | ابزارهای نمونه | مطلب بعدی |
|---|---|---|---|
| زمان اجرا | فرمانها را اجرا، فرایندها را مدیریت یا از تحلیل Python مبتنی بر ارائهدهنده استفاده کند | exec، process، terminal، code_execution |
Exec، ترمینال Control UI، اجرای کد |
| فایلها | فایلهای فضای کاری را بخواند و تغییر دهد | read، write، edit، apply_patch |
اعمال وصله |
| ورودی انسانی | برای تصمیمی ساختیافته که در اختیار کاربر است، مکث کند | ask_user |
پرسش از کاربر |
| وب | وب و پستهای X را جستوجو یا محتوای خواندنی صفحه را واکشی کند | web_search، x_search، web_fetch |
ابزارهای وب، واکشی وب |
| مرورگر | یک نشست مرورگر را به کار گیرد | browser |
مرورگر |
| رابط کاربری اپراتور | پنجرهها، پنلها و پیمایش متصل Control UI را مرتب کند | screen |
صفحه |
| پیامرسانی و کانالها | پاسخها یا اقدامهای کانال را ارسال کند | message |
ارسال عامل |
| نشستها و عاملها | نشستها را بررسی، کار را واگذار، گردآورندهها را هماهنگ، اجرای دیگری را هدایت یا وضعیت را گزارش کند | sessions_*، agents_wait، 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 | ابزارهای واجد شرایط متعدد را بدون ارسال همهٔ طرحوارهها به مدل جستوجو، فراخوانی و ترکیب کند | exec، wait، tool_search_code، tool_search، tool_describe |
حالت کد، جستوجوی ابزار |
ابزارهای ارائهشده توسط Plugin
Pluginها میتوانند ابزارهای بیشتری ثبت کنند. نویسندگان Plugin ابزارها را از طریق
api.registerTool(...) و contracts.tools مانیفست متصل میکنند؛ برای جزئیات قرارداد از
SDK Plugin و مانیفست Plugin
استفاده کنید.
ابزارهای رایج ارائهشده توسط Plugin عبارتاند از:
- تفاوتها برای نمایش تفاوتهای فایل و Markdown
- نمایش ویجت برای SVG و HTML درونخطی و خودبسنده در کلاینتهای گفتوگوی پشتیبانیشده
- صفحهنمایش برای چیدمان یک رابط کاربری کنترل متصل
- وظیفه LLM برای مراحل گردش کاری که خروجی آنها فقط JSON است
- Lobster برای گردشهای کاری نوعدار با تأییدهای ازسرگرفتنی
- Tokenjuice برای فشردهسازی خروجی پرنویز ابزارهای
execوbash - جستوجوی ابزار برای یافتن و فراخوانی کاتالوگهای بزرگ ابزار بدون قراردادن همه طرحوارهها در پرامپت
- Canvas برای کنترل Canvas مبتنی بر Node و رندر A2UI
پیکربندی دسترسی و تأییدها
سیاست ابزار پیش از فراخوانی مدل اعمال میشود. اگر سیاست ابزاری را حذف کند، مدل در آن نوبت طرحواره آن ابزار را دریافت نمیکند. یک اجرا ممکن است بهدلیل پیکربندی سراسری، پیکربندی هر عامل، سیاست کانال، محدودیتهای ارائهدهنده، قواعد سندباکس، سیاست کانال/محیط اجرا یا دردسترسبودن Plugin، ابزارهایش را از دست بدهد.
- ابزارها و ارائهدهندگان سفارشی نمایههای ابزار، فهرستهای مجاز/غیرمجاز، محدودیتهای مختص ارائهدهنده، تشخیص حلقه و تنظیمات ابزارهای پشتیبانیشده توسط ارائهدهنده را مستند میکند.
- تأییدهای اجرا سیاست تأیید فرمانهای میزبان را مستند میکند.
- اجرای سطحبالا اجرای کنترلشده خارج از سندباکس را مستند میکند.
- سندباکس در برابر سیاست ابزار در برابر اجرای سطحبالا توضیح میدهد کدام لایه دسترسی به فایل و فرایند را کنترل میکند.
- محدودیتهای سندباکس و ابزار برای هر عامل محدودیتهای مختص عامل را برای اجراهای واگذارشده مستند میکند.
گسترش قابلیتها
مسیر توسعه را بر اساس کاری که OpenClaw باید انجام دهد انتخاب کنید:
- یک Plugin موجود را با Pluginها نصب یا مدیریت کنید.
- یک یکپارچهسازی، ارائهدهنده، کانال، ابزار یا هوک جدید را با ساخت Pluginها بسازید.
- دستورالعملهای قابلاستفاده مجدد عامل را با Skills و ایجاد Skills اضافه یا تنظیم کنید.
- هنگامی که به قراردادهای پیادهسازی نیاز دارید، از SDK Plugin و مانیفست Plugin استفاده کنید.
عیبیابی ابزارهای مفقود
اگر مدل نمیتواند ابزاری را ببیند یا فراخوانی کند، بررسی را از سیاست مؤثر برای نوبت جاری آغاز کنید:
- نمایه فعال،
tools.allowوtools.denyرا در ابزارها و ارائهدهندگان سفارشی بررسی کنید. - محدودیتهای مختص ارائهدهنده را در ابزارها و ارائهدهندگان سفارشی بررسی کنید و مطمئن شوید ارائهدهنده مدل انتخابشده از ساختار ابزار پشتیبانی میکند.
- مجوزهای کانال، وضعیت سندباکس و دسترسی سطحبالا را با سندباکس در برابر سیاست ابزار در برابر اجرای سطحبالا و اجرای سطحبالا بررسی کنید.
- بررسی کنید آیا Plugin مالک در Pluginها نصب و فعال شده است.
- برای اجراهای واگذارشده، محدودیتهای هر عامل را در محدودیتهای سندباکس و ابزار برای هر عامل بررسی کنید.
- برای کاتالوگهای بزرگ OpenClaw، بررسی کنید آیا اجرا از ارائه مستقیم ابزار، حالت کد یا جستوجوی ابزار استفاده میکند.
مرتبط
- خودکارسازی برای Cron، وظایف، Heartbeat، هوکها، دستورهای دائمی و جریان وظیفه
- عاملها برای مدل عامل، نشستها، حافظه و هماهنگی چندعاملی
- ابزارها و ارائهدهندگان سفارشی برای مرجع رسمی سیاست ابزار
- Pluginها برای نصب و مدیریت Plugin
- SDK Plugin برای مرجع نویسندگان Plugin
- Skills برای ترتیب بارگذاری، دروازهبندی و پیکربندی مهارتها
- کارگاه مهارت برای ایجاد مهارتهای تولیدشده و بازبینیشده
- جستوجوی ابزار برای کشف فشرده کاتالوگ ابزار OpenClaw
- حالت کد برای گردشهای کاری فشرده JavaScript یا TypeScript روی یک کاتالوگ ابزار پنهان OpenClaw
- ازدحام برای توزیع ساختاریافته و گردآوری از حالت کد
