---
read_when:
    - اجرای اسکریپت‌ها از مخزن
    - افزودن یا تغییر اسکریپت‌ها در ./scripts
summary: 'اسکریپت‌های مخزن: هدف، دامنه و نکات ایمنی'
title: اسکریپت‌ها
x-i18n:
    generated_at: "2026-05-06T09:22:40Z"
    model: gpt-5.5
    provider: openai
    source_hash: 01f2e064891940959acf23c003d7e842386f67ac6c869d0677b802738ac04bdf
    source_path: help/scripts.md
    workflow: 16
---

دایرکتوری `scripts/` شامل اسکریپت‌های کمکی برای گردش‌کارهای محلی و وظایف عملیاتی است.
وقتی یک وظیفه به‌وضوح به یک اسکریپت مربوط است از آن‌ها استفاده کنید؛ در غیر این صورت CLI را ترجیح دهید.

## قراردادها

- اسکریپت‌ها **اختیاری** هستند، مگر اینکه در مستندات یا چک‌لیست‌های انتشار به آن‌ها ارجاع شده باشد.
- وقتی سطح‌های CLI وجود دارند، آن‌ها را ترجیح دهید (مثال: پایش احراز هویت از `openclaw models status --check` استفاده می‌کند).
- فرض کنید اسکریپت‌ها به میزبان وابسته‌اند؛ پیش از اجرا روی یک ماشین جدید، آن‌ها را بخوانید.

## اسکریپت‌های پایش احراز هویت

پایش احراز هویت در [احراز هویت](/fa/gateway/authentication) پوشش داده شده است. اسکریپت‌های زیر `scripts/` افزونه‌های اختیاری برای گردش‌کارهای تلفنی systemd/Termux هستند.

## راهنمای خواندن GitHub

وقتی می‌خواهید `gh` برای فراخوانی‌های خواندنی محدود به مخزن از توکن نصب GitHub App استفاده کند، در حالی که `gh` معمولی برای اقدام‌های نوشتنی روی ورود شخصی شما باقی بماند، از `scripts/gh-read` استفاده کنید.

env ضروری:

- `OPENCLAW_GH_READ_APP_ID`
- `OPENCLAW_GH_READ_PRIVATE_KEY_FILE`

env اختیاری:

- `OPENCLAW_GH_READ_INSTALLATION_ID` وقتی می‌خواهید جست‌وجوی نصب مبتنی بر مخزن را رد کنید
- `OPENCLAW_GH_READ_PERMISSIONS` به‌عنوان بازنویسی جداشده با ویرگول برای زیرمجموعه مجوزهای خواندنی که باید درخواست شود

ترتیب تشخیص مخزن:

- `gh ... -R owner/repo`
- `GH_REPO`
- `git remote origin`

مثال‌ها:

- `scripts/gh-read pr view 123`
- `scripts/gh-read run list -R openclaw/openclaw`
- `scripts/gh-read api repos/openclaw/openclaw/pulls/123`

## هنگام افزودن اسکریپت‌ها

- اسکریپت‌ها را متمرکز و مستند نگه دارید.
- یک ورودی کوتاه در مستند مرتبط اضافه کنید (یا اگر وجود ندارد، یکی ایجاد کنید).

## مرتبط

- [آزمایش](/fa/help/testing)
- [آزمایش زنده](/fa/help/testing-live)