Overview
نمای کلی
از این صفحه برای انتخاب سطح مناسب قابلیتها استفاده کنید. ابزارها کنشهای قابل فراخوانی هستند، Skills به عاملها یاد میدهند چگونه کار کنند، و Pluginها قابلیتهای زمان اجرا مانند ابزارها، ارائهدهندهها، کانالها، hookها و Skills بستهبندیشده را اضافه میکنند.
این صفحه یک نمای کلی و صفحه مسیریابی است. برای سیاست کامل ابزار، پیشفرضها، عضویت گروهها، محدودیتهای ارائهدهنده، و فیلدهای پیکربندی، از ابزارها و ارائهدهندههای سفارشی استفاده کنید.
از اینجا شروع کنید
برای بیشتر عاملها، با دستههای ابزار داخلی شروع کنید، سپس سیاست را فقط زمانی تنظیم کنید که عامل باید ابزارهای کمتری ببیند یا به دسترسی صریح میزبان نیاز دارد.
| اگر نیاز دارید... | ابتدا از این استفاده کنید | سپس بخوانید |
|---|---|---|
| به عامل اجازه دهید با قابلیتهای موجود عمل کند | ابزارهای داخلی | دستههای ابزار |
| کنترل کنید عامل چه چیزی را میتواند فراخوانی کند | سیاست ابزار | ابزارها و ارائهدهندههای سفارشی |
| یک گردشکار را به عامل آموزش دهید | Skills | Skills، ایجاد Skills، و کارگاه Skill |
| یک یکپارچهسازی یا سطح زمان اجرای جدید اضافه کنید | Pluginها | Pluginها و ساخت Pluginها |
| کار را بعدا یا در پسزمینه اجرا کنید | اتوماسیون | نمای کلی اتوماسیون |
| چند عامل یا harness را هماهنگ کنید | زیرعاملها | عاملهای ACP و ارسال عامل |
| یک کاتالوگ بزرگ ابزار OpenClaw را جستوجو کنید | جستوجوی ابزار | جستوجوی ابزار |
ابزارها، Skills، یا Pluginها را انتخاب کنید
وقتی عامل باید عمل کند از ابزار استفاده کنید
ابزار یک تابع تایپشده است که عامل میتواند آن را فراخوانی کند، مانند exec، browser، web_search، message، یا image_generate. وقتی عامل باید داده بخواند، فایلها را تغییر دهد، پیام بفرستد، یک ارائهدهنده را فراخوانی کند، یا سیستم دیگری را اجرا کند، از ابزارها استفاده کنید. ابزارهای قابل مشاهده بهصورت تعریفهای تابع ساختاریافته به مدل ارسال میشوند.
مدل فقط ابزارهایی را میبیند که از پروفایل فعال، سیاست مجاز/ممنوع، محدودیتهای ارائهدهنده، وضعیت sandbox، مجوزهای کانال، و دسترسپذیری Plugin عبور کنند.
وقتی عامل به دستورالعمل نیاز دارد از Skill استفاده کنید
Skill یک بسته دستورالعمل SKILL.md است که در prompt عامل بارگذاری میشود. وقتی عامل ابزارهای لازم را از قبل دارد، اما به یک گردشکار تکرارپذیر، rubric بازبینی، توالی فرمان، یا محدودیت عملیاتی نیاز دارد، از Skill استفاده کنید.
Skills میتوانند در یک workspace، دایرکتوری Skill مشترک، ریشه Skill مدیریتشده OpenClaw، یا بسته Plugin قرار داشته باشند.
وقتی OpenClaw به قابلیت جدید نیاز دارد از Plugin استفاده کنید
یک Plugin میتواند ابزارها، Skills، کانالها، ارائهدهندههای مدل، گفتار، صدای بلادرنگ، تولید رسانه، جستوجوی وب، دریافت وب، hookها، و دیگر قابلیتهای زمان اجرا را اضافه کند. وقتی قابلیت شامل کد، اعتبارنامهها، hookهای چرخه عمر، فراداده manifest، یا بستهبندی قابل نصب است، از Plugin استفاده کنید. Pluginهای موجود را میتوان از ClawHub، npm، git، دایرکتوریهای محلی، یا آرشیوها نصب کرد.
دستههای ابزار داخلی
جدول ابزارهای نماینده را فهرست میکند تا بتوانید سطح را تشخیص دهید. این مرجع کامل سیاست نیست. برای گروههای دقیق، پیشفرضها، و معناشناسی مجاز/ممنوع، از ابزارها و ارائهدهندههای سفارشی استفاده کنید.
| دسته | وقتی عامل باید... | ابزارهای نماینده | بعدی را بخوانید |
|---|---|---|---|
| زمان اجرا | فرمانها را اجرا کند، فرایندها را مدیریت کند، یا از تحلیل Python پشتیبانیشده توسط ارائهدهنده استفاده کند | exec، process، code_execution |
Exec، اجرای کد |
| فایلها | فایلهای workspace را بخواند و تغییر دهد | read، write، edit، apply_patch |
اعمال patch |
| وب | وب را جستوجو کند، پستهای X را جستوجو کند، یا محتوای خوانای صفحه را دریافت کند | web_search، x_search، web_fetch |
ابزارهای وب، دریافت وب |
| مرورگر | یک نشست مرورگر را اجرا کند | browser |
مرورگر |
| پیامرسانی و کانالها | پاسخها یا کنشهای کانال را ارسال کند | message |
ارسال عامل |
| نشستها و عاملها | نشستها را بازرسی کند، کار را واگذار کند، اجرای دیگری را هدایت کند، یا وضعیت را گزارش کند | sessions_*، subagents، agents_list، session_status، goal |
هدف، زیرعاملها، ابزار نشست |
| اتوماسیون | کار را زمانبندی کند یا به رویدادهای پسزمینه پاسخ دهد | cron، heartbeat_respond |
اتوماسیون |
| Gateway و گرهها | وضعیت Gateway یا دستگاههای هدف جفتشده را بازرسی کند | gateway، nodes |
پیکربندی Gateway، گرهها |
| رسانه | رسانه را تحلیل، تولید، یا بیان کند | image، image_generate، music_generate، video_generate، tts |
نمای کلی رسانه |
| کاتالوگهای بزرگ OpenClaw | بدون ارسال هر schema به مدل، بسیاری از ابزارهای واجد شرایط را جستوجو و فراخوانی کند | tool_search_code، tool_search، tool_describe |
جستوجوی ابزار |
ابزارهای ارائهشده توسط Plugin
Pluginها میتوانند ابزارهای اضافی ثبت کنند. نویسندگان Plugin ابزارها را از طریق api.registerTool(...) و contracts.tools در manifest وصل میکنند؛ برای جزئیات قرارداد از Plugin SDK و manifest Plugin استفاده کنید.
ابزارهای رایج ارائهشده توسط Plugin شامل این موارد هستند:
- Diffها برای رندر کردن diffهای فایل و Markdown
- LLM Task برای گامهای گردشکار فقط JSON
- Lobster برای گردشکارهای تایپشده با تاییدهای قابل ازسرگیری
- Tokenjuice برای فشردهسازی خروجی پرنویز ابزارهای
execوbash - جستوجوی ابزار برای کشف و فراخوانی کاتالوگهای بزرگ ابزار بدون قرار دادن هر schema در prompt
- Canvas برای کنترل Canvas گره و رندر A2UI
پیکربندی دسترسی و تاییدها
سیاست ابزار پیش از فراخوانی مدل اعمال میشود. اگر سیاست ابزاری را حذف کند، مدل schema آن ابزار را برای آن نوبت دریافت نمیکند. یک اجرا ممکن است بهدلیل پیکربندی سراسری، پیکربندی هر عامل، سیاست کانال، محدودیتهای ارائهدهنده، قوانین sandbox، سیاست کانال/زمان اجرا، یا دسترسپذیری Plugin ابزارها را از دست بدهد.
- ابزارها و ارائهدهندههای سفارشی پروفایلهای ابزار، فهرستهای مجاز/ممنوع، محدودیتهای مخصوص ارائهدهنده، تشخیص حلقه، و تنظیمات ابزار پشتیبانیشده توسط ارائهدهنده را مستند میکند.
- تاییدهای Exec سیاست تایید فرمان میزبان را مستند میکند.
- Exec ارتقایافته اجرای کنترلشده خارج از sandbox را مستند میکند.
- Sandbox در برابر سیاست ابزار در برابر ارتقایافته توضیح میدهد کدام لایه دسترسی فایل و فرایند را کنترل میکند.
- محدودیتهای sandbox و ابزار برای هر عامل محدودیتهای مخصوص عامل برای اجراهای واگذارشده را مستند میکند.
گسترش قابلیتها
مسیر گسترش را بر اساس کاری که لازم دارید OpenClaw انجام دهد انتخاب کنید:
- یک Plugin موجود را با Pluginها نصب یا مدیریت کنید.
- یک یکپارچهسازی، ارائهدهنده، کانال، ابزار، یا hook جدید را با ساخت Pluginها بسازید.
- دستورالعملهای قابل استفاده مجدد عامل را با Skills و ایجاد Skills اضافه یا تنظیم کنید.
- وقتی به قراردادهای پیادهسازی نیاز دارید، از Plugin SDK و manifest Plugin استفاده کنید.
عیبیابی ابزارهای غایب
اگر مدل نمیتواند یک ابزار را ببیند یا فراخوانی کند، با سیاست موثر برای نوبت فعلی شروع کنید:
- پروفایل فعال،
tools.allow، وtools.denyرا در ابزارها و ارائهدهندههای سفارشی بررسی کنید. - محدودیتهای مخصوص ارائهدهنده را در ابزارها و ارائهدهندههای سفارشی بررسی کنید و تایید کنید ارائهدهنده مدل انتخابشده از شکل ابزار پشتیبانی میکند.
- مجوزهای کانال، وضعیت sandbox، و دسترسی ارتقایافته را با Sandbox در برابر سیاست ابزار در برابر ارتقایافته و Exec ارتقایافته بررسی کنید.
- بررسی کنید آیا Plugin مالک در Pluginها نصب و فعال شده است.
- برای اجراهای واگذارشده، محدودیتهای هر عامل را در محدودیتهای sandbox و ابزار برای هر عامل بررسی کنید.
- برای کاتالوگهای بزرگ OpenClaw، تایید کنید آیا اجرا از نمایش مستقیم ابزار استفاده میکند یا از جستوجوی ابزار.
مرتبط
- اتوماسیون برای cron، taskها، heartbeat، تعهدات، hookها، دستورهای دائمی، و Task Flow
- عاملها برای مدل عامل، نشستها، حافظه، و هماهنگی چندعاملی
- ابزارها و ارائهدهندههای سفارشی برای مرجع canonical سیاست ابزار
- Pluginها برای نصب و مدیریت Plugin
- Plugin SDK برای مرجع نویسندگان Plugin
- Skills برای ترتیب بارگذاری Skill، gating، و پیکربندی
- کارگاه Skill برای ایجاد Skill تولیدشده و بازبینیشده
- جستوجوی ابزار برای کشف فشرده کاتالوگ ابزار OpenClaw
