PicoClaw Eğitimi: Sınırlı Disk Alanı için Aşırı-Minimalist Bir Aracı Çerçevesi

Son haberler doğruysa, yapay zeka dünyadaki tüm RAM ve CPU kaynaklarını tüketiyor; bu da PicoClaw’ı son derece zamanında bir araç yapıyor. Lansmanında büyük yankı uyandırması, ilk birkaç günde binlerce yıldız toplaması şaşırtıcı değil. Tam teşekküllü AI ajanı 10 MB’ın altına sığıyor ve 600 MHz işlemcide bir saniyeden kısa sürede başlatılıyor. 

Karşıma çıkınca, tüm bu heyecanın gerçek olup olmadığını görmek için kendim denemek zorunda kaldım. Bu yazıda PicoClaw’ı adım adım inceleyecek, bulduğum her şeyi öne çıkaracağım. 

Aracısal yapay zekâ hakkında daha fazla bilgi edinmek istiyorsanız, AI Agent Fundamentals yetkinlik yoluyla başlamanızı öneririm. 

PicoClaw Nedir?

PicoClaw, Nanobot’tan ilham alan hafif bir kişisel AI asistanıdır. Sipeed ekibi tarafından Go ile yazılmıştır ve Raspberry Pi, gömülü RISC-V kartlar ve MIPS tabanlı yönlendiriciler gibi uç cihazlarda çalışır. Bu da PicoClaw’ı 10 $’lık bir donanım bütçesiyle çalıştırabileceğiniz anlamına gelir. 

PicoClaw’ın Temel Özellikleri ve Yetenekleri

PicoClaw tek bir ikili (binary) dosya olarak gelir. Bu, herhangi bir Python sanal ortamı yapılandırma ya da pip kurulumu gerektirmediği için kurulumu son derece hızlı kılar. 

İkili bir dosya olması, onu çeşitli mimarilerde çalıştırabileceğiniz anlamına gelir. Sürüm sayfasında Linux, macOS ve Windows dahil çeşitli işletim sistemleri için indirmeler bulunur. 

Yapay zekâ tarafında, PicoClaw sağlayıcıdan bağımsızdır. OpenAI, Anthropic, DeepSeek ve hatta yerel modeller için Ollama’yı destekler. Bu, modeller arasında geçiş yapmak veya gizlilik nedenleriyle yerel modeller kullanmak isteyen kullanıcılar için önemli bir avantajdır. 

Yerel modeller için Ollama’yı nasıl kuracağınızı OpenClaw ile Ollama Kullanma kılavuzunda öğrenebilirsiniz. 

PicoClaw’ın yerleşik araçları şunları yapabilir: 

• Dosya okuma ve yazma 
• Ana sistemde kabuk komutları çalıştırma 
• Brave Search veya DuckDuckGo ile web araması yapma 
• cron ile yinelenen işler zamanlama 

Nanobot gibi, WhatsApp, Telegram, Discord, QQ ve DingTalk gibi yaygın platformları destekler. İleride, Telegram ile nasıl kurulacağını göstereceğim. 

Hafif bir OpenClaw alternatifi olan Nanobot’u keşfedin. Bu Nanobot tam kurulum kılavuzu ile 10 dakikadan kısa sürede güvenli, denetlenebilir bir Python AI ajanı oluşturun.

PicoClaw’ın artıları ve eksileri

Kurulumunun ne kadar hızlı ve basit olduğunu düşününce, PicoClaw’ın eksiklerinin ne olduğunu merak ediyor olabilirsiniz. Oraya geleceğiz, ama önce artılara bakalım. 

İlk olarak, ikili bir dosya olması onu neredeyse her cihazda kurmayı kolaylaştırıyor. Kendi Google Pixel telefonumda birkaç dakika içinde kurabildim. 

İkinci olarak, PicoClaw mevcut mesajlaşma platformlarınızla birlikte kullanılabilir; böylece uygulama değiştirmeden kolayca etkileşim kurabilirsiniz. 

Olumsuz tarafta, PicoClaw hâlâ 1.0 öncesi aşamada. Çok yeni bir araç olması, beklenmeyen hatalar ya da uyumsuz değişiklikler olabileceği anlamına gelir. Araştırırken, PicoClaw’ı hedefleyen çok sayıda kripto dolandırıcılığına da rastladım. Resmî dokümanlarda herhangi bir coin çalıştırmadıkları belirtiliyor; bu yüzden dikkatli olun. 

PicoClaw Nasıl Kurulur

PicoClaw’ı birkaç adımda kurabilirsiniz. Nasıl olduğuna bakalım:

Kurulum (tek ikili dosya indirme)

PicoClaw’ı kurmak için doğrudan kaynaktan derleyebilirsiniz:

git clone https://github.com/sipeed/picoclaw.git
cd picoclaw
make deps
# Build, no need to install
make build
# Build for multiple platforms
make build-all
# Build for Raspberry Pi Zero 2 W (32-bit: make build-linux-arm; 64-bit: make build-linux-arm64)
make build-pi-zero
# Build And Install
make install

Ancak ben daha hızlı olduğu için Docker kullanmayı tercih ediyorum: 

# 1. Clone this repo
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw
# 2. First run — auto-generates docker/data/config.json then exits
docker compose -f docker/docker-compose.yml --profile gateway up
# The container prints "First-run setup complete." and stops.
# 3. Set your API keys
nano docker/data/config.json   # Set provider API keys, bot tokens, etc.
# 4. Start
docker compose -f docker/docker-compose.yml --profile gateway up -d

Konteynerleştirmenin temel bilgilerini Yeni Başlayanlar için Docker kılavuzumuzdan öğrenin. 

LLM sağlayıcınızı yapılandırma

Kurulumdan sonra, tercih ettiğiniz LLM sağlayıcısını yapılandırmanız gerekir. Bunu docker/data/config.json dosyasını düzenleyerek yapabilirsiniz:

{
  "agents": {
    "defaults": {
      "workspace": "~/.picoclaw/workspace",
      "model_name": "gpt4",
      "max_tokens": 8192,
      "temperature": 0.7,
      "max_tool_iterations": 20
    }
  },
  "model_list": [
    {
      "model_name": "gpt4",
      "model": "openai/gpt-5.2",
      "api_key": "your-api-key",
      "request_timeout": 300
    },
    {
      "model_name": "claude-sonnet-4.6",
      "model": "anthropic/claude-sonnet-4.6",
      "api_key": "your-anthropic-key"
    }
  ],
  "tools": {
    "web": {
      "brave": {
        "enabled": false,
        "api_key": "YOUR_BRAVE_API_KEY",
        "max_results": 5
      },
      "tavily": {
        "enabled": false,
        "api_key": "YOUR_TAVILY_API_KEY",
        "max_results": 5
      },
      "duckduckgo": {
        "enabled": true,
        "max_results": 5
      },
      "perplexity": {
        "enabled": false,
        "api_key": "YOUR_PERPLEXITY_API_KEY",
        "max_results": 5
      },
      "searxng": {
        "enabled": false,
        "base_url": "http://your-searxng-instance:8888",
        "max_results": 5
      }
    }
  }
}

İlk ajanınızı çalıştırma

PicoClaw’ı Telegram’a bağlamak sadece birkaç adım alır.

Telegram için ben şöyle kurdum:

• Telegram’ı açın ve @BotFather’ı arayın 
• /newbot yazın ve yönlendirmeleri izleyin 
• BotFather’dan alacağınız belirteci (token) kopyalayın 
• Ardından, botun yalnızca sizden komut almasını sağlamak için kullanıcı kimliğinizi edinin. Telegram’da @userinfobot’u arayın ve başlat’a tıklayın. Kullanıcı kimliğini kopyalayın.

Sonraki adımda, bot belirtecini ve Telegram kullanıcı kimliğinizi eklemek için docker/data/config.json dosyasını güncelleyin. 

Şimdi Telegram botunuza gidin ve Picoclaw ile etkileşime geçmeye başlayın. 

Birkaç istem deneyelim. 

Önce, PicoClaw’ı kullanarak web’de arama yapıp Apple’ın güncel hisse fiyatını getireceğim. Ekran görüntüsünden de göreceğiniz üzere DuckDuckGo web aracı kullanıldı ve fiyat getirildi. 

İşte PicoClaw’dan bir blog taslağı hazırlamasını, diske kaydetmesini ve okumasını isteyen bir başka istem:

Zamanlanmış görevleri çalıştırma becerisi hakkında meraklandım; bu yüzden bana beş dakika içinde blogu yayımlamamı hatırlatmasını istedim ve 5 dakika sonra hatırlatma geldi. 

PicoClaw’ın Yaygın Sorunları ve Sorun Giderme

PicoClaw’ı kurarken bazı sorunlarla karşılaştım. Siz de benzerini yaşarsanız diye kısaca burada değineceğim. 

Telegram’da Yanıt Yok

Telegram’da hiç yanıt alamazsanız sorun şunlar olabilir: 

• Telegram belirteci doğru değil. Yapılandırma dosyasını açıp tekrar kontrol edin 
• from kullanıcı kimliği ayarlanmamış ya da ajana farklı bir hesaptan erişiyorsunuz 
• Model ve API anahtarları ayarlı değil. Yapılandırma dosyasını açıp bunları ayarlayın

Günlüklere baktığınızda, sorunun tam olarak ne olduğunu göreceksiniz: 

docker compose -f docker/docker-compose.yml logs -f picoclaw-gateway

Model ayarlı değil 

Aşağıdaki hata, varsayılan modeli ayarlamadığınız anlamına gelir: 

Error: error creating provider: model "" not found in model_list: model "" not found in model_list or providers

JSON yapılandırma dosyasını açın; kullanmak istediğiniz modelin adını ayarlayın ve API anahtarının da dosyada yer aldığından emin olun.

{
  "agents": {
    "defaults": {
      "workspace": "~/.picoclaw/workspace",
      "model_name": "gpt4", ---> make sure this is here 
      "max_tokens": 8192,
      "temperature": 0.7,
      "max_tool_iterations": 20
    }
  }

Yanlış API anahtarı sağlandı

Bu oldukça basit. Seçtiğiniz model sağlayıcısı için doldurulan API anahtarı boş ya da hatalı. JSON yapılandırma dosyasını açıp anahtarı doğrulayın.

PicoClaw’ın Öne Çıkan Yetenekleri

Şimdi PicoClaw’ı diğer kişisel AI asistanlarından farklı ve benzer kılan bazı yetenekleri keşfedelim. 

Heartbeat sistemi

PicoClaw’ın çalışma dizininde bir heartbeat Markdown dosyası bulunur; ajan bu dosyayı her 30 dakikada bir okur ve oradaki talimatları uygular. Picoclaw ayrıca işi paralel yürütmek için alt ajanlar başlatabilir. 

Kalıcı bellek

PicoClaw, oturumlar arasında kalması gereken önemli bilgileri depolayan bir bellek dosyasına sahiptir. Tercihlerinizi ve etkinleştirilmiş becerilerinizi kaydeder; böylece bu bağlam gerektiğinde çağrılabilir. Bu, her etkileşime sıfırdan başlamamanız açısından önemlidir. 

Ağdan izole / Çevrimdışı mod

PicoClaw internet erişimi olmadan da çalışabilir. Bu, özellikle bankacılık ve sağlık gibi düzenlemeye tabi sektörlerde hassas verileri işlerken önemlidir. Bunu sağlamak için Ollama üzerinden yerel bir model kurmanız gerekir. 

Çoklu ajan ve model geri dönüşleri

PicoClaw’da her ajanı kendi LLM sağlayıcısını kullanacak şekilde tanımlayabilirsiniz. Ayrıca, istekleri birden fazla model arasında dağıtabileceğiniz yük dengelemeyi destekler. Kurulduğunda PicoClaw, modeller arasında döngüsel (round robin) şekilde sırayla geçiş yapar.

Donanım entegrasyonu

PicoClaw, I2C ve SPI iletişimi için yerleşik araçlar içerir. Bu, ajanın desteklenen kartlardaki donanım çevre birimleriyle etkileşime girmesine yardımcı olur. Yani sensörler, ekranlar, motor sürücüleri ve her türlü fiziksel aygıtla etkileşim kurabilir. 

PicoClaw İş Başında: Gerçek Kullanım Senaryaları

Şimdi bazı PicoClaw kullanım örneklerini inceleyelim. 

Bunu araştırırken çevrimiçi bulduğum ilginç kullanım örneklerinden bazıları şunlardı: 

• Birinci nesil Raspberry Pi ile ev otomasyonu ve izleme çalıştırma 
• Otomatik web aramaları çalıştırma; örneğin her sabah Telegram’da özetler göndermek 
• Gömülü cihazlardan uyarı ve izleme; örneğin sensör verilerinden 

PicoClaw’ın Sınırlamaları ve Dikkat Edilmesi Gerekenler

PicoClaw’ı ağınıza dağıtmadan önce akılda tutulması gereken birkaç ciddi kısıtlama var.

İlk olarak, PicoClaw varsayılan olarak güvenlidir. Çalıştığı çalışma alanıyla sınırlıdır. Bu nedenle bu dizin dışındaki klasör ve dosyalara erişemez. 

Bunu ayarlar dosyasında değiştirebilirsiniz. 

rm gibi belirli komutlar da, sabit diskinizin tamamen silinmesi gibi sorunları önlemek için kısıtlanmıştır. 

Örneğin, ondan ana klasörümü silmesini istedim ve bu durumu önlemek için korkuluklar devreye girdi. 

Erken geliştirme aşamasındaki bir yazılım olarak, PicoClaw’ın çözülmemiş ağ güvenliği sorunları vardır; bu nedenle v1.0 sürümünden önce üretimde dağıtılması önerilmez. 

Daha olgun bir şey arıyorsanız, OpenClaw iyi bir seçenek. İş akışınıza uygun olup olmadığını OpenClaw vs Claude Code kılavuzumuzda keşfedin. 

Gelecek Öngörüsü

Uç cihazlarda büyük dil modellerini çalıştırma yeteneği son dönemde büyük ivme kazandı. Özellikle cep telefonları ve gömülü cihazlarda çalışabilen modellerin ortaya çıkmasıyla. PicoClaw’ın, kaynakların kısıtlı olduğu ortamlarda ve veri hassasiyetinin mutlak olduğu uygulamalarda çok yararlı olacağını düşünüyorum. Bağlantının güvenilir olmadığı yerlerde, PicoClaw gibi bir aracı kullanmaktan başka seçenek olmayacaktır. 

PicoClaw’ın, üretime hazır olduğunda Nanobot ve OpenClaw’a gerçek bir rakip olabileceğini düşünüyorum. PicoClaw’ın Nesnelerin İnterneti cihazlarının aracısal iş akışlarını yürütmesini sağlayacak araç olacağına iddiaya girerim. Bu aynı zamanda, ajana güç veren modellerin halüsinasyon görmesi ya da bir istem enjeksiyonunun onları mikrodalga fırını aşırı ısıtmak gibi kötü niyetli şeyler yapmaya yöneltmesi durumunda ciddi riskler de barındırır. 

PicoClaw ayrıca yol haritalarında öngördükleri üzere, OpenClaw gibi diğer ajanlarda bulunan eksik özellikleri de inşa etmeye çalışacak. Bunlar arasında şunlar yer alıyor: 

• Tarayıcı otomasyonu
• Daha fazla beceri keşfi 
• MCP desteği 

Sonuç

OpenClaw çıktığında, onu çalıştırmak için Mac Mini satın alma etrafında çok fazla hype oluşmuştu; oysa aslında buna gerek yoktu. Bir Mac Mini yüzlerce dolara mal olur. 

PicoClaw, güçlü ajanların 10 $ bütçeyle dağıtılabileceğini göstererek bu anlatıyı çürütmek için geliştirildi. OpenClaw’ın aksine, PicoClaw güvenliği önceleyen bir yaklaşımla gelir; ajanın erişimini yalnızca kendi çalışma alanıyla sınırlar ve altta yatan modelin halüsinasyon görmesi ya da kötü niyetli bir istemin enjekte edilmesi durumunda büyük zarara yol açabilecek komutları devre dışı bırakır. 

Yapay zekâ araçlarıyla çalışmayı daha iyi öğrenmek için şunu incelemenizi öneririm: en iyi ücretsiz AI araçları rehberimiz. Daha geniş kapsamlı AI kodlama becerileri için, geliştirme iş akışınızda AI asistanlarını daha güvenilir ortaklara dönüştürecek becerileri edinmek üzere Geliştiriciler için AI Destekli Kodlama kursumuzu deneyin. 

Ayrıca, LLM’ler, istemler, zincirler ve ajanları kullanarak LangChain’de AI destekli uygulamaların nasıl oluşturulacağını Developing LLM Applications with LangChain kursumuzdan keşfedebilirsiniz.