---
doc-schema-version: 1
read_when:
    - می‌خواهید بدانید OpenClaw چه ابزارهایی ارائه می‌دهد
    - در حال تصمیم‌گیری بین ابزارهای توکار، Skills و Pluginها هستید
    - برای سیاست ابزار، اتوماسیون، یا هماهنگی عامل به نقطهٔ ورود درست مستندات نیاز دارید
summary: 'نمای کلی ابزارها، Skills و Pluginهای OpenClaw: عامل‌ها چه چیزهایی را می‌توانند فراخوانی کنند و چگونه آن‌ها را گسترش دهند'
title: نمای کلی
x-i18n:
    generated_at: "2026-06-27T19:01:39Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: f49afa2354ebb26eeb5f036cd1f2f7ceb228b01287adbc6c305addfb0af4502d
    source_path: tools/index.md
    workflow: 16
---

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

این صفحه یک نمای کلی و صفحه مسیریابی است. برای سیاست کامل ابزار، پیش‌فرض‌ها، عضویت گروه‌ها، محدودیت‌های ارائه‌دهنده، و فیلدهای پیکربندی، از [ابزارها و ارائه‌دهنده‌های سفارشی](/fa/gateway/config-tools) استفاده کنید.

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

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

| اگر نیاز دارید... | ابتدا از این استفاده کنید | سپس بخوانید |
| ------------------------------------------- | ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| به عامل اجازه دهید با قابلیت‌های موجود عمل کند | [ابزارهای داخلی](#built-in-tool-categories) | [دسته‌های ابزار](#built-in-tool-categories) |
| کنترل کنید عامل چه چیزی را می‌تواند فراخوانی کند | [سیاست ابزار](#configure-access-and-approvals) | [ابزارها و ارائه‌دهنده‌های سفارشی](/fa/gateway/config-tools) |
| یک گردش‌کار را به عامل آموزش دهید | [Skills](#choose-tools-skills-or-plugins) | [Skills](/fa/tools/skills)، [ایجاد Skills](/fa/tools/creating-skills)، و [کارگاه Skill](/fa/tools/skill-workshop) |
| یک یکپارچه‌سازی یا سطح زمان اجرای جدید اضافه کنید | [Pluginها](#extend-capabilities) | [Pluginها](/fa/tools/plugin) و [ساخت Pluginها](/fa/plugins/building-plugins) |
| کار را بعدا یا در پس‌زمینه اجرا کنید | [اتوماسیون](/fa/automation) | [نمای کلی اتوماسیون](/fa/automation) |
| چند عامل یا harness را هماهنگ کنید | [زیرعامل‌ها](/fa/tools/subagents) | [عامل‌های ACP](/fa/tools/acp-agents) و [ارسال عامل](/fa/tools/agent-send) |
| یک کاتالوگ بزرگ ابزار OpenClaw را جست‌وجو کنید | [جست‌وجوی ابزار](/fa/tools/tool-search) | [جست‌وجوی ابزار](/fa/tools/tool-search) |

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

<Steps>
  <Step title="وقتی عامل باید عمل کند از ابزار استفاده کنید">
    ابزار یک تابع تایپ‌شده است که عامل می‌تواند آن را فراخوانی کند، مانند `exec`، `browser`، `web_search`، `message`، یا `image_generate`. وقتی عامل باید داده بخواند، فایل‌ها را تغییر دهد، پیام بفرستد، یک ارائه‌دهنده را فراخوانی کند، یا سیستم دیگری را اجرا کند، از ابزارها استفاده کنید. ابزارهای قابل مشاهده به‌صورت تعریف‌های تابع ساختاریافته به مدل ارسال می‌شوند.

    مدل فقط ابزارهایی را می‌بیند که از پروفایل فعال، سیاست مجاز/ممنوع، محدودیت‌های ارائه‌دهنده، وضعیت sandbox، مجوزهای کانال، و دسترس‌پذیری Plugin عبور کنند.

  </Step>

  <Step title="وقتی عامل به دستورالعمل نیاز دارد از Skill استفاده کنید">
    Skill یک بسته دستورالعمل `SKILL.md` است که در prompt عامل بارگذاری می‌شود. وقتی عامل ابزارهای لازم را از قبل دارد، اما به یک گردش‌کار تکرارپذیر، rubric بازبینی، توالی فرمان، یا محدودیت عملیاتی نیاز دارد، از Skill استفاده کنید.

    Skills می‌توانند در یک workspace، دایرکتوری Skill مشترک، ریشه Skill مدیریت‌شده OpenClaw، یا بسته Plugin قرار داشته باشند.

    [Skills](/fa/tools/skills) | [کارگاه Skill](/fa/tools/skill-workshop) | [ایجاد Skills](/fa/tools/creating-skills) | [پیکربندی Skills](/fa/tools/skills-config)

  </Step>

  <Step title="وقتی OpenClaw به قابلیت جدید نیاز دارد از Plugin استفاده کنید">
    یک Plugin می‌تواند ابزارها، Skills، کانال‌ها، ارائه‌دهنده‌های مدل، گفتار، صدای بلادرنگ، تولید رسانه، جست‌وجوی وب، دریافت وب، hookها، و دیگر قابلیت‌های زمان اجرا را اضافه کند. وقتی قابلیت شامل کد، اعتبارنامه‌ها، hookهای چرخه عمر، فراداده manifest، یا بسته‌بندی قابل نصب است، از Plugin استفاده کنید. Pluginهای موجود را می‌توان از ClawHub، npm، git، دایرکتوری‌های محلی، یا آرشیوها نصب کرد.

    [نصب و پیکربندی Pluginها](/fa/tools/plugin) | [ساخت Pluginها](/fa/plugins/building-plugins) | [Plugin SDK](/fa/plugins/sdk-overview)

  </Step>
</Steps>

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

جدول ابزارهای نماینده را فهرست می‌کند تا بتوانید سطح را تشخیص دهید. این مرجع کامل سیاست نیست. برای گروه‌های دقیق، پیش‌فرض‌ها، و معناشناسی مجاز/ممنوع، از [ابزارها و ارائه‌دهنده‌های سفارشی](/fa/gateway/config-tools) استفاده کنید.

| دسته | وقتی عامل باید... | ابزارهای نماینده | بعدی را بخوانید |
| ----------------------- | ----------------------------------------------------------------------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| زمان اجرا | فرمان‌ها را اجرا کند، فرایندها را مدیریت کند، یا از تحلیل Python پشتیبانی‌شده توسط ارائه‌دهنده استفاده کند | `exec`، `process`، `code_execution` | [Exec](/fa/tools/exec)، [اجرای کد](/fa/tools/code-execution) |
| فایل‌ها | فایل‌های workspace را بخواند و تغییر دهد | `read`، `write`، `edit`، `apply_patch` | [اعمال patch](/fa/tools/apply-patch) |
| وب | وب را جست‌وجو کند، پست‌های X را جست‌وجو کند، یا محتوای خوانای صفحه را دریافت کند | `web_search`، `x_search`، `web_fetch` | [ابزارهای وب](/fa/tools/web)، [دریافت وب](/fa/tools/web-fetch) |
| مرورگر | یک نشست مرورگر را اجرا کند | `browser` | [مرورگر](/fa/tools/browser) |
| پیام‌رسانی و کانال‌ها | پاسخ‌ها یا کنش‌های کانال را ارسال کند | `message` | [ارسال عامل](/fa/tools/agent-send) |
| نشست‌ها و عامل‌ها | نشست‌ها را بازرسی کند، کار را واگذار کند، اجرای دیگری را هدایت کند، یا وضعیت را گزارش کند | `sessions_*`، `subagents`، `agents_list`، `session_status`، `goal` | [هدف](/fa/tools/goal)، [زیرعامل‌ها](/fa/tools/subagents)، [ابزار نشست](/fa/concepts/session-tool) |
| اتوماسیون | کار را زمان‌بندی کند یا به رویدادهای پس‌زمینه پاسخ دهد | `cron`، `heartbeat_respond` | [اتوماسیون](/fa/automation) |
| Gateway و گره‌ها | وضعیت Gateway یا دستگاه‌های هدف جفت‌شده را بازرسی کند | `gateway`، `nodes` | [پیکربندی Gateway](/fa/gateway/configuration)، [گره‌ها](/fa/nodes) |
| رسانه | رسانه را تحلیل، تولید، یا بیان کند | `image`، `image_generate`، `music_generate`، `video_generate`، `tts` | [نمای کلی رسانه](/fa/tools/media-overview) |
| کاتالوگ‌های بزرگ OpenClaw | بدون ارسال هر schema به مدل، بسیاری از ابزارهای واجد شرایط را جست‌وجو و فراخوانی کند | `tool_search_code`، `tool_search`، `tool_describe` | [جست‌وجوی ابزار](/fa/tools/tool-search) |

<Note>
جست‌وجوی ابزار یک سطح آزمایشی عامل OpenClaw است. اجراهای harness در Codex به‌جای `tools.toolSearch` از حالت کد بومی Codex، جست‌وجوی ابزار بومی، ابزارهای پویا و معوق، و فراخوانی‌های ابزار تودرتو استفاده می‌کنند.
</Note>

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

Pluginها می‌توانند ابزارهای اضافی ثبت کنند. نویسندگان Plugin ابزارها را از طریق `api.registerTool(...)` و `contracts.tools` در manifest وصل می‌کنند؛ برای جزئیات قرارداد از [Plugin SDK](/fa/plugins/sdk-overview) و [manifest Plugin](/fa/plugins/manifest) استفاده کنید.

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

- [Diffها](/fa/tools/diffs) برای رندر کردن diffهای فایل و Markdown
- [LLM Task](/fa/tools/llm-task) برای گام‌های گردش‌کار فقط JSON
- [Lobster](/fa/tools/lobster) برای گردش‌کارهای تایپ‌شده با تاییدهای قابل ازسرگیری
- [Tokenjuice](/fa/tools/tokenjuice) برای فشرده‌سازی خروجی پرنویز ابزارهای `exec` و `bash`
- [جست‌وجوی ابزار](/fa/tools/tool-search) برای کشف و فراخوانی کاتالوگ‌های بزرگ ابزار بدون قرار دادن هر schema در prompt
- [Canvas](/fa/plugins/reference/canvas) برای کنترل Canvas گره و رندر A2UI

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

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

- [ابزارها و ارائه‌دهنده‌های سفارشی](/fa/gateway/config-tools) پروفایل‌های ابزار، فهرست‌های مجاز/ممنوع، محدودیت‌های مخصوص ارائه‌دهنده، تشخیص حلقه، و تنظیمات ابزار پشتیبانی‌شده توسط ارائه‌دهنده را مستند می‌کند.
- [تاییدهای Exec](/fa/tools/exec-approvals) سیاست تایید فرمان میزبان را مستند می‌کند.
- [Exec ارتقایافته](/fa/tools/elevated) اجرای کنترل‌شده خارج از sandbox را مستند می‌کند.
- [Sandbox در برابر سیاست ابزار در برابر ارتقایافته](/fa/gateway/sandbox-vs-tool-policy-vs-elevated) توضیح می‌دهد کدام لایه دسترسی فایل و فرایند را کنترل می‌کند.
- [محدودیت‌های sandbox و ابزار برای هر عامل](/fa/tools/multi-agent-sandbox-tools) محدودیت‌های مخصوص عامل برای اجراهای واگذارشده را مستند می‌کند.

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

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

- یک Plugin موجود را با [Pluginها](/fa/tools/plugin) نصب یا مدیریت کنید.
- یک یکپارچه‌سازی، ارائه‌دهنده، کانال، ابزار، یا hook جدید را با [ساخت Pluginها](/fa/plugins/building-plugins) بسازید.
- دستورالعمل‌های قابل استفاده مجدد عامل را با [Skills](/fa/tools/skills) و [ایجاد Skills](/fa/tools/creating-skills) اضافه یا تنظیم کنید.
- وقتی به قراردادهای پیاده‌سازی نیاز دارید، از [Plugin SDK](/fa/plugins/sdk-overview) و [manifest Plugin](/fa/plugins/manifest) استفاده کنید.

## عیب‌یابی ابزارهای غایب

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

1. پروفایل فعال، `tools.allow`، و `tools.deny` را در [ابزارها و ارائه‌دهنده‌های سفارشی](/fa/gateway/config-tools) بررسی کنید.
2. محدودیت‌های مخصوص ارائه‌دهنده را در [ابزارها و ارائه‌دهنده‌های سفارشی](/fa/gateway/config-tools) بررسی کنید و تایید کنید [ارائه‌دهنده مدل](/fa/concepts/model-providers) انتخاب‌شده از شکل ابزار پشتیبانی می‌کند.
3. مجوزهای کانال، وضعیت sandbox، و دسترسی ارتقایافته را با [Sandbox در برابر سیاست ابزار در برابر ارتقایافته](/fa/gateway/sandbox-vs-tool-policy-vs-elevated) و [Exec ارتقایافته](/fa/tools/elevated) بررسی کنید.
4. بررسی کنید آیا Plugin مالک در [Pluginها](/fa/tools/plugin) نصب و فعال شده است.
5. برای اجراهای واگذارشده، محدودیت‌های هر عامل را در [محدودیت‌های sandbox و ابزار برای هر عامل](/fa/tools/multi-agent-sandbox-tools) بررسی کنید.
6. برای کاتالوگ‌های بزرگ OpenClaw، تایید کنید آیا اجرا از نمایش مستقیم ابزار استفاده می‌کند یا از [جست‌وجوی ابزار](/fa/tools/tool-search).

## مرتبط

- [اتوماسیون](/fa/automation) برای cron، taskها، heartbeat، تعهدات، hookها، دستورهای دائمی، و Task Flow
- [عامل‌ها](/fa/concepts/agent) برای مدل عامل، نشست‌ها، حافظه، و هماهنگی چندعاملی
- [ابزارها و ارائه‌دهنده‌های سفارشی](/fa/gateway/config-tools) برای مرجع canonical سیاست ابزار
- [Pluginها](/fa/tools/plugin) برای نصب و مدیریت Plugin
- [Plugin SDK](/fa/plugins/sdk-overview) برای مرجع نویسندگان Plugin
- [Skills](/fa/tools/skills) برای ترتیب بارگذاری Skill، gating، و پیکربندی
- [کارگاه Skill](/fa/tools/skill-workshop) برای ایجاد Skill تولیدشده و بازبینی‌شده
- [جست‌وجوی ابزار](/fa/tools/tool-search) برای کشف فشرده کاتالوگ ابزار OpenClaw