OpenClaw'da Apidog CLI Nasıl Kullanılır

OpenClaw bir döngü içinde çalışır: çalışma alanınızı okur, yürütme aracıyla shell komutlarını çalıştırır, çıktıyı inceler ve sonraki adıma karar verir. API testleriniz bu döngünün dışında kalıyorsa yalnızca biri GUI'de manuel olarak başlattığında çalışır. Apidog CLI ile test senaryolarını terminalden çalıştırabilir, OpenClaw'un çıkış koduna göre düzeltme yapmasını sağlayabilirsiniz.

Apidog'u bugün deneyin

Çözüm, çalışma alanınızdaki tek bir yapılandırma bloğudur. apidog-cli, Apidog'da oluşturduğunuz test senaryolarını terminalden çalıştıran npm paketidir. OpenClaw bu komutu öğrendiğinde birim testlerinde olduğu gibi davranabilir: komutu çalıştırır, çıkış kodunu okur ve sonuç başarısızsa kodu düzeltir.

Bu kılavuz OpenClaw'a özgü kurulumu kapsar:

1. Apidog kurallarını AGENTS.md dosyasına eklemek
2. Doğru apidog run komutunu Apidog'dan almak
3. OpenClaw yürütme izinlerini yapılandırmak
4. CLI çıktısı ve çıkış kodunu doğrulamak

Bu makale, apidog --version komutunun çalıştığını ve apidog login ile hesabınıza giriş yaptığınızı varsayar. Henüz kurulum yapmadıysanız AI kodlama aracısıyla Apidog CLI yükleme kılavuzunu izleyin.

Bu Hangi OpenClaw Hakkında?

OpenClaw, kendi makinenizde çalışan açık kaynaklı ve yerel öncelikli bir yapay zeka aracıdır. Çalışma alanındaki dosyaları düzenleyebilir ve gerçek shell komutları çalıştırabilir. Kod tamamlama eklentisi veya barındırılan bir sohbet robotu değildir.

openclaw komutunu yerel olarak çalıştırdıysanız, dosyaları düzenlediğini ve komutları yürüttüğünü gördüyseniz doğru yerdesiniz. Daha geniş kurulum bağlamı için şunlara bakın:

• OpenClaw geliştirme iş akışı otomasyonu
• Güvenli OpenClaw kurulumu

Buradaki kritik nokta, OpenClaw'un proje kurallarını çalışma alanı dosyalarından öğrenmesidir. Bu mekanizma sayesinde tek seferlik “testleri çalıştır” isteği kalıcı bir iş akışı kuralına dönüşür. Bunun için AGENTS.md kullanılır.

Adım 1: Apidog Kurallarını AGENTS.md'ye Ekleyin

OpenClaw, çalışma alanı dosyalarını sürekli talimatlar olarak okur ve bunları aracının bağlamına ekler. AGENTS.md, araca ne yapacağını ve bunu nasıl yapacağını söyleyen prosedürel kural dosyasıdır.

Bunu Claude Code'daki CLAUDE.md gibi düşünebilirsiniz. Varsayılan çalışma alanı ~/.openclaw/workspace dizinidir; ancak agents.list[].workspace ile aracıyı proje dizininize yönlendirebilirsiniz. OpenClaw ayrıca alt dizinlere özel kapsamlı AGENTS.md dosyalarını destekler. Ayrıntılar için OpenClaw AGENTS.md referansına bakın.

Projenizin etkin çalışma alanındaki AGENTS.md dosyasına şu bloğu ekleyin:

## Apidog ile API testi

- API testlerini çalıştırmak için Apidog CLI'yı kullanın: `apidog run -t <senaryo_id> -e <ortam_id> -r cli`.
- Çıkış kodu 0, her onaylamanın geçtiği anlamına gelir. Sıfır olmayan, bir şeyin başarısız olduğu anlamına gelir. Bunu geçme/kalma kapısı olarak kabul edin.
- Makine zaten `apidog login` ile kimliği doğrulanmıştır. Asla --access-token bayrağı eklemeyin ve bu dosyaya asla bir jeton koymayın.
- Bir bayrak tanıdık gelmiyorsa, tahmin etmek yerine `apidog run --help` komutunu çalıştırın.

Bu talimatı yalnızca sohbet içinde vermek yerine AGENTS.md dosyasına yazın. Sohbet oturumu sona erdiğinde bağlam kaybolabilir; AGENTS.md içindeki senaryo ve ortam kimlikleri ise sonraki OpenClaw çalıştırmalarında da kullanılabilir.

Adım 2: Komutu Apidog'dan Alın

Senaryo veya ortam kimliklerini elle tahmin etmeyin.

1. Apidog'da test senaryonuzu açın.
2. CI/CD sekmesine gidin.
3. Oluşturulan komutu kopyalayın.

Komut şu biçimde görünür:

apidog run -t 1234567 -e 890123 -r cli

Parametrelerin anlamı:

Parametre	Açıklama
-t	Test senaryosu kimliği
-e	Ortam kimliği
-r cli	Terminal çıktısı için CLI raporlayıcısı

Kopyaladığınız gerçek komutu AGENTS.md içindeki kurala yerleştirin. Böylece OpenClaw her zaman doğru senaryoyu doğru ortamda çalıştırır.

Daha fazla seçenek için:

• Eksiksiz Apidog CLI kılavuzu
• apidog run komut referansı

Adım 3: OpenClaw'un Testi Çalıştırmasını Sağlayın

AGENTS.md bloğu yerleştirildikten sonra OpenClaw'u projenizle başlatın. API'yi etkileyen bir değişiklik yapın veya doğrudan testi çalıştırmasını isteyin.

Örneğin:

Ödeme yanıtı işleyicisindeki değişikliği doğrula. Apidog senaryosunu çalıştır, başarısızsa raporu incele ve düzelt.

OpenClaw, AGENTS.md bağlamda olduğu için apidog run komutunu yürütme aracıyla çalıştırabilir.

Yürütme izinlerini ayarlayın

OpenClaw shell komutlarını izin modlarına göre çalıştırır:

• deny
• allowlist
• ask
• auto
• full

Bu modlar OpenClaw izin modları sayfasında belgelenir.

Kodlama iş akışları için auto genellikle uygun bir seçenektir:

• İzin verilen komutlar otomatik çalışır.
• Diğer komutlar çalışmadan önce incelenir.
• ask modunda OpenClaw, apidog run öncesinde sizden onay ister.
• Gerekirse yalnızca apidog komutunu izin listesine ekleyebilirsiniz.

Ayarı openclaw.json içindeki tools.exec altında yapın. Amaç, hazırlık ortamına karşı çalışan salt okunur API testlerinin gereksiz engeller olmadan yürütülmesidir.

Adım 4: Raporu OpenClaw İçinde Okuyun

-r cli raporlayıcısı terminale adım adım sonuç yazdırır:

• Çalıştırılan istekler
• Onaylamalar
• Başarısız olan kontroller
• Beklenen ve gerçek değerler

OpenClaw'un sonraki adımı belirlemesi için bu satır içi çıktı gereklidir. Bu nedenle komutta cli raporlayıcısını koruyun.

Tarayıcıda açılabilecek veya ekip arkadaşlarıyla paylaşılabilecek bir rapora ihtiyacınız varsa HTML raporlayıcıyı ekleyin:

apidog run -t 1234567 -e 890123 -r cli,html

html raporlayıcısı bağımsız raporu ./apidog-reports dizinine yazar. OpenClaw'un terminal çıktısını okuyabilmesi için cli seçeneğini yanında tutun.

JUnit ve diğer rapor formatları için Apidog CLI test raporları kılavuzuna bakın.

OpenClaw Kendi Döngüsünde Test Yapıyor

Asıl değer, OpenClaw'un siz her seferinde hatırlatmadan senaryoyu çalıştırabilmesidir.

Örneğin OpenClaw'un ödeme yanıtı oluşturan bir işleyiciyi değiştirdiğini düşünün. İş akışı şu hale gelir:

1. Kodu düzenler.
2. Apidog senaryosunu hazırlık ortamına karşı çalıştırır.
3. Çıkış kodunu kontrol eder.
4. Sonuç başarısızsa raporu okur.
5. Başarısız onaylamayı belirler: durum kodu, eksik alan veya yanlış değer.
6. Düzeltme yapar.
7. Testi yeniden çalıştırır.

Bu yaklaşım, API testlerini mevcut düzenle-test et-düzelt döngüsünün parçası yapar.

Bu, güvenli aracı iş akışlarında kullanılan delege et-doğrula modelidir:

• OpenClaw komutu çalıştırır ve sonucu okur.
• Siz Apidog'da senaryoları görsel olarak tanımlarsınız.
• Kritik değişikliklerde ham çıktıyı ve çıkış kodunu doğrularsınız.

Daha geniş yaklaşım için şunları inceleyin:

• API testi için yapay zeka aracıları
• Apidog AI test donanımı

OpenClaw'un CLI'ı Gerçekten Çalıştırdığını Doğrulayın

Aracıların “testler geçti” özeti tek başına yeterli değildir. Aşağıdaki üç kontrolü uygulayın.

1. Komutun gerçekten çalıştığını doğrulayın

OpenClaw transkriptinde yürütülen komutları ve çıktılarını arayın.

Şuna benzer bir satır görmelisiniz:

apidog run -t 1234567 -e 890123 -r cli

Ardından test çıktısı gelmelidir. OpenClaw testleri çalıştırdığını söylüyor ancak komut görünmüyorsa, ham çıktıyı göstermesini ve testi yeniden çalıştırmasını isteyin.

2. Çıkış kodunu kontrol edin

Doğrudan şu soruyu sorun:

O apidog run komutunun çıkış kodu neydi?

apidog run davranışı basittir:

• 0: Tüm onaylamalar geçti.
• Sıfır olmayan değer: En az bir test veya onaylama başarısız oldu.

Metin özeti ile çıkış kodu çelişiyorsa çıkış kodunu esas alın.

3. Doğru senaryo ve ortamın kullanıldığını doğrulayın

“Senaryo bulunamadı” hatası genellikle yanlış veya uydurulmuş bir kimliğe işaret eder.

Şunları karşılaştırın:

• AGENTS.md içindeki -t değeri
• AGENTS.md içindeki -e değeri
• Apidog'un CI/CD sekmesinde oluşturduğu komut

Kimlikleri Apidog'un ürettiği komuttan kopyalayın; elle yazmayın.

İsteğe Bağlı: Apidog MCP Sunucusunu Bağlayın

apidog run komutunu yürütme aracıyla çalıştırmak çoğu test ihtiyacını karşılar. Bir sonraki adım Model Context Protocol (MCP) kullanmaktır.

OpenClaw MCP sunucularını destekler. Sunucu eklemek için:

openclaw mcp add <isim>

Bu komut, sunucu tanımını ~/.openclaw/openclaw.json içindeki mcp.servers bölümüne yazar. --command ve --arg gibi stdio bayraklarını da kabul eder. Ayrıntılar için OpenClaw MCP belgelerine bakın.

Apidog MCP sunucusu, API spesifikasyonlarınızı MCP üzerinden erişilebilir hale getirir. Böylece OpenClaw yalnızca test sonucunu görmekle kalmaz, kod yazarken şemanızı da okuyabilir.

İş bölümü nettir:

• Apidog CLI: Testleri çalıştırır ve sonuç üretir.
• Apidog MCP: Aracıya API spesifikasyonunu sağlar.

OpenClaw Yanlış Yaptığında

Kurulum sırasında sık görülen sorunlar ve uygulanabilir çözümler aşağıdadır.

AGENTS.md bloğunu yok sayıyor

OpenClaw genel bir komut çalıştırıyor veya hiç komut çalıştırmıyorsa AGENTS.md doğru bağlama yüklenmiyor olabilir.

Kontrol listesi:

1. Dosyanın, aracının etkin çalışma alanında olduğundan emin olun.
2. Kuralı yanlış bir alt dizine koymadığınızı doğrulayın.
3. OpenClaw'un dizine göre kapsamlı AGENTS.md dosyalarını uyguladığını unutmayın.
4. Yeni okuma zorlamak için oturumu yeniden başlatın.

Yürütme engellendiği için test çalışmıyor

apidog run sessizce atlanıyorsa veya izin bekliyorsa tools.exec ayarını kontrol edin.

Çözüm seçenekleri:

• İzin modunu auto olarak ayarlayın.
• Yalnızca apidog komutunu izin listesine ekleyin.
• ask modunda ilk çalıştırmayı onaylayın.

Her şeyi açmadan tek bir komuta izin verme yaklaşımı için güvenli OpenClaw kurulum kılavuzuna bakın.

Hâlâ erişim jetonu geçiriyor

OpenClaw --access-token eklemeye çalışıyorsa genel örneklerden tahmin yürütüyor olabilir.

AGENTS.md kuralını netleştirin:

Makine `apidog login` ile kimliği doğrulanmıştır. `--access-token` kullanmayın ve bu depoya asla erişim jetonu yazmayın.

Doğru kimlik doğrulama akışı için Apidog CLI kimlik doğrulaması kılavuzunu kullanın.

Bir bayrak uyduruyor

“Bilinmeyen seçenek” hatası, yüklü sürümünüzde olmayan bir bayrağın tahmin edildiğini gösterir.

Tahmin etmek yerine şu komutu çalıştırın:

apidog run --help

Ardından kullanacağınız bayrağı doğrudan yardım çıktısından alın.

Başarısız çalıştırmayı başarılı olarak raporluyor

Bu en maliyetli hatadır. Çözüm, AGENTS.md içinde çıkış kodu kuralını açıkça tanımlamak ve doğrulama sırasında ham çıktıyı kontrol etmektir.

Kural basittir:

Özet ile çıkış kodu uyuşmuyorsa, çıkış kodu kazanır.

Aynı yaklaşım diğer kodlama araçlarında da geçerlidir. İlgili örnekler için Codex'te Apidog CLI ve Claude Code vs OpenClaw içeriklerine bakın.

Günlük Bir Aracıdan Test Edilmiş Bir Döngüye

Kurulum akışı kısadır:

1. Kurulum kılavuzunu izleyerek apidog-cli paketini yükleyin.
2. Çalışma alanınızdaki AGENTS.md dosyasına Apidog test kuralını ekleyin.
3. Apidog'un CI/CD sekmesinden gerçek apidog run komutunu kopyalayın.
4. OpenClaw'un komutu çalıştırabilmesi için tools.exec izin modunu yapılandırın.
5. OpenClaw'un transkriptinde komutu, CLI çıktısını ve çıkış kodunu doğrulayın.

GUI'nin arkasındaki bir test, biri tıkladığında çalışır. AGENTS.md içindeki tek satırlık bir apidog run komutu ise OpenClaw'un geliştirme döngüsünün parçası olabilir.

Senaryoları Apidog'da görsel olarak oluşturmaya devam edin, OpenClaw'un bunları değişikliklerden sonra çalıştırmasını sağlayın ve kırık uç noktaları dağıtımdan önce yakalayın. Apidog'u indirin, bir senaryo oluşturun ve üretilen apidog run komutunu AGENTS.md dosyanıza ekleyin.

Aynı test kapısını aracısız CI işlem hatlarında kullanmak için GitHub Actions'ta Apidog CLI kılavuzuna bakın.