OpenClaw सेटअप

यह मार्गदर्शिका बताती है कि आपके RoqueOS सर्वर पर OpenClaw एजेंट को कैसे स्थापित और कॉन्फ़िगर किया जाए।

---

पूर्वापेक्षाएँ (Prerequisites)

पूर्वापेक्षाएँ

• RoqueOS सर्वर स्थापित और चालू है (इंस्टॉलेशन देखें)
• सॉकेट (/var/run/docker.sock) तक पहुंच के साथ Docker
• AI प्रदाता (OpenAI या Anthropic) से API कुंजी (Key)
• सर्वर पर न्यूनतम 4 GB RAM (8 GB अनुशंसित)

---

1. OpenClaw इमेज डाउनलोड करें

OpenClaw एक अलग Docker कंटेनर के रूप में चलता है। आधिकारिक छवि (image) डाउनलोड करें:

docker pull roqueribeiro1988/roqueos-openclaw:latest

छवि में शामिल हैं:

• Ubuntu 22.04
• XFCE डेस्कटॉप
• TigerVNC + noVNC
• Chromium ब्राउज़र
• Node.js 20
• OpenClaw एजेंट

---

2. API Key कॉन्फ़िगर करें

अपने RoqueOS सर्वर की docker-compose.yml फ़ाइल में, अपनी AI कुंजी के लिए पर्यावरण चर (environment variables) जोड़ें:

OpenAI

services:
  roqueos-server:
    image: roqueribeiro1988/roqueos-server:latest
    environment:
      - TZ=Asia/Kolkata
      - OPENAI_API_KEY=sk-your-key-here

Anthropic

services:
  roqueos-server:
    image: roqueribeiro1988/roqueos-server:latest
    environment:
      - TZ=Asia/Kolkata
      - ANTHROPIC_API_KEY=sk-ant-your-key-here

सुरक्षा (SECURITY)

सार्वजनिक रिपॉजिटरी में कभी भी अपनी API कुंजियों (keys) को कमिट (commit) न करें। रहस्यों (secrets) को स्टोर करने के लिए एक .env फ़ाइल का उपयोग करें और इसे कंपोज़ फ़ाइल में env_file: .env के साथ संदर्भित करें।

.env फ़ाइल के साथ उदाहरण:

# .env (git में कमिट न करें!)
OPENAI_API_KEY=sk-your-key-here

# docker-compose.yml
services:
  roqueos-server:
    env_file:
      - .env

---

3. कॉन्फ़िगरेशन सत्यापित करें

docker compose down && docker compose up -d के साथ सर्वर को पुनरारंभ (restarting) करने के बाद, सत्यापित करें कि एजेंट मॉड्यूल सुलभ है:

curl http://localhost:27021/agent/sessions

अपेक्षित प्रतिक्रिया (Expected response):

[]

---

4. फ्रंटएंड में एजेंट तक पहुंचें

1. RoqueOS खोलें और सुनिश्चित करें कि आप सर्वर से जुड़े हैं।
2. लॉन्चपैड में, AI Agent ऐप (OpenClaw आइकन) खोजें।
3. ऐप चैट इंटरफ़ेस और डेस्कटॉप पूर्वावलोकन (preview) पैनल के साथ खुलेगा।

---

उपयोग किए गए पोर्ट्स

पोर्ट	प्रोटोकॉल	विवरण
27021	HTTP/WS	RoqueOS सर्वर API और WebSocket
5901	VNC	OpenClaw कंटेनर का डेस्कटॉप VNC
6080	HTTP	noVNC (डेस्कटॉप तक वेब पहुंच)

पोर्ट 5901 और 6080 सर्वर द्वारा आंतरिक रूप से प्रबंधित किए जाते हैं और उन्हें बाहरी रूप से उजागर करने की आवश्यकता नहीं होती है।

---

उपलब्ध पर्यावरण चर (Environment Variables)

चर (Variable)	विवरण	डिफ़ॉल्ट
OPENAI_API_KEY	OpenAI API Key	—
ANTHROPIC_API_KEY	Anthropic API Key	—
AGENT_MAX_SESSIONS	अधिकतम समवर्ती सत्र (concurrent sessions)	3
AGENT_TIMEOUT	सत्र टाइमआउट मिनटों में	30

---

अगले कदम

• OpenClaw का उपयोग कैसे करें — व्यावहारिक मार्गदर्शिका और उदाहरण