---
read_when:
    - یک کلید پیکربندی `.experimental` را می‌بینید و می‌خواهید بدانید آیا پایدار است یا نه
    - می‌خواهید قابلیت‌های پیش‌نمایشِ زمان اجرا را امتحان کنید، بدون اینکه آن‌ها را با پیش‌فرض‌های معمول اشتباه بگیرید
    - می‌خواهید یک مکان واحد برای یافتن پرچم‌های آزمایشیِ مستندشدهٔ فعلی داشته باشید
summary: پرچم‌های آزمایشی در OpenClaw چه معنایی دارند و کدام‌یک در حال حاضر مستند شده‌اند
title: ویژگی‌های آزمایشی
x-i18n:
    generated_at: "2026-05-02T22:18:51Z"
    model: gpt-5.5
    provider: openai
    source_hash: 066efa297bac995597f1092ed6473d9cff28c01d7e28fa1382d7997f8f83a346
    source_path: concepts/experimental-features.md
    workflow: 16
---

ویژگی‌های آزمایشی در OpenClaw **سطح‌های پیش‌نمایش اختیاری** هستند. آن‌ها
پشت پرچم‌های صریح قرار دارند، چون هنوز پیش از آن‌که
شایسته‌ی یک پیش‌فرض پایدار یا یک قرارداد عمومی بادوام باشند، به آزمون واقعی بیشتری نیاز دارند.

با آن‌ها متفاوت از پیکربندی معمول رفتار کنید:

- آن‌ها را **به‌صورت پیش‌فرض خاموش** نگه دارید، مگر این‌که سند مرتبط از شما بخواهد یکی را امتحان کنید.
- انتظار داشته باشید **شکل و رفتار** سریع‌تر از پیکربندی پایدار تغییر کند.
- وقتی از قبل یک مسیر پایدار وجود دارد، ابتدا همان را ترجیح دهید.
- اگر OpenClaw را در مقیاس گسترده پیاده‌سازی می‌کنید، پرچم‌های آزمایشی را پیش از گنجاندن در یک مبنای مشترک، در محیطی کوچک‌تر آزمایش کنید.

## پرچم‌های مستندشده‌ی فعلی

| سطح                     | کلید                                                      | زمانی از آن استفاده کنید که                                                                                 | بیشتر                                                                                         |
| ------------------------ | --------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| زمان اجرای مدل محلی      | `agents.defaults.experimental.localModelLean`             | یک backend محلی کوچک‌تر یا سخت‌گیرتر با سطح کامل ابزارهای پیش‌فرض OpenClaw دچار مشکل می‌شود                 | [مدل‌های محلی](/fa/gateway/local-models)                                                         |
| جست‌وجوی حافظه           | `agents.defaults.memorySearch.experimental.sessionMemory` | می‌خواهید `memory_search` رونوشت‌های نشست‌های قبلی را نمایه‌سازی کند و هزینه‌ی اضافی ذخیره‌سازی/نمایه‌سازی را بپذیرید | [مرجع پیکربندی حافظه](/fa/reference/memory-config#session-memory-search-experimental) |
| ابزار برنامه‌ریزی ساخت‌یافته | `tools.experimental.planTool`                             | می‌خواهید ابزار ساخت‌یافته‌ی `update_plan` برای رهگیری کارهای چندمرحله‌ای در runtimeها و UIهای سازگار در دسترس باشد | [مرجع پیکربندی Gateway](/fa/gateway/config-tools#toolsexperimental)                    |

## حالت lean مدل محلی

`agents.defaults.experimental.localModelLean: true` یک دریچه‌ی کاهش فشار برای راه‌اندازی‌های ضعیف‌تر مدل محلی است. وقتی فعال باشد، OpenClaw سه ابزار پیش‌فرض — `browser`، `cron` و `message` — را از سطح ابزار agent در هر نوبت حذف می‌کند. هیچ چیز دیگری تغییر نمی‌کند.

### چرا این سه ابزار

این سه ابزار بزرگ‌ترین توضیحات و بیشترین شکل‌های پارامتر را در runtime پیش‌فرض OpenClaw دارند. در یک backend سازگار با OpenAI که context کوچکی دارد یا سخت‌گیرتر است، این همان تفاوت بین موارد زیر است:

- جا شدن تمیز schemaهای ابزار در prompt در برابر بیرون راندن سابقه‌ی گفت‌وگو.
- انتخاب ابزار درست توسط مدل در برابر تولید فراخوانی‌های ابزار بدشکل، چون schemaهای بیش از حد مشابه وجود دارد.
- باقی ماندن adapter مربوط به Chat Completions درون محدودیت‌های خروجی ساخت‌یافته‌ی سرور در برابر برخورد با خطای 400 به‌خاطر اندازه‌ی payload فراخوانی ابزار.

حذف آن‌ها OpenClaw را بی‌سروصدا بازسیم‌کشی نمی‌کند؛ فقط فهرست ابزارها را کوتاه‌تر می‌کند. مدل همچنان به `read`، `write`، `edit`، `exec`، `apply_patch`، جست‌وجو/دریافت وب (وقتی پیکربندی شده باشد)، حافظه، و ابزارهای نشست/agent دسترسی دارد.

### چه زمانی آن را فعال کنید

وقتی قبلا ثابت کرده‌اید که مدل می‌تواند با Gateway صحبت کند، اما نوبت‌های کامل agent بدرفتاری می‌کنند، حالت lean را فعال کنید. زنجیره‌ی نشانه‌های معمول این است:

1. `openclaw infer model run --gateway --model <ref> --prompt "Reply with exactly: pong"` موفق می‌شود.
2. یک نوبت معمول agent با فراخوانی‌های ابزار بدشکل، promptهای بیش از حد بزرگ، یا نادیده گرفتن ابزارها توسط مدل شکست می‌خورد.
3. تغییر `localModelLean: true` شکست را برطرف می‌کند.

### چه زمانی آن را خاموش بگذارید

اگر backend شما runtime پیش‌فرض کامل را تمیز مدیریت می‌کند، این گزینه را خاموش بگذارید. حالت lean یک راه‌حل موقت است، نه یک پیش‌فرض. این حالت وجود دارد چون بعضی stackهای محلی برای رفتار درست به سطح ابزار کوچک‌تری نیاز دارند؛ مدل‌های میزبانی‌شده و سامانه‌های محلی با منابع کافی چنین نیازی ندارند.

حالت lean همچنین جایگزین `tools.profile`، `tools.allow`/`tools.deny` یا راه فرار `compat.supportsTools: false` مدل نمی‌شود. اگر برای یک agent مشخص به سطح ابزار دائمی محدودتری نیاز دارید، آن کنترل‌های پایدار را به پرچم آزمایشی ترجیح دهید.

### فعال‌سازی

```json5
{
  agents: {
    defaults: {
      experimental: {
        localModelLean: true,
      },
    },
  },
}
```

پس از تغییر پرچم، Gateway را راه‌اندازی مجدد کنید، سپس فهرست ابزارهای کوتاه‌شده را با این دستور تأیید کنید:

```bash
openclaw status --deep
```

خروجی وضعیت عمیق، ابزارهای فعال agent را فهرست می‌کند؛ وقتی حالت lean فعال است، `browser`، `cron` و `message` نباید وجود داشته باشند.

## آزمایشی به معنی پنهان نیست

اگر یک ویژگی آزمایشی است، OpenClaw باید این موضوع را در اسناد و در خود مسیر پیکربندی به‌روشنی بگوید. کاری که **نباید** انجام دهد این است که رفتار پیش‌نمایش را درون یک کنترل پیش‌فرض با ظاهر پایدار پنهان کند و وانمود کند که این عادی است. این همان راهی است که سطح‌های پیکربندی را آشفته می‌کند.

## مرتبط

- [ویژگی‌ها](/fa/concepts/features)
- [کانال‌های انتشار](/fa/install/development-channels)