OpenClaw'ı CometAPI ile kullanın

Bağlanmak için bu kılavuzu kullanın OpenClaw’ı CometAPI’ye bağlayın. Seçin ilk yapılandırma için tek bir API biçimi ve model ID’si.

OpenClaw v2026.8.1, OpenClaw 2.0 olarak da markalanmıştır. Paket bir 2.x sürüm numarası kullanmaz. Şuraya bakın: OpenClaw 2.0 duyurusu ve v2026.8.1 sürüm notları.

Resmî OpenClaw başvuruları:

Ön koşullar

Node.js 22.22.3+, 24.15+ veya 25.9+. Node 26 önerilir. Node 23 desteklenmez.
Şuradan alınmış etkin bir API anahtarına sahip bir CometAPI hesabı: kontrol paneli.
Şuradan bir model ID’si: CometAPI Models sayfası.

Kurulum ve yükseltmeler

İlk kurulum
Bir kurulumu yükseltme

Resmî yükleyici, başlangıç kurulumunu başlatmadan CLI’ı yükleyebilir. Bu, model yapılandırmasını ayrı bir adım olarak tutar.

macOS / Linux / WSL2
Windows PowerShell

Aşağıdaki komut resmî yükleyiciyi çalıştırır:

curl -fsSL https://openclaw.ai/install.sh \
  | bash -s -- --no-onboard

Aşağıdaki komut resmî PowerShell yükleyicisini çalıştırır:

& ([scriptblock]::Create(
  (iwr -useb https://openclaw.ai/install.ps1)
)) -NoOnboard

Node.js ve npm’i kendiniz yönetiyorsanız, npm 11.16+ ve npm 12 şu --allow-scripts seçeneğini kabul eder. Aşağıdaki komut, OpenClaw’ı başlangıç kurulumunu başlatmadan yükler:

npm install -g openclaw@latest --allow-scripts=openclaw

npm 11.15 ve önceki sürümlerinde, bu npm --allow-scripts=openclaw seçeneği tanımadığından bunu atlayın.Yüklü CLI’ın bu kılavuz için gereken minimum sürümü karşıladığını doğrulayın:

openclaw --version

Şuraya devam edin: CometAPI’yi yapılandırın. İlk olarak yalın onboarding’i çalıştırmayın; çünkü yönlendirmeli akış her özel API bağdaştırıcısını göstermez.

Önemli bir güncellemeden önce yedek oluşturun ve doğrulayın. Arşiv API anahtarları, kanal durumu ve kimlik doğrulama verileri içerebilir; bu nedenle onu OpenClaw durum dizinini koruduğunuz şekilde koruyun.Aşağıdaki komutlar yedeği oluşturur ve OpenClaw’ı günceller:

mkdir -p ~/Backups/openclaw
openclaw backup create --output ~/Backups/openclaw --verify
openclaw update

Güncellemeden sonra, desteklenen geçişleri onarın ve Gateway sağlığını kontrol edin:

openclaw doctor --fix
openclaw gateway restart
openclaw health

Bir güncelleme yapılandırılmış model rotasını korur. Onboarding’i tekrarlamayın model sağlayıcısını veya kimlik doğrulamasını değiştirmek istemediğiniz sürece.

CometAPI’yi yapılandırma

Klasik ilk kurulumu kullanma

Klasik ilk kurulum, Chat Completions, Responses ve Anthropic Messages için tercih edilen ilk yükleme yoludur. Aşağıdaki komut klasik ilk kurulumu açar ve arka plan hizmetini yükler:

openclaw onboard --classic --install-daemon

Şurada: Model/Auth, şunu seçin: Custom Provider. Ardından bu uyumluluk seçeneklerinden biri için değerleri girin: bu uyumluluk seçenekleri:

API biçimi	Sağlayıcı kimliği	Uyumluluk seçeneği	Temel URL
Chat Completions	`cometapi-openai`	OpenAI uyumlu	`https://api.cometapi.com/v1`
Responses	`cometapi-openai-responses`	OpenAI Responses uyumlu	`https://api.cometapi.com/v1`
Anthropic Messages	`cometapi-claude`	Anthropic uyumlu	`https://api.cometapi.com`

İstendiğinde eşleşen sağlayıcı kimliğini, your-model-id değerini ve CometAPI API anahtarınızı girin. Terminal sihirbazı API anahtarı girişini maskeler. Klasik Custom Provider menüsünde Google Generative AI adaptörü yer almaz. Bu adaptörü kullanmak için Yapılandırma komutlarıyla bir sağlayıcı yapılandırma, işlemini tamamlayın, birincil modeli ayarlayın ve ardından klasik ilk kurulumu çalıştırın. Sihirbaz bu seçeneği sunduğunda Mevcut model yapılandırmasını koru seçeneğini belirleyin.

Yapılandırma komutlarıyla bir sağlayıcı yapılandırma

Google adaptörü veya denetimli yapılandırma değişiklikleri için bu yolu kullanın. OpenClaw JSON5’i destekler; bu nedenle openclaw.json dosyasını katı bir JSON aracıyla ayrıştırıp yeniden yazmayın. katı bir JSON aracıyla.

OpenClaw’ın yerel yapılandırma yazıcısı JSON5’i doğrular, ancak dosyayı yazarken JSON biçimine dönüştürür. Mevcut yorumlar, sondaki virgüller ve biçimlendirme kaldırılabilir. Bu ayrıntılar sizin için önemliyse, bir yama uygulamadan önce doğrulanmış bir yedek oluşturun. sizin için önemliyse.

Önce etkin yapılandırma yolunu yazdırın ve içeriğini doğrulayın:

openclaw config file
openclaw config validate

OpenClaw, sağlayıcı API anahtarlarını işlem ortamından veya genel durum .env dosyasından okur. Sağlayıcı API anahtarları için bir çalışma alanı .env dosyasına güvenmez. anahtarlarına güvenmez. Genel dosya ~/.openclaw/.env dosyasıdır veya $OPENCLAW_STATE_DIR/.env OPENCLAW_STATE_DIR ayarlandığında bu dosyadır. Klasik ilk kurulum API anahtarını depoladıysa aşağıdaki adımı atlayın. Aksi halde, API anahtarını görüntülemeden depolamak için işletim sisteminize uygun sekmeyi kullanın.

macOS / Linux / WSL2
Windows PowerShell

Aşağıdaki komutlar COMETAPI_KEY değerini atomik olarak günceller ve boş bir değeri reddeder:

state_dir="${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"
install -d -m 700 "$state_dir"
read -rsp "CometAPI API key: " COMETAPI_KEY
printf '\n'
if [ -z "$COMETAPI_KEY" ]; then
  echo "The CometAPI API key cannot be empty." >&2
  unset COMETAPI_KEY
  exit 1
fi
umask 077
env_file="$state_dir/.env"
temp_file="$(mktemp "${env_file}.XXXXXX")"
if [ -f "$env_file" ]; then
  awk -F= '$1 != "COMETAPI_KEY"' "$env_file" > "$temp_file"
fi
printf 'COMETAPI_KEY=%s\n' "$COMETAPI_KEY" >> "$temp_file"
chmod 600 "$temp_file"
mv "$temp_file" "$env_file"
unset COMETAPI_KEY temp_file env_file state_dir

Aşağıdaki komutlar COMETAPI_KEY değerini görüntülemeden günceller:

$stateDir = if ($env:OPENCLAW_STATE_DIR) {
  $env:OPENCLAW_STATE_DIR
} else {
  Join-Path $HOME ".openclaw"
}
New-Item -ItemType Directory -Force -Path $stateDir | Out-Null
$secureKey = Read-Host "CometAPI API key" -AsSecureString
$plainKey = [Net.NetworkCredential]::new("", $secureKey).Password
if ([string]::IsNullOrWhiteSpace($plainKey)) {
  throw "The CometAPI API key cannot be empty."
}
$envFile = Join-Path $stateDir ".env"
$lines = @()
if (Test-Path $envFile) {
  $lines = @(Get-Content $envFile | Where-Object {
    $_ -notmatch '^COMETAPI_KEY='
  })
}
$lines += "COMETAPI_KEY=$plainKey"
$tempFile = Join-Path $stateDir ".$([guid]::NewGuid()).tmp"
[IO.File]::WriteAllLines($tempFile, $lines)
Move-Item -Force $tempFile $envFile
$plainKey = $null
$secureKey = $null

Bir sağlayıcı eklemeden önce hedef yolunu inceleyin. Aşağıdaki komutta yer alan sağlayıcı kimliğini seçtiğiniz sekmedeki kimlikle değiştirin:

openclaw config get models.providers.cometapi-openai --json

Komut yapılandırılmış bir sağlayıcı döndürürse örneği uygulamadan önce durun. config patch nesneleri birleştirir, ancak dizileri değiştirir. Yeni modeli diziyi yazmadan önce sağlayıcının model dizisine birleştirin. Bu, model meta verilerini, özel üst bilgileri ve diğer sağlayıcı ayarlarını korur. Bir API biçimi seçin. Her yama ortam destekli bir SecretRef kullanır, yalnızca hedef yapılandırma yollarını değiştirir ve diğer yapılandırma bölümlerini bozulmadan tutar.

Bir model kimliği her API adaptörüyle otomatik olarak uyumlu değildir. Tam CometAPI modelinin ve rotanın desteklediği bir adaptörü seçin, ardından bu sağlayıcı/model/adaptör birleşimini canlı bir istekle doğrulayın. Aşağıdaki your-model-id değer, evrensel bir uyumluluk iddiası değil, bir yapılandırma yer tutucusudur.

Chat Completions
Responses
Anthropic Messages
Google Generative AI

Sağlayıcı kimliği: cometapi-openai
OpenClaw adaptörü: openai-completions
Temel URL: https://api.cometapi.com/v1
Birincil model başvurusu: cometapi-openai/your-model-id

Bu sağlayıcı yamasıyla cometapi.patch.json5 oluşturun:

{
  models: {
    mode: "merge",
    providers: {
      "cometapi-openai": {
        baseUrl: "https://api.cometapi.com/v1",
        apiKey: {
          source: "env",
          provider: "default",
          id: "COMETAPI_KEY",
        },
        api: "openai-completions",
        models: [
          {
            id: "your-model-id",
            name: "CometAPI model",
            input: ["text"],
          },
        ],
      },
    },
  },
}

OpenClaw yapılandırmayı yazmadan önce yamayı doğrulayın:

openclaw config patch --file ./cometapi.patch.json5 --dry-run

Doğrulama başarılı olursa aynı yamayı uygulayın:

openclaw config patch --file ./cometapi.patch.json5

Birincil model yapılandırılmamışsa bu modeli varsayılan olarak ayarlayın:

openclaw models set cometapi-openai/your-model-id

Sağlayıcı yapılandırmasını doğrulayın ve minimal bir model isteği gönderin:

openclaw models list --provider cometapi-openai
openclaw models status --probe \
  --probe-provider cometapi-openai
openclaw agent exec \
  "Reply exactly with: OPENCLAW_OK" \
  --model cometapi-openai/your-model-id \
  --thinking off \
  --json

Etkin OpenClaw sohbet oturumunu değiştirmek için şu sohbet komutunu çalıştırın:

/model cometapi-openai/your-model-id

Sağlayıcı kimliği: cometapi-openai-responses
OpenClaw adaptörü: openai-responses
Temel URL: https://api.cometapi.com/v1
Birincil model başvurusu: cometapi-openai-responses/your-model-id

Bu sağlayıcı yamasıyla cometapi.patch.json5 oluşturun:

{
  models: {
    mode: "merge",
    providers: {
      "cometapi-openai-responses": {
        baseUrl: "https://api.cometapi.com/v1",
        apiKey: {
          source: "env",
          provider: "default",
          id: "COMETAPI_KEY",
        },
        api: "openai-responses",
        models: [
          {
            id: "your-model-id",
            name: "CometAPI model",
            input: ["text"],
          },
        ],
      },
    },
  },
}

OpenClaw yapılandırmayı yazmadan önce yamayı doğrulayın:

openclaw config patch --file ./cometapi.patch.json5 --dry-run

Doğrulama başarılı olursa aynı yamayı uygulayın:

openclaw config patch --file ./cometapi.patch.json5

Birincil model yapılandırılmamışsa bu modeli varsayılan olarak ayarlayın:

openclaw models set cometapi-openai-responses/your-model-id

Sağlayıcı yapılandırmasını doğrulayın ve minimal bir model isteği gönderin:

openclaw models list --provider cometapi-openai-responses
openclaw models status --probe \
  --probe-provider cometapi-openai-responses
openclaw agent exec \
  "Reply exactly with: OPENCLAW_OK" \
  --model cometapi-openai-responses/your-model-id \
  --thinking off \
  --json

Etkin OpenClaw sohbet oturumunu değiştirmek için şu sohbet komutunu çalıştırın:

/model cometapi-openai-responses/your-model-id

Sağlayıcı kimliği: cometapi-claude
OpenClaw adaptörü: anthropic-messages
Temel URL: https://api.cometapi.com
Birincil model başvurusu: cometapi-claude/your-model-id

Bu sağlayıcı yamasıyla cometapi.patch.json5 oluşturun:

{
  models: {
    mode: "merge",
    providers: {
      "cometapi-claude": {
        baseUrl: "https://api.cometapi.com",
        apiKey: {
          source: "env",
          provider: "default",
          id: "COMETAPI_KEY",
        },
        api: "anthropic-messages",
        models: [
          {
            id: "your-model-id",
            name: "CometAPI model",
            input: ["text"],
          },
        ],
      },
    },
  },
}

OpenClaw yapılandırmayı yazmadan önce yamayı doğrulayın:

openclaw config patch --file ./cometapi.patch.json5 --dry-run

Doğrulama başarılı olursa aynı yamayı uygulayın:

openclaw config patch --file ./cometapi.patch.json5

Birincil model yapılandırılmamışsa bu modeli varsayılan olarak ayarlayın:

openclaw models set cometapi-claude/your-model-id

Sağlayıcı yapılandırmasını doğrulayın ve minimal bir model isteği gönderin:

openclaw models list --provider cometapi-claude
openclaw models status --probe \
  --probe-provider cometapi-claude
openclaw agent exec \
  "Reply exactly with: OPENCLAW_OK" \
  --model cometapi-claude/your-model-id \
  --thinking off \
  --json

Etkin OpenClaw sohbet oturumunu değiştirmek için şu sohbet komutunu çalıştırın:

/model cometapi-claude/your-model-id

Sağlayıcı kimliği: cometapi-google
OpenClaw adaptörü: google-generative-ai
Temel URL: https://api.cometapi.com/v1beta
Birincil model başvurusu: cometapi-google/your-model-id

Bu sağlayıcı yamasıyla cometapi.patch.json5 oluşturun:

{
  models: {
    mode: "merge",
    providers: {
      "cometapi-google": {
        baseUrl: "https://api.cometapi.com/v1beta",
        apiKey: {
          source: "env",
          provider: "default",
          id: "COMETAPI_KEY",
        },
        api: "google-generative-ai",
        models: [
          {
            id: "your-model-id",
            name: "CometAPI model",
            input: ["text"],
          },
        ],
      },
    },
  },
}

OpenClaw yapılandırmayı yazmadan önce yamayı doğrulayın:

openclaw config patch --file ./cometapi.patch.json5 --dry-run

Doğrulama başarılı olursa aynı yamayı uygulayın:

openclaw config patch --file ./cometapi.patch.json5

Birincil model yapılandırılmamışsa bu modeli varsayılan olarak ayarlayın:

openclaw models set cometapi-google/your-model-id

Sağlayıcı yapılandırmasını doğrulayın ve minimal bir model isteği gönderin:

openclaw models list --provider cometapi-google
openclaw models status --probe \
  --probe-provider cometapi-google
openclaw agent exec \
  "Reply exactly with: OPENCLAW_OK" \
  --model cometapi-google/your-model-id \
  --thinking off \
  --json

Etkin OpenClaw sohbet oturumunu değiştirmek için şu sohbet komutunu çalıştırın:

/model cometapi-google/your-model-id

Bir yapılandırma zaten cometapi-gemini sağlayıcı kimliğini kullanıyorsa bu kimliği koruyun ve model başvurularında ve komutlarda kullanın. Bu kılavuza uyması için kimliği yeniden adlandırmayın veya yinelenen bir sağlayıcı oluşturmayın.

Dört CometAPI sağlayıcı biçimiyle OpenClaw 2026.8.1 model listesi

Yeni bir sağlayıcı için openclaw config set, aynı şemayı ve SecretRef denetimlerini sağlar. Yazmadan önce --strict-json, --merge ve --dry-run kullanın. Aşağıdaki alternatif Chat Completions sağlayıcısını önizler:

openclaw config set models.providers.cometapi-openai \
  '{
    "baseUrl": "https://api.cometapi.com/v1",
    "apiKey": {
      "source": "env",
      "provider": "default",
      "id": "COMETAPI_KEY"
    },
    "api": "openai-completions",
    "models": [
      {
        "id": "your-model-id",
        "name": "CometAPI model",
        "input": ["text"]
      }
    ]
  }' \
  --strict-json --merge --dry-run

Kuru çalıştırma başarılı olursa kaydetmek için komutu --dry-run olmadan tekrarlayın. Şunu yapılandırılmış bir sağlayıcıya uygulamayın. models dizisi, yazma işleminden önce sağlayıcının tam birleştirilmiş model listesini içermelidir.

Model meta verilerini anlama

Minimal yamalar yalnızca metin içeren bir model tanımlar. İsteğe bağlı meta verileri yalnızca modelin özelliklerini doğruladığınızda ekleyin:

Alan	Etkisi
`input`	Kabul edilen giriş modalitelerini tanımlar. `["text", "image"]` değerini yalnızca model yerel görüntü girişini kabul ettiğinde kullanın.
`contextWindow`	Modelin yerel Context Window kapasitesini kaydeder.
`contextTokens`	Değiştirmeden etkin giriş bütçesini sınırlar `contextWindow`.
`maxTokens`	OpenClaw’ın modelden istediği çıktı Token sayısını sınırlar.

Yanlış değerler desteklenen girişleri gizleyebilir, kullanılabilir bağlamı olduğundan fazla gösterebilir veya desteklenmeyen bir çıktı boyutu isteyebilir. Yeniden kullanılabilir örneklerde your-model-id değerini koruyun, ve CometAPI Models sayfasını bir model kimliği seçmek için kullanın.

Kurulumun tamamını doğrulayın

config veya genel .env dosyasındaki değişikliklerden sonra Gateway’i yeniden başlatın:

openclaw gateway restart

Ardından config’i ve Gateway durumunu doğrulayın:

openclaw config validate
openclaw doctor
openclaw health

Seçili API-format sekmesindeki sağlayıcıya özgü komutları çalıştırın. Bir model listesi veya durum kontrolü yalnızca yapılandırmayı doğrular. openclaw agent exec komutu gerçek bir model isteği gönderir. Çözümlenmemiş bir kimlik doğrulama, adapter veya model hatası olmadan OPENCLAW_OK döndürdüğünü doğrulayın . OpenClaw bir isteği yeniden denerse, son işaretçiyi tek denemelik başarı olarak değerlendirmek yerine her denemeyi kaydedin ve inceleyin .

Sorun giderme

API anahtarı eksik

COMETAPI_KEY öğesinin işlem ortamında veya genel durum .env dosyasında bulunduğunu doğrulayın. Değeri terminal çıktısına yazdırmayın.Güvenilir anahtar kaynağını düzelttikten sonra Gateway’i yeniden başlatın ve denetleyin:

openclaw gateway restart
openclaw health

Bir sağlayıcı kimliği farklı ayarlara sahip

Farklı baseUrl, api, özel üstbilgilere veya model meta verilerine sahip bir sağlayıcının üzerine yazmayın. Önce hedef sağlayıcıyı inceleyin:

openclaw config get models.providers.cometapi-openai --json
openclaw config validate

Her iki yapılandırma da amaçlıysa farklı bir sağlayıcı kimliği kullanın. Eğer fark yanlışlıksa, hedef sağlayıcıyı değiştirmeden önce doğrulanmış bir yedek oluşturun .

Bir güncelleme tamamlanmadı

Kurulumu onarmadan önce güncelleme durumunu inceleyin:

openclaw update status --json
openclaw update repair
openclaw doctor --fix
openclaw health

Bu komutlar durum dizinini korur.

Kod geri alma işlemi gerekiyor

Durum dizinini korurken bilinen bir paket sürümünü yeniden yükleyin. Önce işlemi önizleyin:

openclaw update --tag 2026.8.1 --dry-run

Önizleme doğruysa, aynı işlemi --dry-run olmadan çalıştırın:

openclaw update --tag 2026.8.1
openclaw doctor --fix
openclaw health

Durum yedeğini yalnızca yüklü kod durumu okuyamıyorsa geri yükleyin. Durum geri yüklemesi, yedekten sonra oluşturulan oturumları ve yapılandırma değişikliklerini atabilir.

Genel Bakış

AI kodlama ajanları

AI ajanları

AI sohbet istemcileri

Çeviri ve dil

Otomasyon platformları

Gözlemlenebilirlik ve değerlendirme

AI framework'leri

Ön koşullar

Kurulum ve yükseltmeler

CometAPI’yi yapılandırma

Klasik ilk kurulumu kullanma

Yapılandırma komutlarıyla bir sağlayıcı yapılandırma

Model meta verilerini anlama

Kurulumun tamamını doğrulayın

Sorun giderme

​Ön koşullar

​Kurulum ve yükseltmeler

​CometAPI’yi yapılandırma

​Klasik ilk kurulumu kullanma

​Yapılandırma komutlarıyla bir sağlayıcı yapılandırma

​Model meta verilerini anlama

​Kurulumun tamamını doğrulayın

​Sorun giderme

Ön koşullar

Kurulum ve yükseltmeler

CometAPI’yi yapılandırma

Klasik ilk kurulumu kullanma

Yapılandırma komutlarıyla bir sağlayıcı yapılandırma

Model meta verilerini anlama

Kurulumun tamamını doğrulayın

Sorun giderme