English
Türkçe
FrançaisGereksinimler
Bir Noxery API anahtarı ve GET /v1/models yanıtında görünen aktif bir model gerekir. Anahtarın yoksa Hızlı başlangıç adımlarını izle; anahtarı API Anahtarları sayfasından üret. Anahtarı yalnızca agent'ın çalıştığı makinede, environment variable olarak sakla.
export NOXERY_API_KEY="nox-YOUR_KEY"
export NOXERY_BASE_URL="https://api.noxery.net/v1"Yapılandırma
OpenClaw sürümünde OpenAI-compatible provider seçeneğini aç. Alan adları sürüme göre değişebildiği için temel değerler şunlardır:
OPENAI_API_KEY=nox-YOUR_KEY
OPENAI_BASE_URL=https://api.noxery.net/v1
OPENAI_MODEL=deepseek-v4-pro-202606Agent ayarlarında farklı isimler kullanılıyorsa karşılıkları api_key, base_url ve model olarak gir. Bu agent'ın kendi güncel config dokümanında OpenAI-compatible endpoint desteği yoksa Noxery'ye doğrudan bağlanamaz.
Model seçimi
Model adını tahmin etme; katalogdan al. Agent yapılandırmasında paneldeki görünen adı değil, API'den dönen id alanını kullan.
curl https://api.noxery.net/v1/models \
-H "Authorization: Bearer $NOXERY_API_KEY"Örnek model: deepseek-v4-pro-202606. Model listesi ve limitler zamanla değişebilir.
Uzun sohbetler ve araç çağrıları
Her konuşma için sabit ve benzersiz bir session ID gönder. Bu, bağlantılı isteklerin upstream tarafında izlenmesini ve loglanmasını sağlar.
x-opencode-session: project-123-session-01
# Alternatif: x-codex-session veya x-conversation-idUzun geçmişi her turda sınırsız büyütme. Sistem context penceresine sığması için eski mesajları sıkıştırabilir; araç çağrısı ile araç sonucunu birlikte gönder. Streaming kullanırken SSE bağlantısını kesmeden parçaları sırayla birleştir.
Tool calling kullanan agent'larda tools, tool_choice ve gerekli tool sonuçlarını aynı istekte tut. Eksik bir tool çifti 400 hatasına veya tekrarlanan agent turuna yol açabilir.
Sorun giderme
Authorization: Bearer nox-... olduğundan ve environment variable'ın agent sürecinde tanımlı olduğundan emin ol.GET /v1/models ile güncel ID'yi al. Modelin paneldeki adı ile API ID'si aynı olmak zorunda değildir.retry_after süresi dolmadan tekrar deneme; kota dolduysa pencere bitmeden tekrar denemek sorunu çözmez.~/.codex/config.toml dosyanıza modelin gerçek penceresini ekleyin: model_context_window = 1050000 ve model_auto_compact_token_limit = 900000 (gpt-6-astra, gpt-6-sol, gpt-5.6-sol, gpt-5.5 gibi 1.05M modeller için). 400k modellerde (örn. gpt-5.3-codex) model_context_window = 400000 / model_auto_compact_token_limit = 340000 kullanın. Ayrıca çok uzayan thread'lerde yeni bir thread başlatın; büyük dosya/komut çıktılarını kısa tutun.