PicoClaw ट्यूटोरियल: सीमित डिस्क स्पेस के लिए एक हाइपर-मिनिमलिस्ट एजेंट फ्रेमवर्क

यदि हाल की खबरें सही हैं, तो AI दुनिया भर की RAM और CPU संसाधनों का भारी उपयोग कर रहा है—जिससे PicoClaw जैसा टूल बेहद समयानुकूल बन जाता है। इसमें कोई आश्चर्य नहीं कि लॉन्च होते ही इसने हलचल मचा दी और कुछ ही दिनों में हज़ारों स्टार्स बटोर लिए। पूरा AI एजेंट 10MB से कम में समा जाता है और 600MHz प्रोसेसर पर एक सेकंड से भी कम में लॉन्च हो जाता है। 

जब मैं इसके बारे में जान पाया, तो मुझे खुद इसे टेस्ट करना पड़ा कि क्या वाकई यह जितना कहा जा रहा है उतना अच्छा है। इस लेख में, मैं आपको PicoClaw के बारे में बताऊंगा और अपनी सभी खोजें साझा करूंगा। 

यदि आप एजेंटिक AI के बारे में और जानने के इच्छुक हैं, तो मैं सुझाव दूंगा कि शुरुआत करें AI Agent Fundamentals स्किल ट्रैक से। 

PicoClaw क्या है?

PicoClaw एक हल्का-फुल्का पर्सनल AI असिस्टेंट है जो Nanobot से प्रेरित है। इसे Sipeed टीम ने Go में लिखा है और यह Raspberry Pi, एम्बेडेड RISC-V बोर्ड्स और MIPS-आधारित राउटर्स जैसे एज डिवाइस पर चलता है। यानी आप $10 के हार्डवेयर बजट में PicoClaw चला सकते हैं। 

PicoClaw की प्रमुख विशेषताएं और क्षमताएं

PicoClaw एक सिंगल बायनरी के रूप में आता है। इससे सेटअप बेहद तेज़ हो जाता है क्योंकि न तो किसी Python वर्चुअल एन्वायरनमेंट को कॉन्फ़िगर करना पड़ता है और न ही pip इंस्टॉल चलानी पड़ती है। 

बायनरी फ़ाइल होने का मतलब है कि आप इसे विभिन्न आर्किटेक्चर पर चला सकते हैं। रिलीज़ पेज पर Linux, macOS और Windows सहित विभिन्न ऑपरेटिंग सिस्टम्स के लिए डाउनलोड उपलब्ध हैं। 

AI की बात करें तो, PicoClaw प्रदाता-अज्ञेय है। यह OpenAI, Anthropic, DeepSeek और स्थानीय मॉडलों के लिए Ollama तक को सपोर्ट करता है। यह उन उपयोगकर्ताओं के लिए बड़ा फ़ायदा है जो मॉडलों के बीच स्विच करना चाहते हैं या गोपनीयता कारणों से लोकल मॉडल उपयोग करना चाहते हैं। 

स्थानीय मॉडलों के लिए Ollama सेटअप करना आप Using OpenClaw with Ollama गाइड से सीख सकते हैं। 

PicoClaw में बिल्ट-इन टूल्स हैं जो ये कर सकते हैं: 

• फाइलें पढ़ना और लिखना 
• होस्ट सिस्टम पर शेल कमांड्स चलाना 
• Brave Search या DuckDuckGo के साथ वेब सर्च करना 
• cron के साथ आवर्ती जॉब्स शेड्यूल करना 

Nanobot की तरह, यह WhatsApp, Telegram, Discord, QQ और DingTalk जैसे आम प्लेटफॉर्म्स को सपोर्ट करता है। आगे मैं आपको Telegram के साथ इसका सेटअप दिखाऊंगा। 

जानिए Nanobot के बारे में, जो हल्का-फुल्का OpenClaw विकल्प है। एक सुरक्षित, ऑडिटेबल Python AI एजेंट 10 मिनट से कम में बनाएं इस Nanobot पूर्ण सेटअप गाइड के साथ।

PicoClaw के फायदे और कमियां

शायद आप सोच रहे होंगे कि इतनी तेज़ी और सरल सेटअप के बावजूद PicoClaw की कमियां क्या हैं। हम उस पर आएंगे, पर पहले फायदे देखें। 

पहला, बायनरी फ़ाइल होने से इसे लगभग किसी भी डिवाइस पर सेटअप करना आसान हो जाता है। मैं इसे अपने Google Pixel फोन पर कुछ ही मिनटों में सेट कर पाया। 

दूसरा, PicoClaw को आप अपनी मौजूदा मैसेजिंग प्लेटफॉर्म्स के साथ उपयोग कर सकते हैं, जिससे बिना ऐप बदले इंटरैक्ट करना आसान हो जाता है। 

कमियों की बात करें तो, PicoClaw अभी प्री-1.0 है। बहुत नया टूल होने के कारण अप्रत्याशित बग्स या ब्रेकिंग चेंजेज हो सकते हैं। रिसर्च के दौरान मुझे PicoClaw को निशाना बनाती कई क्रिप्टो स्कैम्स भी मिलीं। आधिकारिक डॉक्स में कहा गया है कि वे कोई कॉइन नहीं चलाते, इसलिए सतर्क रहें। 

PicoClaw कैसे सेट करें

आप कुछ चरणों में PicoClaw सेट कर सकते हैं। आइए देखें कैसे:

इंस्टॉलेशन (सिंगल बायनरी डाउनलोड)

PicoClaw सेट करने के लिए, आप इसे सीधे सोर्स से बिल्ड कर सकते हैं:

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संचालित द्वारा

हालांकि, मुझे Docker का उपयोग करना अधिक तेज़ लगता है: 

# 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संचालित द्वारा

कंटेनराइजेशन की मूल बातें सीखें हमारे Docker for Beginners गाइड से। 

अपने LLM प्रदाता को कॉन्फ़िगर करना

सेटअप के बाद, आपको अपनी पसंद के LLM प्रदाता को कॉन्फ़िगर करना होगा। आप यह docker/data/config.json फ़ाइल संपादित करके कर सकते हैं:

{
  "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
      }
    }
  }
}संचालित द्वारा

अपना पहला एजेंट चलाना

PicoClaw को Telegram से जोड़ना केवल कुछ चरणों में हो जाता है।

यहां बताया है कि मैंने Telegram के लिए चीजें कैसे सेट कीं:

• Telegram खोलें और @BotFather खोजें 
• /newbot टाइप करें और निर्देशों का पालन करें 
• BotFather से मिलने वाला टोकन कॉपी करें 
• अगला, अपना यूज़र ID प्राप्त करें ताकि बॉट केवल आपसे आने वाले कमांड स्वीकार करे। Telegram में @userinfobot खोजें और Start पर क्लिक करें। यूज़र ID कॉपी करें।

अब docker/data/config.json फ़ाइल अपडेट करें और उसमें बॉट टोकन और अपना Telegram यूज़र ID शामिल करें। 

अब अपने Telegram बॉट पर जाएं और Picoclaw के साथ बातचीत शुरू करें। 

चलिए कुछ प्रॉम्प्ट्स आज़माते हैं। 

पहले, मैं PicoClaw से वेब सर्च कराकर Apple के मौजूदा स्टॉक प्राइस मंगवाऊंगा। जैसा कि स्क्रीनशॉट से दिखता है, इसने DuckDuckGo वेब सर्च टूल का उपयोग करके प्राइस प्राप्त कर लिया। 

यहां एक और प्रॉम्प्ट है, जिसमें PicoClaw से ब्लॉग का ड्राफ्ट तैयार करने, उसे डिस्क पर सेव करने और उसे पढ़ने के लिए कहा गया है: 

मैं इसकी शेड्यूल्ड टास्क चलाने की क्षमता को लेकर उत्सुक था, इसलिए मैंने इसे पांच मिनट में ब्लॉग पब्लिश करने की याद दिलाने को कहा—और 5 मिनट बाद रिमाइंडर सचमुच आ गया। 

PicoClaw की आम समस्याएं और समाधान

PicoClaw सेट करते समय मुझे कुछ समस्याएं मिलीं। यदि आपको भी वैसी ही दिक्कतें आएं, तो संक्षेप में उन्हें यहां साझा कर रहा हूं। 

Telegram पर कोई प्रतिक्रिया नहीं

यदि Telegram पर कोई प्रतिक्रिया नहीं मिलती, तो समस्या ये हो सकती है: 

• Telegram टोकन सही नहीं है। कॉन्फ़िग फ़ाइल खोलकर दोबारा जांचें 
• from यूज़र ID सेट नहीं है, या आप किसी अन्य अकाउंट से एजेंट एक्सेस कर रहे हैं 
• मॉडल और API की सेट नहीं हैं। कॉन्फ़िग फ़ाइल खोलकर उन्हें सेट करें

लॉग्स जांचते समय, आपको सटीक समस्या दिख जाएगी: 

docker compose -f docker/docker-compose.yml logs -f picoclaw-gatewayसंचालित द्वारा

मॉडल सेट नहीं है 

नीचे दी गई त्रुटि का मतलब है कि आपने डिफ़ॉल्ट मॉडल सेट नहीं किया है: 

Error: error creating provider: model "" not found in model_list: model "" not found in model_list or providersसंचालित द्वारा

JSON कॉन्फ़िग फ़ाइल खोलें, वह मॉडल नाम सेट करें जिसे आप उपयोग करना चाहते हैं, और सुनिश्चित करें कि उसकी API की भी फ़ाइल में शामिल है।

{
  "agents": {
    "defaults": {
      "workspace": "~/.picoclaw/workspace",
      "model_name": "gpt4", ---> make sure this is here 
      "max_tokens": 8192,
      "temperature": 0.7,
      "max_tool_iterations": 20
    }
  }संचालित द्वारा

गलत API की प्रदान की गई

यह सीधी बात है। आपके चुने हुए मॉडल प्रदाता के लिए भरी गई API की खाली है या गलत है। JSON कॉन्फ़िग फ़ाइल खोलें और की की पुष्टि करें।

PicoClaw की विशिष्ट क्षमताएं

अब उन क्षमताओं को देखें जो PicoClaw को अन्य पर्सनल AI असिस्टेंट्स से अलग और कुछ मामलों में समान बनाती हैं। 

हार्टबीट सिस्टम

PicoClaw के वर्किंग डायरेक्टरी में एक हार्टबीट मार्कडाउन फ़ाइल होती है, जिसे एजेंट हर 30 मिनट में पढ़ता है और उसमें दिए निर्देशों पर कार्य करता है। Picoclaw समानांतर कार्य संभालने के लिए सबएजेंट्स भी स्पिन-अप कर सकता है। 

स्थायी मेमोरी

PicoClaw में एक मेमोरी फ़ाइल होती है जिसमें सत्रों के बीच बना रहने वाली महत्वपूर्ण जानकारी संग्रहीत रहती है। यह आपकी प्रेफरेंसेज़ और सक्षम स्किल्स को सेव करता है ताकि ज़रूरत पड़ने पर वह संदर्भ खींचा जा सके। इससे हर इंटरैक्शन शून्य से शुरू नहीं करना पड़ता। 

एयर-गैप्ड / ऑफ़लाइन मोड

PicoClaw बिना इंटरनेट एक्सेस के भी चल सकता है। यदि आप संवेदनशील डेटा प्रोसेस करना चाहते हैं—खासकर बैंकिंग और हेल्थकेयर जैसी विनियमित इंडस्ट्रीज़ में—तो यह महत्वपूर्ण है। इसके लिए आपको Ollama के जरिए लोकल मॉडल सेट करना होगा। 

मल्टी-एजेंट और मॉडल फॉलबैक्स

PicoClaw में आप हर एजेंट के लिए उसका अपना LLM प्रदाता परिभाषित कर सकते हैं। यह लोड बैलेंसिंग भी सपोर्ट करता है, जिसमें आप अनुरोधों को कई मॉडलों में वितरित कर सकते हैं। सेटअप होने पर, PicoClaw राउंड-रॉबिन तरीके से मॉडलों को घुमाता है।

हार्डवेयर इंटीग्रेशन

PicoClaw में I2C और SPI कम्युनिकेशन के लिए बिल्ट-इन टूल्स शामिल हैं। इससे एजेंट समर्थित बोर्ड्स पर हार्डवेयर पेरीफ़ेरल्स के साथ इंटरैक्ट कर सकता है। यानी यह सेंसर, डिस्प्ले, मोटर कंट्रोलर्स और हर तरह के फिजिकल डिवाइसेज़ के साथ काम कर सकता है। 

कार्रवाई में PicoClaw: वास्तविक उपयोग के मामले

चलिए अब PicoClaw के कुछ उपयोग मामलों का अन्वेषण करें। 

रिसर्च के दौरान मुझे ऑनलाइन मिले कुछ दिलचस्प उपयोग मामलों में शामिल हैं: 

• फर्स्ट-जनरेशन Raspberry Pi के साथ होम ऑटोमेशन और मॉनिटरिंग चलाना 
• स्वचालित वेब सर्च चलाना, जैसे हर सुबह Telegram पर सार-संक्षेप भेजना 
• एम्बेडेड डिवाइसेज़ से अलर्टिंग और मॉनिटरिंग, जैसे सेंसर डेटा से 

PicoClaw की सीमाएं और सावधानियां

अपने नेटवर्क पर PicoClaw डिप्लॉय करने से पहले, कुछ गंभीर सीमाएं ध्यान में रखनी चाहिए।

पहला, PicoClaw डिफ़ॉल्ट रूप से सुरक्षित है। यह अपने वर्कस्पेस तक ही सीमित रहता है। इसलिए यह उस डायरेक्टरी के बाहर के फोल्डर्स और फाइल्स तक पहुंच नहीं सकता। 

आप इसे सेटिंग्स फ़ाइल में बदल सकते हैं। 

कुछ कमांड्स, जैसे rm, को भी प्रतिबंधित किया गया है ताकि हार्ड ड्राइव का साफ़ हो जाना जैसी समस्याएं रोकी जा सकें। 

उदाहरण के लिए, मैंने इसे अपना होम फोल्डर डिलीट करने को कहा, तो गार्डरेल्स ने ऐसा होने से रोक दिया। 

आरंभिक विकास चरण का सॉफ़्टवेयर होने के कारण, PicoClaw में अनसुलझे नेटवर्क सुरक्षा मुद्दे हैं, इसलिए v1.0 रिलीज़ से पहले इसे प्रोडक्शन में डिप्लॉय न करने की सिफारिश है। 

यदि आप कुछ अधिक परिपक्व खोज रहे हैं, तो OpenClaw एक अच्छा विकल्प है। जानें कि क्या यह आपके वर्कफ़्लो के लिए उपयुक्त है हमारे OpenClaw बनाम Claude Code गाइड में। 

भविष्य की रूपरेखा

एज डिवाइसेज़ पर बड़े भाषा मॉडल चलाने की क्षमता ने हाल ही में काफी रफ्तार पकड़ी है—खासकर ऐसे मॉडलों के आने के साथ जो मोबाइल फोन और एम्बेडेड डिवाइसेज़ पर चल सकते हैं। मेरा मानना है कि PicoClaw सीमित संसाधनों वाले माहौल और ऐसे अनुप्रयोगों में अत्यंत उपयोगी होगा जहां डेटा संवेदनशीलता सर्वोपरि है। जहां कनेक्टिविटी अविश्वसनीय है, वहां PicoClaw जैसे टूल का उपयोग ही एकमात्र विकल्प होगा। 

मुझे लगता है कि प्रोडक्शन के लिए तैयार होने पर PicoClaw, Nanobot और OpenClaw का सच्चा प्रतिद्वंद्वी हो सकता है। मैं दांव लगाऊंगा कि PicoClaw वह टूल होगा जो Internet-of-Things डिवाइसेज़ को एजेंटिक वर्कफ़्लो करने में सक्षम बनाएगा। इसके साथ गंभीर जोखिम भी हैं—यदि एजेंट को चलाने वाले मॉडल मतिभ्रम करें या कोई प्रॉम्प्ट इंजेक्शन उन्हें माइक्रोवेव को ओवरहीट करने जैसी दुर्भावनापूर्ण हरकत करने को प्रेरित करे। 

PicoClaw अन्य एजेंट्स—जैसे OpenClaw—में उपलब्ध लेकिन यहां अनुपस्थित फीचर्स भी जोड़ने की कोशिश करेगा, जैसा कि उनके रोडमैप में परिकल्पित है। इनमें शामिल हैं: 

• ब्राउज़र ऑटोमेशन
• और अधिक स्किल डिस्कवरी 
• MCP सपोर्ट 

निष्कर्ष

जब OpenClaw लॉन्च हुआ था, तो उसे चलाने के लिए Mac Mini खरीदने को लेकर काफी हाइप थी—हालांकि वास्तव में उसकी ज़रूरत नहीं थी। एक Mac Mini सैकड़ों डॉलर का आता है। 

PicoClaw इसी नैरेटिव को गलत साबित करने के लिए बना—ताकि $10 के बजट में शक्तिशाली एजेंट्स डिप्लॉय किए जा सकें। OpenClaw के विपरीत, PicoClaw सुरक्षित-प्रथम दृष्टिकोण के साथ आता है—एजेंट की पहुंच को केवल उसके वर्कस्पेस तक सीमित रखते हुए और उन कमांड्स को निष्क्रिय करते हुए जो आधारभूत मॉडल के मतिभ्रम करने या किसी दुर्भावनापूर्ण प्रॉम्प्ट इंजेक्शन की स्थिति में नुकसान पहुंचा सकते हैं। 

AI टूल्स के साथ काम करने के बारे में और जानने के लिए, मैं सुझाव दूंगा कि देखें हमारा सर्वश्रेष्ठ मुफ्त AI टूल्स गाइड। व्यापक AI कोडिंग स्किल्स के लिए, हमारा AI-Assisted Coding for Developers कोर्स आज़माएं और वे कौशल विकसित करें जो आपके विकास वर्कफ़्लो में AI असिस्टेंट्स को अधिक विश्वसनीय भागीदार बनाते हैं। 

आप यह भी जान सकते हैं कि LangChain में LLMs, प्रॉम्प्ट्स, चेन्स और एजेंट्स का उपयोग करके AI-संचालित एप्लिकेशन कैसे बनाए जाते हैं—हमारे Developing LLM Applications with LangChain कोर्स से।