nanoclaw v2.1.54

एक AI सहायक जो एजेंटों को उनके अपने कंटेनरों में सुरक्षित रूप से चलाता है। हल्का, समझने में आसान और आपकी आवश्यकताओं के अनुसार पूरी तरह अनुकूलित करने के लिए बनाया गया।

nanoclaw.dev  •   docs  •   中文  •   日本語  •   한국어  •     •  

मैंने NanoClaw क्यों बनाया

OpenClaw एक प्रभावशाली प्रोजेक्ट है, लेकिन अगर मैंने ऐसा जटिल सॉफ़्टवेयर, जिसे मैं समझता नहीं, को अपने जीवन तक पूरी पहुँच दे दी होती तो मैं सो नहीं पाता। OpenClaw में लगभग पाँच लाख लाइनें कोड, 53 कॉन्फ़िग फ़ाइलें और 70+ निर्भरताएँ हैं। इसकी सुरक्षा एप्लिकेशन स्तर पर है (अनुमति सूचियाँ, पेयरिंग कोड) न कि वास्तविक OS-स्तरीय अलगाव पर। सब कुछ एक Node प्रक्रिया में साझा मेमोरी के साथ चलता है।

NanoClaw वही मूल कार्यक्षमता प्रदान करता है, लेकिन एक कोडबेस में जो समझने के लिए पर्याप्त छोटा है: एक प्रक्रिया और कुछ फ़ाइलें। एजेंट अपने स्वयं के Linux कंटेनरों में फ़ाइलसिस्टम अलगाव के साथ चलते हैं, न कि केवल अनुमति जाँच के पीछे।

त्वरित आरंभ

git clone https://github.com/nanocoai/nanoclaw.git nanoclaw-v2
cd nanoclaw-v2
bash nanoclaw.sh

nanoclaw.sh आपको एक नई मशीन से लेकर एक नामित एजेंट तक ले जाता है जिसे आप संदेश भेज सकते हैं। यदि Node, pnpm और Docker मौजूद नहीं हैं तो यह उन्हें स्थापित करता है, OneCLI के साथ आपका Anthropic क्रेडेंशियल पंजीकृत करता है, एजेंट कंटेनर बनाता है, और आपका पहला चैनल (Telegram, Discord, WhatsApp, या स्थानीय CLI) जोड़ता है। यदि कोई चरण विफल होता है, तो Claude Code स्वचालित रूप से आमंत्रित किया जाता है ताकि निदान करे और जहाँ से टूटा था वहाँ से फिर से शुरू करे।

git clone https://github.com/nanocoai/nanoclaw.git nanoclaw-v2
cd nanoclaw-v2
bash migrate-v2.sh

दर्शन

समझने के लिए पर्याप्त छोटा। एक प्रक्रिया, कुछ स्रोत फ़ाइलें और कोई माइक्रोसर्विस नहीं। यदि आप पूर्ण NanoClaw कोडबेस को समझना चाहते हैं, तो बस Claude Code से इसे आपको समझाने के लिए कहें।

अलगाव द्वारा सुरक्षित। एजेंट Linux कंटेनरों में चलते हैं और केवल वही देख सकते हैं जो स्पष्ट रूप से माउंट किया गया है। Bash तक पहुँच सुरक्षित है क्योंकि कमांड कंटेनर के अंदर चलते हैं, आपके होस्ट पर नहीं।

व्यक्तिगत उपयोगकर्ता के लिए बनाया गया। NanoClaw एक एकीकृत ढाँचा नहीं है; यह ऐसा सॉफ़्टवेयर है जो प्रत्येक उपयोगकर्ता की सटीक आवश्यकताओं के अनुरूप होता है। ब्लोटवेयर बनने के बजाय, NanoClaw को bespoke (अनुकूलित) बनाने के लिए डिज़ाइन किया गया है। आप अपना खुद का फोर्क बनाते हैं और Claude Code को इसे आपकी आवश्यकताओं के अनुसार संशोधित करने देते हैं।

अनुकूलन = कोड परिवर्तन। कोई कॉन्फ़िगरेशन फैलाव नहीं। अलग व्यवहार चाहिए? कोड को संशोधित करें। कोडबेस इतना छोटा है कि बदलाव करना सुरक्षित है।

AI-मूल, हाइब्रिड डिज़ाइन। इंस्टॉल और ऑनबोर्डिंग प्रवाह एक अनुकूलित स्क्रिप्टेड पथ है, तेज़ और नियतात्मक। जब किसी चरण में निर्णय की आवश्यकता होती है, चाहे वह असफल इंस्टॉल हो, एक निर्देशित निर्णय हो, या एक अनुकूलन हो, नियंत्रण सहजता से Claude Code को सौंप दिया जाता है। सेटअप से परे कोई निगरानी डैशबोर्ड या डीबगिंग UI भी नहीं है: समस्या का वर्णन चैट में करें और Claude Code इसे संभाल लेता है।

सुविधाओं पर कौशल। Trunk रजिस्ट्री और बुनियादी ढाँचा भेजता है, विशिष्ट चैनल एडेप्टर या वैकल्पिक एजेंट प्रदाता नहीं। चैनल (Discord, Slack, Telegram, WhatsApp, …) एक लंबे समय तक चलने वाली channels शाखा पर रहते हैं; वैकल्पिक प्रदाता (OpenCode, Ollama) providers पर रहते हैं। आप /add-telegram, /add-opencode, आदि चलाते हैं और कौशल आपके फोर्क में आपकी ज़रूरत के मॉड्यूल को कॉपी करता है। कोई ऐसी सुविधा नहीं जो आपने नहीं माँगी।

सर्वश्रेष्ठ हार्नेस, सर्वश्रेष्ठ मॉडल। NanoClaw मूल रूप से Anthropic के आधिकारिक Claude Agent SDK के माध्यम से Claude Code का उपयोग करता है, इसलिए आपको नवीनतम Claude मॉडल और Claude Code का पूर्ण टूलसेट मिलता है, जिसमें आपके स्वयं के NanoClaw फोर्क को संशोधित और विस्तारित करने की क्षमता शामिल है। अन्य प्रदाता ड्रॉप-इन विकल्प हैं: OpenAI के Codex के लिए /add-codex (ChatGPT सदस्यता या API कुंजी), OpenRouter, Google, DeepSeek और अधिक के लिए OpenCode के माध्यम से /add-opencode, और स्थानीय ओपन-वेट मॉडल के लिए /add-ollama-provider। प्रदाता प्रति-एजेंट-समूह कॉन्फ़िगर करने योग्य है।

यह क्या समर्थन करता है

• मल्टी-चैनल मैसेजिंग — WhatsApp, Telegram, Discord, Slack, Microsoft Teams, iMessage, Matrix, Google Chat, Webex, Linear, GitHub, WeChat, और Resend के माध्यम से ईमेल। /add-<channel> कौशल के साथ माँग पर स्थापित। एक साथ एक या अनेक चलाएँ।
• लचीला अलगाव — प्रत्येक चैनल को पूर्ण गोपनीयता के लिए अपने स्वयं के एजेंट से जोड़ें, अलग-अलग वार्तालापों के साथ एकीकृत मेमोरी के लिए कई चैनलों पर एक एजेंट साझा करें, या कई चैनलों को एक ही साझा सत्र में मोड़ें ताकि एक वार्तालाप कई सतहों पर फैले। /manage-channels के माध्यम से प्रति-चैनल चुनें। docs/isolation-model.md देखें।
• प्रति-एजेंट कार्यक्षेत्र — प्रत्येक एजेंट समूह का अपना CLAUDE.md, अपनी स्वयं की मेमोरी, अपना स्वयं का कंटेनर, और केवल वे माउंट होते हैं जिन्हें आप अनुमति देते हैं। जब तक आप इसे वायर न करें, कुछ भी सीमा पार नहीं करता।
• निर्धारित कार्य: एजेंट द्वारा निष्पादित आवर्ती कार्य, वैकल्पिक स्क्रिप्ट गेट्स के साथ जो काम न होने पर एजेंट को जगाने से बचते हैं
• वेब पहुँच — वेब से खोजें और सामग्री लाएँ
• कंटेनर अलगाव — एजेंट Docker कंटेनरों में सैंडबॉक्स किए जाते हैं (macOS/Linux/WSL2)
• क्रेडेंशियल सुरक्षा — एजेंट कभी भी कच्ची API कुंजियाँ नहीं रखते। आउटबाउंड अनुरोध OneCLI's Agent Vault के माध्यम से रूट करते हैं, जो अनुरोध समय पर क्रेडेंशियल इंजेक्ट करता है और प्रति-एजेंट नीतियाँ और दर सीमाएँ लागू करता है।
• एजेंट टेम्पलेट: ncl groups create --template <ref> के माध्यम से एक पुन: प्रयोज्य बंडल से एक तैयार-टू-रन एजेंट (निर्देश + MCP टूल + कौशल, कोई रहस्य नहीं) स्टैम्प करें। टेम्पलेट स्थानीय templates/ फ़ोल्डर से लोड होते हैं; इसे हाथ से या सार्वजनिक लाइब्रेरी से कॉपी करके भरें। docs/templates.md देखें।

उपयोग

अपने सहायक से ट्रिगर शब्द (डिफ़ॉल्ट: @Andy) के साथ बात करें:

@Andy send an overview of the sales pipeline every weekday morning at 9am (has access to my Obsidian vault folder)
@Andy review the git history for the past week each Friday and update the README if there's drift
@Andy every Monday at 8am, compile news on AI developments from Hacker News and TechCrunch and message me a briefing

आप जिस चैनल के स्वामी या प्रशासक हैं, वहाँ से आप समूहों और कार्यों का प्रबंधन कर सकते हैं:

@Andy list all scheduled tasks across groups
@Andy pause the Monday briefing task
@Andy join the Family Chat group

अनुकूलन

NanoClaw कॉन्फ़िगरेशन फ़ाइलों का उपयोग नहीं करता। परिवर्तन करने के लिए, बस Claude Code को बताएँ कि आप क्या चाहते हैं:

• "Change the trigger word to @Bob"
• "Remember in the future to make responses shorter and more direct"
• "Add a custom greeting when I say good morning"
• "Store conversation summaries weekly"

या निर्देशित परिवर्तनों के लिए /customize चलाएँ।

कोडबेस इतना छोटा है कि Claude सुरक्षित रूप से इसे संशोधित कर सकता है।

योगदान

सुविधाएँ न जोड़ें। कौशल जोड़ें।

यदि आप एक नया चैनल या एजेंट प्रदाता जोड़ना चाहते हैं, तो इसे trunk में न जोड़ें। नए चैनल एडेप्टर channels शाखा पर उतरते हैं; नए एजेंट प्रदाता providers पर उतरते हैं। उपयोगकर्ता /add-<name> कौशल के साथ उन्हें अपने स्वयं के फोर्क में स्थापित करते हैं, जो प्रासंगिक मॉड्यूल को मानक पथों पर कॉपी करते हैं, पंजीकरण वायर करते हैं, और निर्भरताओं को पिन करते हैं।

यह trunk को शुद्ध रजिस्ट्री और बुनियादी ढाँचे के रूप में रखता है, और प्रत्येक फोर्क दुबला रहता है — उपयोगकर्ताओं को वे चैनल और प्रदाता मिलते हैं जो उन्होंने माँगे और कुछ नहीं।

RFS (कौशल के लिए अनुरोध)

वर्तमान में किसी चैनल या प्रदाता कौशल का अनुरोध नहीं किया गया है — कृपया एक मुद्दे के माध्यम से प्रस्ताव करें।

आवश्यकताएँ

• macOS या Linux (WSL2 के माध्यम से Windows)
• Node.js 20+ और pnpm 10+ (यदि गायब हैं तो इंस्टॉलर दोनों स्थापित करेगा)
• Docker Desktop (macOS/Windows) या Docker Engine (Linux)
• /customize, /debug, सेटअप के दौरान त्रुटि पुनर्प्राप्ति, और सभी /add-<channel> कौशल के लिए Claude Code

आर्किटेक्चर

messaging apps → host process (router) → inbound.db → container (Bun, Claude Agent SDK) → outbound.db → host process (delivery) → messaging apps

एक एकल Node होस्ट प्रति-सत्र एजेंट कंटेनरों का संचालन करता है। जब कोई संदेश आता है, होस्ट इसे एंटिटी मॉडल (उपयोगकर्ता → मैसेजिंग ग्रुप → एजेंट ग्रुप → सत्र) के माध्यम से रूट करता है, इसे सत्र के inbound.db में लिखता है, और कंटेनर को जगाता है। कंटेनर के अंदर एजेंट-रनर inbound.db को पोल करता है, एजेंट चलाता है, और प्रतिक्रियाओं को outbound.db में लिखता है। होस्ट outbound.db को पोल करता है और चैनल एडेप्टर के माध्यम से वापस भेजता है।

प्रति सत्र दो SQLite फ़ाइलें, प्रत्येक में एक लेखक — कोई क्रॉस-माउंट विवाद नहीं, कोई IPC नहीं, कोई stdin पाइपिंग नहीं। चैनल और वैकल्पिक प्रदाता स्टार्टअप पर स्व-पंजीकृत होते हैं; trunk रजिस्ट्री और Chat SDK ब्रिज भेजता है, जबकि एडेप्टर स्वयं प्रति-फोर्क कौशल-स्थापित होते हैं।

पूर्ण आर्किटेक्चर विवरण के लिए docs/architecture.md देखें; तीन-स्तरीय अलगाव मॉडल के लिए docs/isolation-model.md देखें।

मुख्य फ़ाइलें:

• src/index.ts — प्रवेश बिंदु: DB आरंभीकरण, चैनल एडेप्टर, डिलीवरी पोल, स्वीप
• src/router.ts — इनबाउंड रूटिंग: मैसेजिंग ग्रुप → एजेंट ग्रुप → सत्र → inbound.db
• src/delivery.ts — outbound.db को पोल करता है, एडेप्टर के माध्यम से डिलीवर करता है, सिस्टम क्रियाओं को संभालता है
• src/host-sweep.ts — 60 सेकंड स्वीप: स्टेल डिटेक्शन, देय-संदेश जागरण, पुनरावृत्ति
• src/session-manager.ts — सत्रों को हल करता है, inbound.db / outbound.db खोलता है
• src/container-runner.ts — प्रति-एजेंट-समूह कंटेनर उत्पन्न करता है, OneCLI क्रेडेंशियल इंजेक्शन
• src/db/ — केंद्रीय DB (उपयोगकर्ता, भूमिकाएँ, एजेंट समूह, मैसेजिंग समूह, वायरिंग, माइग्रेशन)
• src/channels/ — चैनल एडेप्टर बुनियादी ढाँचा (एडेप्टर /add-<channel> कौशल के माध्यम से स्थापित)
• src/providers/ — होस्ट-पक्ष प्रदाता कॉन्फ़िग (claude बेक्ड; अन्य कौशल के माध्यम से)
• container/agent-runner/ — Bun एजेंट-रनर: पोल लूप, MCP टूल, प्रदाता एब्स्ट्रैक्शन
• groups/<folder>/ — प्रति-एजेंट-समूह फ़ाइलसिस्टम (CLAUDE.md, कौशल, कंटेनर कॉन्फ़िग)

अक्सर पूछे जाने वाले प्रश्न

Docker क्यों?

Docker क्रॉस-प्लेटफ़ॉर्म समर्थन (macOS, Linux और WSL2 के माध्यम से Windows) और एक परिपक्व पारिस्थितिकी तंत्र प्रदान करता है।

क्या मैं इसे Linux या Windows पर चला सकता हूँ?

हाँ। Docker डिफ़ॉल्ट रनटाइम है और macOS, Linux और Windows (WSL2 के माध्यम से) पर काम करता है। बस bash nanoclaw.sh चलाएँ।

क्या यह सुरक्षित है?

एजेंट कंटेनरों में चलते हैं, एप्लिकेशन-स्तरीय अनुमति जाँच के पीछे नहीं। वे केवल स्पष्ट रूप से माउंट की गई निर्देशिकाओं तक पहुँच सकते हैं। क्रेडेंशियल कभी कंटेनर में प्रवेश नहीं करते — आउटबाउंड API अनुरोध OneCLI's Agent Vault के माध्यम से रूट करते हैं, जो प्रॉक्सी स्तर पर प्रमाणीकरण इंजेक्ट करता है और दर सीमाओं और पहुँच नीतियों का समर्थन करता है। आपको अभी भी समीक्षा करनी चाहिए कि आप क्या चला रहे हैं, लेकिन कोडबेस इतना छोटा है कि आप वास्तव में कर सकते हैं। पूर्ण सुरक्षा मॉडल के लिए सुरक्षा दस्तावेज़ीकरण देखें।

कॉन्फ़िगरेशन फ़ाइलें क्यों नहीं?

हम कॉन्फ़िगरेशन फैलाव नहीं चाहते। प्रत्येक उपयोगकर्ता को NanoClaw को अनुकूलित करना चाहिए ताकि कोड वही करे जो वे चाहते हैं, एक सामान्य प्रणाली को कॉन्फ़िगर करने के बजाय। यदि आप कॉन्फ़िग फ़ाइलें पसंद करते हैं, तो आप Claude को उन्हें जोड़ने के लिए कह सकते हैं।

क्या मैं तृतीय-पक्ष या ओपन-सोर्स मॉडल का उपयोग कर सकता हूँ?

हाँ। समर्थित पथ /add-opencode (OpenRouter, OpenAI, Google, DeepSeek, और अधिक OpenCode कॉन्फ़िग के माध्यम से) या /add-ollama-provider (Ollama के माध्यम से स्थानीय ओपन-वेट मॉडल) है। दोनों प्रति-एजेंट समूह कॉन्फ़िगर करने योग्य हैं, इसलिए विभिन्न एजेंट एक ही इंस्टॉल में विभिन्न बैकएंड पर चल सकते हैं।

एक-बार के प्रयोगों के लिए, कोई भी Claude API-संगत एंडपॉइंट .env के माध्यम से भी काम करता है:

ANTHROPIC_BASE_URL=https://your-api-endpoint.com
ANTHROPIC_AUTH_TOKEN=your-token-here

मैं समस्याओं को कैसे डीबग करूँ?

Claude Code से पूछें। "Why isn't the scheduler running?" "What's in the recent logs?" "Why did this message not get a response?" यह AI-मूल दृष्टिकोण है जो NanoClaw के अंतर्गत है।

सेटअप मेरे लिए काम क्यों नहीं कर रहा है?

यदि कोई चरण विफल होता है, nanoclaw.sh निदान और पुनर्प्रारंभ के लिए Claude Code को सौंपता है। यदि यह हल नहीं होता है, तो claude चलाएँ, फिर /debug। यदि Claude किसी ऐसी समस्या की पहचान करता है जो अन्य उपयोगकर्ताओं को प्रभावित करने की संभावना है, तो प्रासंगिक सेटअप चरण या कौशल के विरुद्ध एक PR खोलें।

मैं NanoClaw को कैसे अनइंस्टॉल करूँ?

bash nanoclaw.sh --uninstall

प्रत्येक इंस्टॉल को एक प्रति-चेकआउट आईडी के साथ टैग किया जाता है, इसलिए अनइंस्टॉलर केवल उस प्रतिलिपि से संबंधित हटाता है: बैकग्राउंड सेवा, कंटेनर और इमेज, ऐप डेटा और लॉग, आपके एजेंटों की फ़ाइलें, और इस प्रतिलिपि के OneCLI वॉल्ट एजेंट। साझा चीज़ें — OneCLI ऐप और आपके क्रेडेंशियल, मशीन पर अन्य NanoClaw प्रतियाँ — अकेली छोड़ दी जाती हैं। यह दिखाता है कि उसे वास्तव में क्या मिला और प्रति समूह पुष्टि माँगता है; जब तक आप हाँ नहीं कहते, कुछ भी हटाया नहीं जाता। बिना कुछ बदले पूर्वावलोकन करने के लिए --dry-run का उपयोग करें, या संकेतों को छोड़ने के लिए --yes का उपयोग करें। हटाने से पहले आपका .env बैकअप किया जाता है। समाप्त करने के लिए, चेकआउट फ़ोल्डर को स्वयं हटा दें।

कोडबेस में कौन से परिवर्तन स्वीकार किए जाएँगे?

मूल विन्यास में केवल सुरक्षा सुधार, बग फिक्स और स्पष्ट सुधार स्वीकार किए जाएँगे। बस इतना ही।

बाकी सब कुछ (नई क्षमताएँ, OS संगतता, हार्डवेयर समर्थन, संवर्द्धन) को कौशल के रूप में योगदान दिया जाना चाहिए: चैनल और प्रदाता कोड channels/providers रजिस्ट्री शाखाओं पर, बाकी सब कुछ एक आत्म-निहित कौशल के रूप में। docs/customizing.md और CONTRIBUTING.md देखें।

यह आधार प्रणाली को न्यूनतम रखता है और प्रत्येक उपयोगकर्ता को अपनी स्थापना को अनुकूलित करने देता है बिना उन सुविधाओं को विरासत में लिए जो वे नहीं चाहते।

समुदाय

प्रश्न? विचार? Discord से जुड़ें।

परिवर्तन लॉग

ब्रेकिंग चेंजेस के लिए CHANGELOG.md देखें, या दस्तावेज़ीकरण साइट पर पूर्ण रिलीज़ इतिहास देखें।

लाइसेंस

MIT