AI एजेंट — RoqueClaw

"सर्वर पर Plex इंस्टॉल करें", "टर्मिनल खोलें और मुझे डिस्क उपयोग दिखाएं", "आज Hacker News पर शोध करें और Notes में सारांश बनाएं"

RoqueClaw (OpenClaw पर आधारित) आपके RoqueOS का स्वायत्त ऑपरेटर है। केवल टेक्स्ट का जवाब देने वाले चैटबॉट के विपरीत, यह आपके सर्वर और डेस्कटॉप पर वास्तविक क्रियाएं निष्पादित करता है: कंटेनर इंस्टॉल करता है, ऐप्स खोलता है, फाइल लिखता है, सूचनाएं ट्रिगर करता है, वेब नेविगेट करता है, टर्मिनल में कमांड निष्पादित करता है।

व्यावहारिक अंतर? आप कहते हैं "मुझे एक मीडिया सर्वर चाहिए" और यह Jellyfin इंस्टॉल करता है, कॉन्फ़िगर करता है, आपके ब्राउज़र में खोलता है और तैयार होने पर आपको चेतावनी देता है। आप 5 टैब खोलने, ट्यूटोरियल पढ़ने और 20 चरणों का पालन करने के बजाय।

यह क्या कर सकता है

🐳 प्राकृतिक भाषा के माध्यम से Docker कंटेनर इंस्टॉल करें

आप: "मेरे लिए Nextcloud इंस्टॉल करें, 2GB RAM के साथ"
RoqueClaw: ✓ nextcloud:latest इंस्टॉल कर रहा है...
           ✓ 2GB RAM और स्थायी वॉल्यूम कॉन्फ़िगर
           ✓ कंटेनर पोर्ट 8080 पर शुरू हुआ
           ✓ मैंने इसे आपके ब्राउज़र में खोला। प्रारंभिक लॉगिन: admin/admin

पर्दे के पीछे, यह सर्वर पर पूर्व-स्थापित roqueos-cli का उपयोग करके RoqueOS Server API को कॉल करता है (नीचे का अनुभाग देखें)। वही App Store, वही कैटलॉग, वही installApp(appId, config) — बस यह क्लिक के बजाय प्राकृतिक भाषा द्वारा ट्रिगर होता है।

💻 अपने डेस्कटॉप पर कार्य करें

• विशिष्ट ऐप्स खोलें (Finder खोलें, VS Code खोलें, google.com में ब्राउज़र खोलें)
• Files में फाइलें बनाएं (इस सारांश को /home/user/notes/reuniao.md के रूप में सहेजें)
• सूचनाएं भेजें (जब बैकअप समाप्त हो तो मुझे बताएं)
• डायलॉग दिखाएं (जारी रखने से पहले उपयोगकर्ता से पूछें कि क्या वह इस चरण को मंजूरी देता है)

🌐 वेब नेविगेट और स्वचालित करें

• अलग कंटेनर के अंदर Chromium खोलता है (आपके ब्राउज़र में नहीं — सुरक्षा)
• स्क्रैपिंग, फॉर्म भरना, फ़ाइलें डाउनलोड करना
• आपको दृश्य रूप से प्रगति ट्रैक करने देने के लिए स्क्रीनशॉट लेता है

🤖 जटिल बहु-चरण कार्य निष्पादित करें

यह एक प्रॉम्प्ट → एक प्रतिक्रिया नहीं है। यह एक स्वायत्त लूप है:

1. आप उद्देश्य का वर्णन करते हैं
2. RoqueClaw चरणों की योजना बनाता है
3. प्रत्येक चरण को निष्पादित करता है (आप VNC के माध्यम से लाइव देखते हैं)
4. यदि कुछ गलत होता है, तो समायोजित करता है और पुनः प्रयास करता है
5. अंत में, आपको किया गया कार्य + उसके द्वारा की गई कार्रवाइयों का सारांश देता है

---

आर्किटेक्चर

3 परतें:

• Frontend: noVNC के माध्यम से डेस्कटॉप का चैट + लाइव दृश्य
• Backend: सत्रों, कंटेनरों और संदेशों/चरणों की स्ट्रीम प्रबंधित करता है। CLI से कमांड प्राप्त करने और कनेक्ट किए गए फ्रंटएंड पर क्रियाएं ट्रिगर करने के लिए /agent/actions/* एंडपॉइंट्स को उजागर करता है।
• RoqueClaw कंटेनर: Ubuntu 22.04 + XFCE + VNC + Chromium + Node.js + OpenClaw + सर्वर पर वापस कॉल करने के लिए roqueos-cli पूर्व-स्थापित।

---

🔧 CLI roqueos-cli (एजेंट की शक्ति, और आपकी भी)

roqueos-cli एजेंट और RoqueOS Server के बीच चैनल है। यह दो स्थानों पर पूर्व-स्थापित है:

कहां	कौन उपयोग करता है
RoqueClaw कंटेनर (/usr/local/bin/roqueos-cli)	एजेंट अपने कार्यों को निष्पादित करते समय सबप्रोसेस के माध्यम से कॉल करता है
Terminal ऐप कंटेनर (सर्वर के प्रत्येक उपयोगकर्ता के लिए एक)	आप, शेल के माध्यम से, जब भी आपको आवश्यकता हो — एजेंट के बिना भी

इसका मतलब है कि आप एजेंट के माध्यम से जाने के बिना CLI का सीधे उपयोग भी कर सकते हैं। Terminal ऐप खोलें, roqueos-cli ... टाइप करें, बस।

उपलब्ध कमांड

Terminal ऐप में roqueos-cli --help चलाकर पूर्ण संदर्भ देखें — यह सत्य का स्रोत है। 6 कैनोनिकल क्रियाएं:

roqueos-cli notify       <title> <message>        # RoqueOS डेस्कटॉप पर अधिसूचना
roqueos-cli open-app     <appId>                  # ऐप खोलें (finder, vscode, browser, आदि)
roqueos-cli open-url     <url>                    # Roque Browser में URL खोलें
roqueos-cli create-file  <path>                   # stdin से सामग्री पढ़कर फ़ाइल बनाएं
roqueos-cli run-terminal <command>                # कमांड निष्पादित करें + stdout लौटाएं
roqueos-cli show-dialog  <message> [--type X]     # confirm/alert/info मोडल

व्यावहारिक उदाहरण:

# अपने RoqueOS डेस्कटॉप पर एक अधिसूचना भेजें
roqueos-cli notify "बैकअप पूर्ण" "Cloudflare R2 के साथ 23 GB समन्वयित"

# एक विशिष्ट ऐप खोलें
roqueos-cli open-app finder

# ब्राउज़र में एक URL खोलें
roqueos-cli open-url "https://github.com/roqueribeiro"

# एक फ़ाइल बनाएं/लिखें (stdin से पढ़ें)
echo "मीटिंग नोट्स..." | roqueos-cli create-file "/home/user/notes/reuniao.md"

# कमांड निष्पादित करें + अधिसूचना के रूप में परिणाम प्राप्त करें
roqueos-cli run-terminal "df -h"

# पुष्टि मोडल (जारी रखने से पहले उपयोगकर्ता की प्रतिक्रिया की प्रतीक्षा करता है)
roqueos-cli show-dialog "50GB पुराने लॉग हटाएं?" --type confirm

सिंटैक्स पोजिशनल आर्ग्युमेंट्स का उपयोग करता है (--title/--message फ्लैग नहीं)। यदि आपका CLI संस्करण अलग है, तो कंटेनर के अंदर apt-get install --reinstall roqueos-cli के माध्यम से अपडेट करें।

वास्तविक उपयोग के मामले

कुछ होने पर सूचित करने वाला cron स्क्रिप्ट:

# Crontab जो दैनिक चलता है और आपको डिस्क उपयोग के बारे में सूचित करता है
0 9 * * * df -h | grep -E '^/' | awk '$5+0 > 80 {print $6, $5}' | \
  xargs -I {} roqueos-cli notify "डिस्क लगभग भरी" "{}"

तैनाती कार्यप्रवाह:

# बिल्ड स्क्रिप्ट जो समाप्त होने पर VS Code में लॉग खोलती है
yarn build && roqueos-cli open-app vscode && \
  roqueos-cli notify "बिल्ड OK" "/tmp/build.log पर लॉग जांचें"

अन्य कंटेनरों के साथ एकीकरण:

# दूसरे कंटेनर के अंदर एक नौकरी (जैसे Plex ट्रांसकोडिंग) उपयोगकर्ता को सूचित करती है
roqueos-cli notify "Plex" "ट्रांसकोड 4K समाप्त। फिल्म तैयार।"

पीछे का HTTP API 75-agent-module.md (सर्वर का आंतरिक नियम) में "Actions" अनुभाग के तहत प्रलेखित है। फ्रंटएंड द्वारा WebSocket के माध्यम से उपयोग की जाने वाली समान क्रियाएं — notify, open-app, open-url, create-file, run-terminal, show-dialog।

---

समर्थित AI मॉडल

RoqueClaw मुख्य LLM प्रदाताओं के साथ काम करता है:

प्रदाता	अनुशंसित मॉडल	कॉन्फ़िगरेशन
OpenAI	GPT-4o, GPT-4-turbo	कंटेनर में OPENAI_API_KEY env var
Anthropic	Claude 3.5 Sonnet, Claude 4.6 Sonnet	ANTHROPIC_API_KEY env var

मॉडल का चुनाव क्रियाओं की गति और गुणवत्ता को प्रभावित करता है। जटिल वेब स्वचालन के लिए, Claude Sonnet 4.6 या GPT-4o आमतौर पर VNC के माध्यम से बेहतर दृश्य नियंत्रण रखते हैं।

---

वास्तविक उपयोग के मामले

परिदृश्य	कार्य	परिणाम
नया सर्वर सेटअप	"Plex, qBittorrent और Sonarr इंस्टॉल करें, उन्हें एक साथ काम करने के लिए कॉन्फ़िगर करें"	~3 मिनट में 3 कंटेनर अप + अंतर्संबंधित
अनुसंधान	"2026 के सर्वश्रेष्ठ 5 JavaScript फ्रेमवर्क का अनुसंधान करें और Notes में एक तुलनात्मक लेख बनाएं"	/home/user/notes/ में MD लेख + Finder में खोलें
निदान	"जांचें कि सर्वर धीमा क्यों है"	top, df, free, docker stats चलाता है — Notes में रिपोर्ट जनरेट करता है
स्वचालन	"कल के Google Drive बैकअप को डाउनलोड करें और /data में निकालें"	OAuth लॉगिन + डाउनलोड + tar के माध्यम से निकालें
विकास	"एक Python स्क्रिप्ट बनाएं जो मेरे API की निगरानी करे और गिरने पर मुझे चेतावनी दे"	स्क्रिप्ट /home/user/projects/ में सहेजी गई + cron कॉन्फ़िगर
स्मार्ट होम	"Home Assistant से कनेक्ट करें और मुझे दिखाएं कि कौन सी लाइटें चालू हैं"	लाइव सूची + चैट के माध्यम से बंद करने का विकल्प

---

अगले चरण

• कॉन्फ़िगरेशन — RoqueClaw को कैसे इंस्टॉल और सक्षम करें (इंस्टॉलर में --with-roqueclaw फ्लैग)
• कैसे उपयोग करें — चरण-दर-चरण ट्यूटोरियल + प्रॉम्प्ट के लिए सर्वोत्तम प्रथाएं + पूर्ण CLI कमांड