OpenClaw bir döngüdür: çalışma alanınızı okur, yürütme aracı aracılığıyla shell komutlarını çalıştırır, çıktıyı okur ve bir sonraki adımda ne yapacağına karar verir. Peki API testleriniz neden bu döngüde değil? Apidog'da bir GUI'nin arkasında duruyorlar, biri tıklamayı hatırladığında çalışıyorlar. Aracınız onlara asla dokunmuyor.
Çözüm, tek bir yapılandırma bloğu. Apidog CLI, Apidog'da oluşturduğunuz test senaryolarını doğrudan bir terminalden çalıştıran bir npm paketi olan apidog-cli'dır. CLI yüklendikten ve OpenClaw bunun var olduğunu öğrendikten sonra, aracınız bir Apidog senaryosunu birim testlerinizi çalıştırdığı gibi çalıştırır: komutu ateşler, çıkış kodunu okur, kırmızıysa kodu düzeltir.
Bu kılavuz, genel yükleme kılavuzunun atladığı OpenClaw'a özel kısmı kapsar: Apidog kurallarını aracının tutması için nereye koyacağınızı, OpenClaw'un yürütme aracının apidog run komutunu nasıl çalıştırdığını ve sonucu nasıl okuyacağınızı.
CLI'yı henüz yüklemediyseniz, önce bunu yapın. Bir AI kodlama aracısıyla Apidog CLI nasıl yüklenir npm kurulumunu, kimlik doğrulamasını ve ilk çalıştırmayı adım adım anlatır. Bu makale, apidog --version komutunun bir sayı yazdığını ve Apidog hesabınıza giriş yapıldığını varsayar.
Bu Hangi OpenClaw Hakkında
OpenClaw, kendi makinenizde çalışan açık kaynaklı, yerel öncelikli bir yapay zeka aracıdır. Bir çalışma alanına, bir dizi yeteneğe ve gerçek shell komutlarını çalıştıran bir yürütme aracına sahiptir. Bir kod tamamlama eklentisi veya barındırılan bir sohbet robotu değildir. Eğer openclaw'ı yerel olarak çalıştırdıysanız ve dosyaları düzenlediğini ve komutları yürüttüğünü izlediyseniz, doğru yerdesiniz demektir. Daha geniş kurulum için, OpenClaw'a herhangi bir komut vermeden önce OpenClaw geliştirme iş akışı otomasyonuna ve güvenli bir OpenClaw kurulumu kılavuzuna bakın.
Bu ayrım önemlidir çünkü OpenClaw proje kurallarını çalışma alanı dosyalarından öğrenir ve bu mekanizma, tek seferlik "testlerimi çalıştır" komutunu OpenClaw'un kendi başına ulaşacağı bir şeye dönüştürür. Bu mekanizma AGENTS.md'dir.
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 enjekte eder. İstediğiniz dosya, araca ne yapması gerektiğini ve nasıl yapacağını söyleyen prosedürel kural kitabı olan AGENTS.md'dir. Claude Code için CLAUDE.md gibi düşünün; OpenClaw hatta çalışma alanınıza kopyalayabileceğiniz varsayılan bir şablonla gelir ve kardeş bir CLAUDE.md sembolik bağlantısını aynı dosya olarak kabul eder. Çalışma alanı varsayılan olarak ~/.openclaw/workspace'dir, ancak bir aracıyı agents.list[].workspace ile projenizin dizinine yönlendirebilirsiniz ve OpenClaw, alt dizin başına kapsamlı AGENTS.md dosyalarını destekler (bkz. OpenClaw'un AGENTS.md referansı).
AGENTS.md dosyanıza kısa bir blok 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.
CLI'yı sohbet içinde bahsetmek yerine AGENTS.md'ye yazmanızın nedeni budur. Bir oturuma yazılan bir senaryo kimliği, oturum sona erdiğinde kaybolur. AGENTS.md'deki bir senaryo kimliği, bundan sonra her ekip arkadaşı ve her OpenClaw çalışması için orada kalır.
Adım 2: Komutu Apidog'dan Alın
Senaryo kimliğini elle yazmanıza gerek yok. Apidog'da test senaryosunu açın, CI/CD sekmesine gidin ve oluşturulan komutu kopyalayın. Şuna benzer:
apidog run -t 1234567 -e 890123 -r cli
-t test senaryosu, -e ortam ve -r cli raporlayıcıdır. Gerçek kimlikleri Adım 1'deki AGENTS.md bloğuna yapıştırın, böylece OpenClaw her zaman doğru senaryoyu doğru ortama karşı çağırır. Ayar yapmak isterseniz eksiksiz Apidog CLI kılavuzu ve apidog run komut referansı her bayrağı kapsar.
Adım 3: Aracının Testi Çalıştırmasını Sağlayın
Blok yerleştikten sonra, projenizle OpenClaw'u başlatın ve API'nizi etkileyen bir değişiklik yapın ya da sadece kontrolü çalıştırmasını isteyin. AGENTS.md zaten bağlamda olduğu için, aracı CLI'nin var olduğunu bilir ve yürütme aracı aracılığıyla apidog run komutunu verir.
Yürütme aracı, çalışma alanında shell komutlarını çalıştırır ve OpenClaw bunu bir izin moduyla kontrol eder. Modlar deny, allowlist, ask, auto ve full'dur (OpenClaw'un izin modları sayfasında belgelenmiştir). Bir kodlama aracı için auto mantıklı bir ayardır: izin verilen komutlar sorulmadan çalışır ve diğer her şey size sormadan önce gözden geçirilir. Modunuz ask ise, OpenClaw apidog run komutunu çalıştırmadan önce duraklar ve onay ister; bir kez onaylayın veya komutu izin listenize ekleyin, böylece hazırlık ortamına karşı salt okunur bir test kendi başına çalışır. Modu openclaw.json içindeki tools.exec altında ayarlayın.
Adım 4: Raporu OpenClaw İçinde Okuyun
-r cli raporlayıcı, terminalde adım adım bir sonuç yazdırır: her istek, her onaylama ve beklenen ile gerçek değerle birlikte hangisinin başarısız olduğu. OpenClaw'un bir sonraki adımına karar vermek için okuduğu bu satır içi dökümdür, bu nedenle listede cli'yi tutun.
Bir tarayıcıda açabileceğiniz veya bir ekip arkadaşına verebileceğiniz bir rapor istediğinizde, HTML raporlayıcıyı ekleyin:
apidog run -t 1234567 -e 890123 -r cli,html
html raporlayıcı, ./apidog-reports konumuna bağımsız bir dosya yazar. OpenClaw'un yine de satır içi çıktıyı alması için cli'yi yanında tutun. CI panellerinin ayrıştırdığı JUnit formatı ve diğer tüm raporlayıcılar için Apidog CLI test raporları kılavuzuna bakın.
OpenClaw Kendi Döngüsünde Test Yapıyor
Önemli olan, siz sormayı bıraktığınızda ve AGENTS.md ona söylediği için OpenClaw'un senaryoyu kendi başına çalıştırmasıdır.
OpenClaw'un bir ödeme yanıtı oluşturan bir işleyiciyi düzenlediğini hayal edin. Döngüsü değişir: kodu düzenler, ardından zafer ilan etmek yerine Apidog senaryonuzu hazırlık ortamına karşı çalıştırır, çıkış kodunu okur ve buna göre hareket eder. Yeşilse devam eder. Kırmızıysa raporu açar, hangi onaylamanın başarısız olduğunu okur (durum kodu, eksik alan, yanlış değer), bir düzeltme denemesi yapar ve tekrar çalıştırır. API testi, OpenClaw'un birim testlerinizi zaten çalıştırdığı düzenle-test et-düzelt döngüsünün bir parçası haline gelir. Tek bir talimat yazdınız ve aracı komutu zaten çalıştığı şekilde entegre etti.
Bu, herhangi bir aracı iş akışını güvenli kılan delege et-doğrula modelidir. OpenClaw komutu çalıştırır ve sonucu okur; siz Apidog'da senaryoları görsel olarak yazmaya devam edersiniz ve aracının çıkış kodlarını dürüstçe okuduğunu nokta kontrolü yaparsınız. Daha geniş desen için, API testi için yapay zeka aracılarını nasıl kullanacağınızı ve Apidog AI test donanımını inceleyin.
OpenClaw'un CLI'yı Gerçekten Çalıştırdığını Doğrulayın
Aracılar hak etmedikleri başarıları bildirirler ve OpenClaw da bir istisna değildir. Sorunları yakalama sıklığına göre üç kontrol.
İlk olarak, komutun gerçekten çalışıp çalışmadığını onaylayın. OpenClaw'un transkripti, yürüttüğü yürütme komutlarını ve bunların çıktısını gösterir. Tam olarak apidog run ... satırını ve altında bir sonucu arayın. OpenClaw testleri çalıştırdığını söylüyor ancak komutu göremiyorsanız, hiç yapmadığı bir şeyi özetlemiştir. Tekrar çalıştırmasını ve ham çıktıyı göstermesini isteyin.
İkincisi, önemli olan çıkış kodunu onaylayın. Doğrudan sorun:
O apidog run komutunun çıkış kodu neydi?
apidog run, her onaylama geçtiğinde 0, herhangi bir şey başarısız olduğunda sıfır olmayan bir değerle çıkar. Bu tek davranış, OpenClaw'un veya bir işlem hattının çalıştırmayı temiz bir kapı olarak ele almasını sağlar. Düz yazıda "testler geçti" denmesine rağmen çıkış kodu sıfır değilse, çıkış kodu doğrudur.
Üçüncüsü, gerçek senaryoyu kullandığını onaylayın. Bir çalıştırma "senaryo bulunamadı" hatasıyla başarısız olursa, OpenClaw bir kimlik icat etmiş veya yanlış hatırlamış olabilir. -t ve -e değerlerini AGENTS.md'ye ve Apidog'un CI/CD sekmesinde oluşturduğu komuta karşı tekrar kontrol edin. AGENTS.md'deki kimlikler gerçektir.
İsteğe Bağlı: Apidog MCP Sunucusunu Bağlayın
apidog run komutunu yürütme aracı aracılığıyla çalıştırmak, ihtiyacınız olan çoğu şeyi kapsar. Bir yol daha ileri gider: Model Bağlam Protokolü (Model Context Protocol).
OpenClaw MCP sunucularını destekler. Bir sunucu eklemek için openclaw mcp add <isim> komutunu kullanırsınız, bu komut sunucu tanımını ~/.openclaw/openclaw.json altındaki mcp.servers'e yazar ve --command ve --arg gibi stdio bayraklarını kabul eder (bkz. OpenClaw'un MCP belgeleri). Apidog MCP sunucusu, API spesifikasyonlarınızı MCP üzerinden açığa çıkarır, böylece OpenClaw kod yazarken şemanızı okuyabilir, sadece sonrasında değil. İş bölümü nettir: CLI testleri çalıştırır ve MCP, aracıya spesifikasyonu besler.
OpenClaw Yanlış Yaptığında
Kurulum sırasında birkaç hata sıkça ortaya çıkar.
AGENTS.md bloğunu yok sayar. OpenClaw genel bir komut çalıştırıyorsa veya hiç çalıştırmıyorsa, dosya bağlama yüklenmiyor olabilir. Bloğun, aracının etkin çalışma alanına ait olan AGENTS.md içinde olduğundan emin olun ve OpenClaw'un kapsamlı AGENTS.md dosyalarını dizine göre gezdiğini, bu yüzden yanlış alt ağaçta gömülü bir kuralın atlanacağını unutmayın. Oturumu yeniden başlatmak yeni bir okumayı zorlar.
Yürütme engellendiği için hiçbir şey çalıştırmaz. OpenClaw'un varsayılan politikası sıkılaştığından beri, yürütme reddedilebilir veya bir izin listesinin arkasında tutulabilir. Eğer apidog run sessizce atlanıyorsa, tools.exec altındaki izin modunuzu kontrol edin ve ya auto'ya geçin ya da apidog'u izin listesine ekleyin. Her şeyi açmadan sadece bu komutu nasıl açacağınız için güvenli OpenClaw kurulum kılavuzuna bakın.
Yine de bir erişim jetonu geçirir. OpenClaw --access-token eklemeye çalışırsa, genel örneklerden tahmin yürütüyordur. Makine apidog login aracılığıyla kimliği doğrulandığı için blok zaten bunu yapmamasını söyler. Bu satırı pekiştirin ve AGENTS.md'ye asla gerçek bir jeton koymayın; doğru desen için Apidog CLI kimlik doğrulamasına bakın.
Bir bayrak icat eder. "Bilinmeyen seçenek" hatası, OpenClaw'un sürümünüzde bulunmayan bir bayrağı tahmin ettiği anlamına gelir. apidog run --help komutunu çalıştırmasını söyleyin ve oradan tam bayrağı kopyalayın, bu her zaman yüklü sürümünüz için doğrudur.
Başarısız bir çalıştırmada başarılı olduğunu bildirir. En maliyetli olanı ve çıkış kodu kuralının AGENTS.md'nizde ve doğrulama adımınızda olmasının nedeni. Özet ve çıkış kodu uyuşmadığında, çıkış kodu kazanır. Bu konuda başka bir aracı kullandıysanız, aynı kural geçerlidir; yaklaşım, Codex'te Apidog CLI ve Claude Code vs OpenClaw makalelerimizde ele aldığımızı yansıtır.
Günlük Bir Aracıdan Test Edilmiş Bir Döngüye
Kurulum bu kadar. Kurulum kılavuzunu takip ederek apidog-cli'yi bir kez yükleyin, çalışma alanınızdaki AGENTS.md'ye kısa bir Apidog bloğu ekleyin, komutun çalışabilmesi için yürütme izin modunu ayarlayın ve OpenClaw API testlerinizi nasıl çalıştıracağını ve kodu düzenlemek için zaten kullandığı aynı döngü içinde sonucu nasıl okuyacağını bilecektir. Bozuk bir uç nokta, OpenClaw değişikliği üzerinde çalışırken yakalanır, dağıtımdan sonra değil.
Bir GUI'nin arkasındaki bir test, bir insan tıkladığında çalışır; tek satırlık bir komut ise OpenClaw ne zaman isterse o zaman çalışır. Siz Apidog'da senaryoları görsel olarak oluşturmaya devam edersiniz ve aracınız siz izlemezken onları çalıştırır. Apidog'u indirin, bir senaryo oluşturun, apidog run komutunu AGENTS.md'ye bırakın ve OpenClaw'un bir sonraki değişiklikte onu nasıl ele aldığını izleyin. Aracının olmadığı bir işlem hattında aynı kapıyı istediğinizde, GitHub Actions'ta Apidog CLI sırları, raporlayıcıları ve çıkış kodu kontrolünü kapsar.