---
doc-schema-version: 1
read_when:
    - می‌خواهید بدانید OpenClaw چه ابزارهایی ارائه می‌دهد
    - شما در حال انتخاب میان ابزارهای توکار، Skills و Pluginها هستید
    - برای سیاست ابزار، خودکارسازی، یا هماهنگی عامل‌ها به نقطهٔ ورود درست در مستندات نیاز دارید
summary: 'نمای کلی ابزارها، Skills و Plugin‌های OpenClaw: عامل‌ها چه چیزهایی را می‌توانند فراخوانی کنند و چگونه آن‌ها را گسترش دهید'
title: نمای کلی
x-i18n:
    generated_at: "2026-05-12T01:01:57Z"
    model: gpt-5.5
    provider: openai
    source_hash: 94424b04a520009d40d851e46f7ea0e4e914ff39b7d79958194bb123a6ec0b7b
    source_path: tools/index.md
    workflow: 16
---

از این صفحه برای انتخاب سطح مناسب قابلیت‌ها استفاده کنید. **ابزارها** کنش‌های قابل فراخوانی هستند، **Skills** به عامل‌ها می‌آموزند چگونه کار کنند، و **Pluginها** قابلیت‌های زمان اجرا مانند ابزارها، ارائه‌دهندگان، کانال‌ها، هوک‌ها، و 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) |
| یک ادغام جدید یا سطح زمان اجرا اضافه کنید | [Pluginها](#extend-capabilities) | [Pluginها](/fa/tools/plugin) و [ساخت Pluginها](/fa/plugins/building-plugins) |
| کار را بعدا یا در پس‌زمینه اجرا کنید | [اتوماسیون](/fa/automation) | [نمای کلی اتوماسیون](/fa/automation) |
| چند عامل یا هارنس را هماهنگ کنید | [زیرعامل‌ها](/fa/tools/subagents) | [عامل‌های ACP](/fa/tools/acp-agents) و [ارسال عامل](/fa/tools/agent-send) |
| یک کاتالوگ بزرگ ابزار PI را جستجو کنید | [جستجوی ابزار](/fa/tools/tool-search) | [جستجوی ابزار](/fa/tools/tool-search) |

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

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

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

  </Step>

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

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

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

  </Step>

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

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

  </Step>
</Steps>

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

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

| دسته | وقتی استفاده کنید که عامل لازم دارد... | ابزارهای نماینده | بعدی را بخوانید |
| ---------------------- | ----------------------------------------------------------------------------- | -------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| زمان اجرا | فرمان‌ها را اجرا کند، فرایندها را مدیریت کند، یا از تحلیل Python پشتیبانی‌شده توسط ارائه‌دهنده استفاده کند | `exec`، `process`، `code_execution` | [Exec](/fa/tools/exec)، [اجرای کد](/fa/tools/code-execution) |
| فایل‌ها | فایل‌های فضای کاری را بخواند و تغییر دهد | `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` | [زیرعامل‌ها](/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) |
| کاتالوگ‌های بزرگ PI | ابزارهای واجد شرایط زیادی را بدون ارسال هر schema به مدل جستجو و فراخوانی کند | `tool_search_code`، `tool_search`، `tool_describe` | [جستجوی ابزار](/fa/tools/tool-search) |

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

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

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

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

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

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

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

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

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

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

- یک Plugin موجود را با [Pluginها](/fa/tools/plugin) نصب یا مدیریت کنید.
- یک ادغام، ارائه‌دهنده، کانال، ابزار، یا هوک جدید را با
  [ساخت Pluginها](/fa/plugins/building-plugins) بسازید.
- دستورالعمل‌های عامل قابل استفاده مجدد را با [Skills](/fa/tools/skills) و
  [ایجاد Skills](/fa/tools/creating-skills) اضافه یا تنظیم کنید.
- وقتی گردش‌کار باید در یک بسته skill توزیع‌شده با Plugin قرار بگیرد،
  مواد گردش‌کار قابل استفاده مجدد را با
  [کارگاه skill](/fa/plugins/skill-workshop) بسته‌بندی کنید.
- وقتی به قراردادهای پیاده‌سازی نیاز دارید، از [SDK Plugin](/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. مجوزهای کانال، وضعیت سندباکس، و دسترسی ارتقایافته را با
   [سندباکس در برابر سیاست ابزار در برابر ارتقایافته](/fa/gateway/sandbox-vs-tool-policy-vs-elevated) و [exec ارتقایافته](/fa/tools/elevated) بررسی کنید.
4. بررسی کنید آیا Plugin مالک در
   [Pluginها](/fa/tools/plugin) نصب و فعال شده است.
5. برای اجراهای واگذارشده، محدودیت‌های هر عامل را در
   [سندباکس و محدودیت‌های ابزار برای هر عامل](/fa/tools/multi-agent-sandbox-tools) بررسی کنید.
6. برای کاتالوگ‌های بزرگ PI، تایید کنید آیا اجرا از ارائه مستقیم ابزار یا
   [جستجوی ابزار](/fa/tools/tool-search) استفاده می‌کند.

## مرتبط

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