OpenClaw का उपयोग कैसे करें
RoqueOS के स्वायत्त AI एजेंट का अधिकतम लाभ उठाने के लिए व्यावहारिक गाइड।
एजेंट इंटरफ़ेस
AI एजेंट ऐप मुख्य रूप से दो क्षेत्रों में विभाजित है:
- चैट पैनल (बाएं) — जहां आप संदेश भेजते हैं और प्रतिक्रियाओं की निगरानी करते हैं
- डेस्कटॉप विज़ुअलाइज़ेशन (दाएं) — एजेंट कंटेनर में क्या कर रहा है इसका लाइव स्ट्रीम
Steps पैनल
चैट के नीचे, एक रीयल-टाइम Steps पैनल एजेंट द्वारा निष्पादित प्रत्येक क्रिया दिखाता है: URL पर नेविगेट करना, किसी तत्व पर क्लिक करना, कमांड निष्पादित करना, आदि।
सत्र बनाना
एजेंट के साथ प्रत्येक बातचीत एक सत्र बनाती है — एक समर्पित Linux डेस्कटॉप के साथ एक पृथक Docker कंटेनर। शुरू करने के लिए:
- Launchpad में AI एजेंट ऐप खोलें।
- नया सत्र पर क्लिक करें।
- कंटेनर प्रारंभ किया जाएगा (पहली बार 10-30 सेकंड लग सकते हैं)।
- जब डेस्कटॉप दाएं पैनल में दिखाई दे, तो एजेंट तैयार है।
कार्य भेजना
प्रॉम्प्ट के लिए सर्वोत्तम प्रथाएं
कार्य का वर्णन करते समय विशिष्ट और वस्तुनिष्ठ रहें। आप जितना अधिक संदर्भ प्रदान करेंगे, परिणाम उतना ही बेहतर होगा।
❌ अस्पष्ट:
Docker के बारे में शोध करें✅ विशिष्ट:
Docker Compose v2 और v3 के बीच 5 मुख्य अंतरों पर शोध करें,
बिंदुओं का सारांश देने वाली एक markdown फ़ाइल बनाएं और /home/user/docker-comparison.md पर सहेजेंकार्यों के उदाहरण
अनुसंधान और दस्तावेज़ीकरण:
hetzner.com साइट पर जाएं, उपलब्ध VPS योजनाएं खोजें
और CSV में कीमतों और संसाधनों की तुलना तालिका बनाएं।फ़ॉर्म स्वचालन:
[URL] पर पंजीकरण फ़ॉर्म को निम्न डेटा के साथ भरें:
नाम: João Silva, ईमेल: joao@exemplo.com, योजना: बेसिकविकास:
एक Python स्क्रिप्ट बनाएं जो Hacker News के समाचार शीर्षकों को स्क्रैप करे
और शीर्ष 10 को JSON फ़ाइल में सहेजे।साइट विश्लेषण:
इस GitHub रिपॉजिटरी [URL] पर जाएं, README पढ़ें और मुझे समझाएं
कि प्रोजेक्ट क्या करता है और इंस्टॉलेशन की पूर्व-आवश्यकताएं क्या हैं।एजेंट आपके RoqueOS में जो क्रियाएं करता है
RoqueClaw पृथक कंटेनर में फंसा नहीं रहता — यह roqueos-cli CLI के माध्यम से आपके RoqueOS डेस्कटॉप पर सीधे काम करता है जो एजेंट के कंटेनर और सर्वर के प्रत्येक उपयोगकर्ता के Terminal ऐप कंटेनर दोनों में पूर्व-स्थापित है।
6 कैनोनिकल क्रियाएं
| CLI कमांड | यह क्या करता है | प्रॉम्प्ट का उदाहरण जो ट्रिगर करता है |
|---|---|---|
roqueos-cli notify "title" "msg" | आपके डेस्कटॉप पर अधिसूचना | "जब समाप्त हो तो मुझे बताएं" |
roqueos-cli open-app <id> | Launchpad में ऐप खोलें | "VS Code खोलें" |
roqueos-cli open-url <url> | Roque Browser में URL खोलें | "प्रोजेक्ट का GitHub खोलें" |
roqueos-cli create-file <path> | फ़ाइल लिखें (stdin पढ़ता है) | "इस सारांश को Notes में सहेजें" |
roqueos-cli run-terminal <cmd> | कमांड निष्पादित करें + आउटपुट दें | "मेरे पास कितना खाली डिस्क है दिखाएं" |
roqueos-cli show-dialog "msg" | पुष्टि मोडल (रुकता है, इंतजार) | "हटाने से पहले पूछें" |
आप CLI सीधे भी उपयोग कर सकते हैं (एजेंट के बिना)
CLI प्रत्येक उपयोगकर्ता के Terminal ऐप (पृथक Ubuntu कंटेनर) में उपलब्ध है। Launchpad में Terminal खोलें, roqueos-cli --help टाइप करें और सीधे उपयोग करें।
सामान्य उपयोग के मामले:
# बैकअप स्क्रिप्ट से त्वरित अधिसूचना
./backup.sh && roqueos-cli notify "बैकअप OK" "23 GB समन्वयित"
# जब बिल्ड समाप्त हो तो शेल से सीधे VS Code खोलें
yarn build && roqueos-cli open-app vscode
# Cron जो चेतावनी देता है जब डिस्क 80% से अधिक हो जाती है
0 9 * * * df -h | awk '$5+0 > 80 {system("roqueos-cli notify \"डिस्क भर गई\" \"" $6 " " $5 "\"")}'
# Python स्क्रिप्ट उपयोगकर्ता की फ़ाइलों में सीधे लिखती है
echo "$(date): meeting notes" | roqueos-cli create-file "/home/user/notes/reuniao-$(date +%F).md"
# Plex कंटेनर ट्रांसकोड समाप्त होने पर सूचित करता है
# (Plex कंटेनर के अंदर, यदि roqueos-server नेटवर्क साझा करता है)
roqueos-cli notify "Plex" "फ़िल्म X का 4K ट्रांसकोड पूरा हुआ"प्राकृतिक भाषा के माध्यम से कंटेनर इंस्टॉल करें (छिपी शक्ति)
एजेंट का सबसे अधिक उपयोग होने वाला क्रिया: roqueos-cli → सर्वर API → appsService.installApp के माध्यम से सीधे कैटलॉग से Docker ऐप्स इंस्टॉल करें।
आप कहते हैं: "Nextcloud इंस्टॉल करें, 2GB RAM, और तैयार होने पर खोलें"
एजेंट करता है (आप VNC के माध्यम से लाइव देखते हैं):
- कैटलॉग में
nextcloudकी पहचान करता है roqueos-cli→ POST/apps/installकोappId: nextcloud, memory: 2048के साथ कॉल करता है- कंटेनर शुरू होने + हेल्थचेक का इंतजार करता है
roqueos-cli open-url http://localhost:<आवंटित_पोर्ट>को कॉल करता है- "Nextcloud तैयार, प्रारंभिक लॉगिन admin/admin" को सूचित करता है
विज़ुअल App Store के समान API — बस आपको नेविगेट/क्लिक करने की आवश्यकता नहीं है। इसके लिए उपयोगी:
- बड़े पैमाने पर सेटअप: "Plex, Sonarr, Radarr, Bazarr और qBittorrent इंस्टॉल करें। सभी को
/mediaस्टोरेज का उपयोग करने के लिए कॉन्फ़िगर करें।" - संपूर्ण स्टैक: "MariaDB और phpMyAdmin के साथ एक LAMP स्टैक शुरू करें"
- पुनर्प्राप्ति: "क्रैश से पहले मेरे पास जो भी ऐप्स थे, सभी को पुनर्स्थापित करें"
सत्र प्रबंधन
सक्रिय सत्र
सभी सक्रिय सत्र ऐप के शीर्ष पर सूचीबद्ध हैं। आप कर सकते हैं:
- पिछले सत्र पर क्लिक करके इसे फिर से शुरू करें
- सर्वर संसाधनों को मुक्त करने के लिए सत्र समाप्त करें
एक साथ सत्र सीमा
डिफ़ॉल्ट रूप से, सर्वर अधिकतम 3 एक साथ सत्रों की अनुमति देता है (AGENT_MAX_SESSIONS के माध्यम से कॉन्फ़िगर करने योग्य)। RAM बचाने के लिए, जिन सत्रों का अब उपयोग नहीं कर रहे हैं उन्हें समाप्त करें।
स्क्रीनशॉट और फुलस्क्रीन
- स्क्रीनशॉट — एजेंट के डेस्कटॉप की वर्तमान स्थिति को कैप्चर करने के लिए कैमरा आइकन पर क्लिक करें
- फुलस्क्रीन — विज़ुअल कार्यों को बेहतर ढंग से ट्रैक करने के लिए डेस्कटॉप विज़ुअलाइज़ेशन को फुलस्क्रीन में विस्तारित करें
ज्ञात सीमाएं
- एजेंट पृथक वातावरण में काम करता है — चैट के माध्यम से जानकारी प्रदान करने के अलावा आपकी स्थानीय फ़ाइलों तक सीधी पहुंच नहीं है
- खातों में लॉगिन की आवश्यकता वाले कार्यों (ईमेल, सोशल नेटवर्क) के लिए आपको बातचीत के दौरान क्रेडेंशियल प्रदान करने की आवश्यकता है
- डिफ़ॉल्ट टाइमआउट 30 मिनट की निष्क्रियता है — बहुत लंबे कार्यों के लिए आवधिक बातचीत की आवश्यकता हो सकती है
समस्या निवारण
एजेंट प्रतिक्रिया नहीं करता
- सत्यापित करें कि सर्वर ऑनलाइन है:
curl http://localhost:27021/health - पुष्टि करें कि API कुंजी सही ढंग से कॉन्फ़िगर की गई है
- वर्तमान सत्र को समाप्त करें और एक नया बनाएं
डेस्कटॉप पैनल में दिखाई नहीं देता
कंटेनर अभी भी प्रारंभ हो रहा हो सकता है। 30 सेकंड प्रतीक्षा करें और ऐप को पुनः लोड करें।
धीमी या अधूरी प्रतिक्रियाएं
यह AI प्रदाता की दर सीमा का मुद्दा हो सकता है। थोड़ी देर प्रतीक्षा करें और फिर से प्रयास करें, या कार्य की जटिलता कम करें।