عیب‌یابی

مشکلات متداول و راه‌حل‌ها.

نصب

«bun: command not found» بعد از install

اسکریپت نصب Bun را به ~/.bun/bin اضافه می‌کنه ولی PATH شل فعلی هنوز refresh نشده.

export PATH="$HOME/.bun/bin:$PATH"

# دائمی توی ~/.zshrc یا ~/.bashrc:
echo 'export PATH="$HOME/.bun/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

«401 Unauthorized» روی @airachat/airacode

میرور Runflare چند ثانیه کِشینگ داره. اول مستقیم تست کن:

curl -fsSL https://airachat.ir/install.sh | bash -s -- --direct

ورود

کد پیامک نمی‌رسه

  • چک کن شماره با فرمت 09xxxxxxxxx یا +989xxxxxxxxx وارد شده.
  • سرویس‌دهنده‌های Bxxx ممکنه پیامک سرویسی فیلتر کنن — یک شمارهٔ دیگه امتحان کن.
  • ۵ تلاش در ساعت محدودیت داره. صبر کن یا از AIRA_API_KEY headless استفاده کن.

مرورگر باز نمی‌شه (SSH/WSL/Docker)

روی محیط بدون مرورگر، نمی‌تونی aira login رو اجرا کنی. به‌جاش از داشبورد آیراچت توکن بساز و env ست کن:

export AIRA_API_KEY=ey...

«invalid_grant» موقع refresh

refresh token منقضی شده (پس از ۳۰ روز عدم فعالیت). دوباره login کن.

Gateway / Network

«502 Bad Gateway» هر بار

upstream مدل از Gateway در دسترس نیست. یا تحریم موقت یا routing.

  • وضعیت رو از airachat.ir/status چک کن.
  • برای bypass موقت: ANTHROPIC_BASE_URL=https://api.anthropic.com با VPN.

«model_not_allowed»

مدلی که می‌خوای داخل allowlist Gateway نیست:

# لیست مدل‌های مجاز:
curl -H "Authorization: Bearer $TOKEN" \
     https://app.airachat.ir/api/airacode/gateway/v1/models

# اگه ops هستی و می‌خوای اضافه کنی:
# روی سرور:
export AIRACODE_GW_EXTRA_MODELS=new-provider/new-model

حافظه

حافظهٔ راه‌دور پاسخ نمی‌ده

  • چک کن AIRA_REMOTE_MEMORY=1 ست شده.
  • توکنت expire نشده باشه: aira whoami.
  • fallback خودکار به فایل‌سیستم در صورت خطا فعاله — اگه CLI کار می‌کنه، احتمالاً سرور موقتاً down شده.

حافظه‌ها بین دستگاه‌ها sync نمی‌شن

فقط حافظه‌هایی sync می‌شن که پس از فعال شدن AIRA_REMOTE_MEMORY ایجاد شدن. برای انتقال حافظه‌های قبلی، از داشبورد آیراچت → Settings → Import legacy memories استفاده کن (به‌زودی).

نسخه و آپدیت

auto-updater پیش‌فرض خاموشه. آپدیت دستی:

bun update -g @airachat/airacode --registry https://npm.runflare.com
# یا
curl -fsSL https://airachat.ir/install.sh | bash

گزارش باگ

← قبلی
سرورهای MCP