---
doc-schema-version: 1
read_when:
    - می‌خواهید بدانید OpenClaw چه ابزارهایی ارائه می‌دهد
    - شما در حال انتخاب میان ابزارهای داخلی، Skills و Pluginها هستید
    - برای خط‌مشی ابزارها، خودکارسازی یا هماهنگی عامل‌ها، به نقطه ورود مناسب مستندات نیاز دارید
summary: 'نمای کلی ابزارها، Skills و Pluginهای OpenClaw: عامل‌ها چه چیزهایی را می‌توانند فراخوانی کنند و چگونه می‌توان آن‌ها را گسترش داد'
title: نمای کلی
x-i18n:
    generated_at: "2026-07-12T10:58:09Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 628b47a8756e229a712981b669c96a36689909755dcd244667612f8761e67526
    source_path: tools/index.md
    workflow: 16
---

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

## انتخاب ابزارها، Skills یا افزونه‌ها

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

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

  </Step>

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

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

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

  </Step>

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

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

  </Step>
</Steps>

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

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

| دسته                         | زمانی استفاده کنید که عامل باید...                                             | ابزارهای شاخص                                                                                         | مطالعهٔ بعدی                                                                                         |
| ---------------------------- | ------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| زمان اجرا                    | فرمان‌ها را اجرا کند، فرایندها را مدیریت کند یا از تحلیل Python مبتنی بر ارائه‌دهنده استفاده کند | `exec`، `process`، `code_execution`                                                                  | [اجرای فرمان](/fa/tools/exec)، [اجرای کد](/fa/tools/code-execution)                                       |
| فایل‌ها                      | فایل‌های فضای کاری را بخواند و تغییر دهد                                        | `read`، `write`، `edit`، `apply_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`، `get_goal`، `create_goal`، `update_goal` | [هدف](/fa/tools/goal)، [زیرعامل‌ها](/fa/tools/subagents)، [ابزار نشست](/fa/concepts/session-tool)             |
| خودکارسازی                   | کار را زمان‌بندی کند یا به رویدادهای پس‌زمینه پاسخ دهد                          | `cron`، `heartbeat_respond`                                                                          | [خودکارسازی](/fa/automation)                                                                            |
| Gateway و Nodeها             | وضعیت Gateway یا دستگاه‌های هدف جفت‌شده را بررسی کند                           | `gateway`، `nodes`                                                                                   | [پیکربندی Gateway](/fa/gateway/configuration)، [Nodeها](/fa/nodes)                                        |
| رسانه                        | رسانه را تحلیل یا تولید کند یا آن را به گفتار تبدیل کند                         | `image`، `image_generate`، `music_generate`، `video_generate`، `tts`                                 | [نمای کلی رسانه](/fa/tools/media-overview)                                                             |
| فهرست‌های بزرگ OpenClaw      | بدون ارسال همهٔ طرح‌واره‌ها به مدل، ابزارهای واجد شرایط بسیاری را جست‌وجو و فراخوانی کند | `tool_search_code`، `tool_search`، `tool_describe`                                                   | [جست‌وجوی ابزار](/fa/tools/tool-search)                                                                 |

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

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

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

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

- [تفاوت‌ها](/fa/tools/diffs) برای نمایش تفاوت‌های فایل و markdown
- [نمایش ویجت](/tools/show-widget) برای SVG و HTML درون‌خطی و مستقل در گفت‌وگوی وب
- [وظیفهٔ LLM](/fa/tools/llm-task) برای مراحل گردش‌کاری که فقط از JSON استفاده می‌کنند
- [Lobster](/fa/tools/lobster) برای گردش‌کارهای نوع‌دار با تأییدهای قابل ازسرگیری
- [Tokenjuice](/fa/tools/tokenjuice) برای فشرده‌سازی خروجی شلوغ ابزارهای `exec` و `bash`
- [جست‌وجوی ابزار](/fa/tools/tool-search) برای کشف و فراخوانی فهرست‌های بزرگ ابزار
  بدون قراردادن همهٔ طرح‌واره‌ها در اعلان
- [Canvas](/fa/plugins/reference/canvas) برای کنترل Canvas در Node و
  رندر A2UI

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

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

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

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

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

- با [افزونه‌ها](/fa/tools/plugin) یک افزونهٔ موجود را نصب یا مدیریت کنید.
- با [ساخت افزونه‌ها](/fa/plugins/building-plugins) یک یکپارچه‌سازی، ارائه‌دهنده،
  کانال، ابزار یا هوک جدید بسازید.
- با [Skills](/fa/tools/skills) و
  [ایجاد Skills](/fa/tools/creating-skills) دستورالعمل‌های قابل استفادهٔ مجدد عامل را
  اضافه یا تنظیم کنید.
- زمانی که به قراردادهای پیاده‌سازی نیاز دارید، از [SDK افزونه](/fa/plugins/sdk-overview) و
  [مانیفست افزونه](/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)
   و [اجرای فرمان با دسترسی ارتقایافته](/fa/tools/elevated) بررسی کنید.
4. در [افزونه‌ها](/fa/tools/plugin) بررسی کنید که افزونهٔ مالک نصب و فعال شده باشد.
5. برای اجراهای واگذارشده، محدودیت‌های مختص عامل را در
   [محیط ایزوله و محدودیت‌های ابزار برای هر عامل](/fa/tools/multi-agent-sandbox-tools) بررسی کنید.
6. برای فهرست‌های بزرگ OpenClaw، مشخص کنید که اجرا از ارائهٔ مستقیم ابزار استفاده می‌کند یا
   [جست‌وجوی ابزار](/fa/tools/tool-search).

## مطالب مرتبط

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