zclaw

ESP32 के लिए सबसे छोटा संभव AI व्यक्तिगत सहायक।

zclaw C में लिखा गया है और ESP32 बोर्ड पर चलता है, जिसका डिफ़ॉल्ट बिल्ड पर सख्त ऑल-इन फर्मवेयर बजट लक्ष्य <= 888 KiB है। यह निर्धारित कार्य (scheduled tasks), GPIO नियंत्रण, स्थायी मेमोरी (persistent memory) और प्राकृतिक भाषा के माध्यम से कस्टम टूल संयोजन (custom tool composition) का समर्थन करता है।

888 KiB की सीमा ऑल-इन फर्मवेयर आकार है, केवल ऐप कोड नहीं। इसमें zclaw तर्क के साथ ESP-IDF/FreeRTOS रनटाइम, Wi-Fi/नेटवर्किंग, TLS/क्रिप्टो, और सर्टिफिकेट बंडल ओवरहेड शामिल है।

उपयोग करने में मज़ा, हैक करने में मज़ा।

पूर्ण दस्तावेज़ीकरण

पूर्ण गाइड और संदर्भ के लिए docs साइट का उपयोग करें।

• पूर्ण दस्तावेज़ीकरण
• स्थानीय प्रशासन कंसोल
• उपयोग के मामले: उपयोगी + मज़ेदार
• परिवर्तन लॉग (वेब)
• पूर्ण README (शब्दशः)

त्वरित आरंभ

एक-लाइन बूटस्ट्रैप (macOS/Linux):

bash <(curl -fsSL https://raw.githubusercontent.com/tnm/zclaw/main/scripts/bootstrap.sh)

पहले से क्लोन कर लिया है?

./install.sh

गैर-इंटरैक्टिव इंस्टॉल:

./install.sh -y

मुख्य आकर्षण

• Telegram या होस्टेड वेब रिले के माध्यम से चैट करें
• समय क्षेत्र-जागरूक शेड्यूल (daily, periodic, और एक-शॉट once)
• बिल्ट-इन + उपयोगकर्ता-परिभाषित उपकरण
• बिल्कुल नई बिल्ट-इन क्षमताओं के लिए, Build Your Own Tool दस्तावेज़ के माध्यम से एक फर्मवेयर टूल (C हैंडलर + रजिस्ट्री प्रविष्टि) जोड़ें।
• get_diagnostics के माध्यम से रनटाइम डायग्नोस्टिक्स (quick/runtime/memory/rates/time/all स्कोप)
• गार्डरेल के साथ GPIO, DHT और I2C नियंत्रण (जिसमें gpio_read_all, i2c_scan, i2c_read/i2c_write, और dht_read शामिल हैं)
• रिकवरी, सुरक्षित मोड और प्री-नेटवर्क ब्रिंग-अप के लिए USB स्थानीय प्रशासन कंसोल
• रीबूट के बीच स्थायी मेमोरी
• पर्सोना विकल्प: neutral, friendly, technical,

हार्डवेयर

परीक्षित लक्ष्य: ESP32, ESP32-C3, ESP32-S3, और ESP32-C6। क्लासिक ESP32-WROOM/ESP32 DevKit बोर्ड समर्थित हैं। अन्य ESP32 वेरिएंट के लिए परीक्षण रिपोर्ट का स्वागत है!

अनुशंसित स्टार्टर बोर्ड: Seeed XIAO ESP32-C3

स्थानीय डेवलपमेंट और हैकिंग

विशिष्ट तेज़ लूप:

./scripts/test.sh host
./scripts/build.sh
./scripts/flash.sh --kill-monitor /dev/cu.usbmodem1101
./scripts/provision-dev.sh --port /dev/cu.usbmodem1101
./scripts/monitor.sh /dev/cu.usbmodem1101

प्रोफ़ाइल एक बार सेट करें, फिर पुन: उपयोग करें:

./scripts/provision-dev.sh --write-template
# edit ~/.config/zclaw/dev.env
./scripts/provision-dev.sh --show-config
./scripts/provision-dev.sh

# if Telegram keeps replaying stale updates:
./scripts/telegram-clear-backlog.sh --show-config

स्थानीय डेवलपमेंट और हैकिंग गाइड में अधिक विवरण।

अन्य उपयोगी स्क्रिप्ट्स

स्थानीय प्रशासन कंसोल

जब बोर्ड सुरक्षित मोड में है, अप्रावधानित है, या LLM पथ अनुपलब्ध है, तब भी आप इसे Wi-Fi या LLM राउंड ट्रिप के बिना USB सीरियल पर संचालित कर सकते हैं।

./scripts/monitor.sh /dev/cu.usbmodem1101
# then type:
/wifi status
/wifi scan
/bootcount
/gpio all
/reboot

उपलब्ध केवल-स्थानीय कमांड:

• /gpio [all|pin|pin high|pin low]
• /diag [scope] [verbose]
• /reboot
• /wifi [status|scan]
• /bootcount
• /factory-reset confirm (विनाशकारी; NVS मिटाता है और रीबूट करता है)

पूर्ण संदर्भ: स्थानीय प्रशासन कंसोल

आकार विवरण

वर्तमान डिफ़ॉल्ट esp32 विवरण (idf.py -B build size-components से समूहित इमेज बाइट्स):

इस बिल्ड से कुल इमेज आकार 853034 बाइट्स है; पैडेड zclaw.bin 853184 बाइट्स (~833.2 KiB) है, जो 888 KiB की सीमा के तहत 56128 बाइट्स (~54.8 KiB) छोड़ता है।

विलंबता बेंचमार्किंग

रिले पथ बेंचमार्क (वेब रिले प्रोसेसिंग + डिवाइस राउंड ट्रिप शामिल है):

./scripts/benchmark.sh --mode relay --count 20 --message "ping"

प्रत्यक्ष सीरियल बेंचमार्क (होस्ट राउंड ट्रिप + पहला प्रतिक्रिया समय)। यदि फर्मवेयर METRIC request ... पंक्तियाँ लॉग करता है, तो रिपोर्ट में डिवाइस-पक्ष टाइमिंग भी शामिल है:

./scripts/benchmark.sh --mode serial --serial-port /dev/cu.usbmodem1101 --count 20 --message "ping"

लाइसेंस

MIT