---
read_when:
    - تازه‌وارد هستید و یک راهنمای «روی چه چیزی کلیک کنم/چه چیزی را اجرا کنم» می‌خواهید
    - مشکلی پیش آمده و می‌خواهید سریع‌ترین راه را برای رفع آن پیدا کنید
summary: 'مرکز راهنما: رفع مشکلات رایج، بررسی سلامت نصب، و این‌که وقتی چیزی از کار می‌افتد کجا را بررسی کنید'
title: راهنما
x-i18n:
    generated_at: "2026-05-06T09:22:23Z"
    model: gpt-5.5
    provider: openai
    source_hash: 118e8ad2207d32739d3da7d0097604dfad8e7780843841f4f84a44cd77eb8736
    source_path: help/index.md
    workflow: 16
---

مسیر سریع «خارج شدن از بن‌بست» برای رایج‌ترین مشکلات:

- [عیب‌یابی](/fa/help/troubleshooting) - درخت تصمیم بر اساس نشانه
- [اشکال‌زدایی](/fa/help/debugging) - حالت پایش، جریان‌های خام، نمایه توسعه
- [بررسی سلامت نصب](/fa/install/node#troubleshooting) - بررسی‌های Node / npm / PATH
- [عیب‌یابی Gateway](/fa/gateway/troubleshooting) - مشکلات ویژه Gateway
- [دکتر](/fa/gateway/doctor) - تعمیر خودکار + بسته تشخیصی

## پرسش‌های متداول

- [پرسش‌های متداول](/fa/help/faq) - مفاهیم روزمره و پرسش‌های عملیاتی
- [پرسش‌های متداول اجرای نخست](/fa/help/faq-first-run) - نصب، راه‌اندازی اولیه، احراز هویت، اشتراک‌ها، خرابی‌های اولیه
- [پرسش‌های متداول مدل‌ها](/fa/help/faq-models) - انتخاب مدل، failover، نمایه‌های احراز هویت

## تشخیص‌ها

- [متغیرهای محیطی](/fa/help/environment) - OpenClaw متغیرهای محیطی را از کجا بارگذاری می‌کند و ترتیب تقدم آن‌ها
- [پرچم‌های تشخیص](/fa/diagnostics/flags) - تشخیص‌های زمان اجرا و حالت‌های پرجزئیات
- [خرابی Node + tsx](/fa/debug/node-issue) - سناریوهای مشخص خرابی زمان اجرای Node / tsx

## آزمایش

- [آزمایش](/fa/help/testing) - مجموعه‌های آزمایشی و اجراکننده‌های Docker
- [آزمایش‌های به‌روزرسانی و Plugin](/fa/help/testing-updates-plugins) - به‌روزرسانی بسته، مهاجرت، و اعتبارسنجی نصب Plugin
- [آزمایش‌های زنده](/fa/help/testing-live) - smokeهای provider و CLI که شبکه را درگیر می‌کنند

## جامعه و فراداده

- [روایت OpenClaw](/fa/start/lore) - داستان
- [هاب‌های مستندات](/fa/start/hubs) - این مستندات چگونه سازمان‌دهی شده‌اند
- [فهرست مستندات](/fa/start/docs-directory) - نقشه کامل فایل‌ها