Fundamentals
ویژگیهای آزمایشی
ویژگیهای آزمایشی در OpenClaw سطحهای پیشنمایش اختیاری هستند. آنها پشت پرچمهای صریح قرار دارند، چون هنوز پیش از آنکه شایستهی یک پیشفرض پایدار یا یک قرارداد عمومی بادوام باشند، به آزمون واقعی بیشتری نیاز دارند.
با آنها متفاوت از پیکربندی معمول رفتار کنید:
- آنها را بهصورت پیشفرض خاموش نگه دارید، مگر اینکه سند مرتبط از شما بخواهد یکی را امتحان کنید.
- انتظار داشته باشید شکل و رفتار سریعتر از پیکربندی پایدار تغییر کند.
- وقتی از قبل یک مسیر پایدار وجود دارد، ابتدا همان را ترجیح دهید.
- اگر OpenClaw را در مقیاس گسترده پیادهسازی میکنید، پرچمهای آزمایشی را پیش از گنجاندن در یک مبنای مشترک، در محیطی کوچکتر آزمایش کنید.
پرچمهای مستندشدهی فعلی
| سطح | کلید | زمانی از آن استفاده کنید که | بیشتر |
|---|---|---|---|
| زمان اجرای مدل محلی | agents.defaults.experimental.localModelLean |
یک backend محلی کوچکتر یا سختگیرتر با سطح کامل ابزارهای پیشفرض OpenClaw دچار مشکل میشود | مدلهای محلی |
| جستوجوی حافظه | agents.defaults.memorySearch.experimental.sessionMemory |
میخواهید memory_search رونوشتهای نشستهای قبلی را نمایهسازی کند و هزینهی اضافی ذخیرهسازی/نمایهسازی را بپذیرید |
مرجع پیکربندی حافظه |
| ابزار برنامهریزی ساختیافته | tools.experimental.planTool |
میخواهید ابزار ساختیافتهی update_plan برای رهگیری کارهای چندمرحلهای در runtimeها و UIهای سازگار در دسترس باشد |
مرجع پیکربندی Gateway |
حالت 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 را فعال کنید. زنجیرهی نشانههای معمول این است:
openclaw infer model run --gateway --model <ref> --prompt "Reply with exactly: pong"موفق میشود.- یک نوبت معمول agent با فراخوانیهای ابزار بدشکل، promptهای بیش از حد بزرگ، یا نادیده گرفتن ابزارها توسط مدل شکست میخورد.
- تغییر
localModelLean: trueشکست را برطرف میکند.
چه زمانی آن را خاموش بگذارید
اگر backend شما runtime پیشفرض کامل را تمیز مدیریت میکند، این گزینه را خاموش بگذارید. حالت lean یک راهحل موقت است، نه یک پیشفرض. این حالت وجود دارد چون بعضی stackهای محلی برای رفتار درست به سطح ابزار کوچکتری نیاز دارند؛ مدلهای میزبانیشده و سامانههای محلی با منابع کافی چنین نیازی ندارند.
حالت lean همچنین جایگزین tools.profile، tools.allow/tools.deny یا راه فرار compat.supportsTools: false مدل نمیشود. اگر برای یک agent مشخص به سطح ابزار دائمی محدودتری نیاز دارید، آن کنترلهای پایدار را به پرچم آزمایشی ترجیح دهید.
فعالسازی
{
agents: {
defaults: {
experimental: {
localModelLean: true,
},
},
},
}
پس از تغییر پرچم، Gateway را راهاندازی مجدد کنید، سپس فهرست ابزارهای کوتاهشده را با این دستور تأیید کنید:
openclaw status --deep
خروجی وضعیت عمیق، ابزارهای فعال agent را فهرست میکند؛ وقتی حالت lean فعال است، browser، cron و message نباید وجود داشته باشند.
آزمایشی به معنی پنهان نیست
اگر یک ویژگی آزمایشی است، OpenClaw باید این موضوع را در اسناد و در خود مسیر پیکربندی بهروشنی بگوید. کاری که نباید انجام دهد این است که رفتار پیشنمایش را درون یک کنترل پیشفرض با ظاهر پایدار پنهان کند و وانمود کند که این عادی است. این همان راهی است که سطحهای پیکربندی را آشفته میکند.