इस अनुभाग के पूर्ण होने पर .opengoat फ़ोल्डर संरचना

ये फ़ोल्डर अनुभाग 1-8 में चरण-दर-चरण बनाए जाते हैं। चिंता न करें अगर अभी यह खाली दिखे — प्रत्येक अनुभाग आवश्यक फ़ाइलें जोड़ता है।

📁 .opengoat पूर्ण फ़ोल्डर संरचना

$env:USERPROFILE\.opengoat\          ← BALIA OS होम डायरेक्टरी
├── identity\                         ← अनुभाग 2 में बनाया जाता है
│   └── team_design.md               ← टीम डिज़ाइन दस्तावेज़
├── .env                              ← अनुभाग 3 में बनाया जाता है (API कीज़ और webhook)
├── workspaces\                       ← अनुभाग 3 में बनाया जाता है
│   ├── [agentid]\                    ← अनुभाग 4 में प्रत्येक एजेंट के लिए बनाया जाता है
│   │   ├── SOUL.md
│   │   ├── AGENTS.md
│   │   ├── IDENTITY.md
│   │   ├── HEARTBEAT.md
│   │   ├── TOOLS.md
│   │   ├── USER.md
│   │   └── SPEC_[नाम].md
│   └── security-guardian\            ← अनुभाग 3 में स्वचालित रूप से तैनात
├── agents\                           ← OpenClaw कॉन्फिग फ़ाइलें अनुभाग 5 में स्वचालित रूप से जनरेट होती हैं
│   └── [agentid]
│       ├── config.json
│       └── models.json
├── memory\                           ← अनुभाग 6 में बनाया जाता है
│   └── _SKILL_STATUS.md             ← कैसेट ON/OFF सूची (एकमात्र प्रबंधन स्रोत)
└── skills\                           ← अनुभाग 6 में कैसेट जोड़े जाते हैं
    └── [cassette-name]\
        └── SKILL.md

यह फ़ोल्डर BALIA OS का "घर" है। सभी एजेंट पहचान, मेमोरी और कौशल यहाँ संग्रहीत हैं।

---

💡 API क्या है? — और आपको इसकी ज़रूरत क्यों है?

अपने AI एजेंट्स को ऐसे कर्मचारियों के रूप में सोचें जिन्हें काम करने से पहले सोचना पड़ता है।

हर बार जब कोई एजेंट किसी स्थिति का विश्लेषण करता है, रिपोर्ट लिखता है, या कोई निर्णय लेता है, तो उसे उस सोच के लिए एक AI मॉडल को कॉल करना पड़ता है। API वह चैनल है जो यह कॉल करता है — और वह ईंधन जो इसे शक्ति देता है।

Chat AI बनाम API — दो अलग-अलग चीज़ें:

	Chat AI (Claude / Gemini / ChatGPT)	API
यह क्या है	आपका निजी सहायक	आपके एजेंट्स का सोचने का इंजन
कौन उपयोग करता है	आप, सीधे	आपके एजेंट, स्वचालित रूप से
लागत मॉडल	सदस्यता (निश्चित दर)	उपयोग के अनुसार भुगतान (input + output tokens)
अनुशंसित	Paid plan — बेहतर reasoning	$5 credit से शुरू करें

दोनों क्यों चलाएं? (Hybrid setup)

API billing input + output tokens पर काम करती है — एजेंट को भेजा गया हर शब्द और उसका हर जवाब एक छोटी राशि खर्च करता है।

इसका मतलब है कि आप अपने एजेंट्स को कैसे निर्देश देते हैं, यह मायने रखता है।

अपने चैट AI (बेहतर reasoning के लिए paid plan अनुशंसित) का उपयोग करें:

• एजेंट्स को भेजने से पहले स्पष्ट, संक्षिप्त निर्देश तैयार करने के लिए
• एजेंट्स को पास करने से पहले लंबे दस्तावेज़ों का सारांश बनाने के लिए
• कार्यों को पूर्व-संरचित करने के लिए ताकि एजेंट्स यह समझने में tokens बर्बाद न करें कि आप क्या चाहते हैं

एक सुव्यवस्थित 200-token निर्देश एक अस्पष्ट 2,000-token के आगे-पीछे के संवाद की तुलना में बहुत कम खर्च करता है। आपका Chat AI रणनीतिकार है। आपके एजेंट्स कार्यकर्ता हैं। यह संयोजन API लागत को कम रखता है जबकि आउटपुट की गुणवत्ता उच्च बनाए रखता है।

शुरू करने से पहले — API लागत की पारदर्शिता

BALIA OS को आपके एजेंट्स चलाने के लिए एक AI API key की आवश्यकता है। यह $48 गाइड लागत से अलग है।

आपको क्या चाहिए:

• कम से कम $5 prepaid credits के साथ एक Anthropic account
• इस गाइड के सभी एजेंट Claude Sonnet 5 का उपयोग करते हैं

$5 शुरुआत के लिए पर्याप्त क्यों है: Claude Sonnet 5 की लागत $2 प्रति मिलियन input tokens और $10 प्रति मिलियन output tokens है (31 अगस्त 2026 तक की लॉन्च कीमत — इसके बाद यह $3 input / $15 output पर बदल जाएगी)। एक सामान्य एजेंट सत्र में कुछ हज़ार tokens का उपयोग होता है। $5 आपको अधिक खर्च करने से पहले सीखने और प्रयोग करने के लिए दर्जनों सत्र देता है।

Anthropic API के लिए कोई free tier नहीं है। क्रेडिट कार्ड आवश्यक है। Credits जोड़ें: console.anthropic.com → Billing → Add credits (न्यूनतम $5)

यह BALIA OS चलाने के लिए आवश्यक एकमात्र बाहरी लागत है। इसे परिप्रेक्ष्य में रखने के लिए: एक मानव सहायक को काम पर रखने में $2,000–$5,000 प्रति माह खर्च होता है। आपकी AI टीम शुरुआत के लिए $5 की API credits पर चलती है। वही काम। लागत का एक अंश।

---

आप क्या इंस्टॉल कर रहे हैं

इस अनुभाग के अंत तक आपके पास पाँच चीज़ें तैयार होंगी:

• VS Code — एजेंट फ़ाइलों को संपादित करने और कमांड चलाने के लिए आपका कार्यक्षेत्र
• Claude Code — VS Code के अंदर त्रुटि सुधार और फ़ाइल संपादन को स्वचालित करने वाला हाइब्रिड सेटअप का निष्पादन ज़िम्मेदार (देखें Section 1)। अगर आप चैट AI के रूप में Claude Pro उपयोग कर रहे हैं तो वही प्लान इसके लिए भी काम करता है — अतिरिक्त खरीद की ज़रूरत नहीं
• Node.js — OpenClaw चलाने के लिए आवश्यक
• OpenClaw — AI एजेंट framework जो BALIA OS को शक्ति देता है
• Anthropic API key — AI इंजन जिसे आपके एजेंट सोचने के लिए उपयोग करते हैं
• सुरक्षा अभिरक्षक — आपका स्वचालित सेटअप सहायक जो फ़ाइलें प्रबंधित करता है और आपकी कॉन्फ़िगरेशन सत्यापित करता है

यह अनुभाग कैसे काम करता है: नीचे दिए गए prompt को कॉपी करें और अपने चैट AI में पेस्ट करें। AI आपको पूरी installation के दौरान मार्गदर्शन करेगा — आपका operating system पूछेगा, प्रत्येक चरण में आपकी मदद करेगा, और कुछ भी गलत होने पर ठीक करने में सहायता करेगा। यदि आप किसी भी बिंदु पर अटक जाते हैं, तो बस AI को समस्या बताएं और वह आपकी मदद करेगा।

---

▶ शुरू करने के लिए इसे अपने AI में पेस्ट करें

आप मुझे BALIA OS इंस्टॉल और सेट अप करने में मदद कर रहे हैं — एक multi-agent AI
operating system जो OpenClaw पर बना है।

आपका काम मुझे installation के दौरान चरण-दर-चरण मार्गदर्शन करना है।
मुझसे एक समय में एक प्रश्न पूछें। आगे बढ़ने से पहले मेरे जवाब का इंतज़ार करें।
यदि मुझे कोई error आए, तो आगे बढ़ने से पहले उसे ठीक करने में मेरी मदद करें।

यहाँ वह सब कुछ है जो हमें इंस्टॉल और सेट अप करना है, क्रम में:

STEP 1 — मेरा operating system जांचें
मुझसे पूछें: "क्या आप Windows पर हैं या Mac पर?"
फिर सभी steps में मेरे OS के लिए सही निर्देश दें।

STEP 2 — VS Code इंस्टॉल करें
मुझे code.visualstudio.com से VS Code इंस्टॉल करने के लिए मार्गदर्शन करें
- Windows: installer डाउनलोड करें और चलाएं। सुनिश्चित करें कि "Add to PATH" चेक किया गया हो।
- Mac: डाउनलोड करें, unzip करें, Applications में drag करें, फिर "code" को PATH में जोड़ने के लिए shell command चलाएं:
  Cmd+Shift+P → "Shell Command: Install 'code' command in PATH"
इंस्टॉल के बाद, मुझे VS Code में terminal खोलने और यह चलाने के लिए कहें:
  code --version
मुझसे पूछें कि यह क्या दिखाता है। यदि error है, तो उसे ठीक करने में मेरी मदद करें।

STEP 2b — VS Code की डिस्प्ले भाषा बदलना (वैकल्पिक)
VS Code डिफ़ॉल्ट रूप से अंग्रेज़ी में दिखता है। अगर मैं इसे हिंदी में उपयोग करना चाहता/चाहती हूं,
तो मुझे स्पष्ट रूप से बताएं कि फ़िलहाल Microsoft का आधिकारिक VS Code भाषा पैक हिंदी में उपलब्ध नहीं है।
यह बात साफ़ बताने के बाद, मुझे यह कदम छोड़कर सीधे अगले STEP पर बढ़ने के लिए कहें।

STEP 3 — Python इंस्टॉल करें
VS Code terminal में, उपयोगकर्ता को यह चलाने के लिए कहें:
  python --version
यदि "Python 3.x.x" दिखाई देता है, तो Python पहले से इंस्टॉल है। अगले STEP पर जाएं।

यदि नहीं, तो उन्हें https://www.python.org/downloads/ से इंस्टॉल करने के लिए कहें
- Windows: installer चलाएं। "Add Python to PATH" चेक करना सुनिश्चित करें।
- Mac: installer चलाएं और defaults के साथ आगे बढ़ें।

इंस्टॉल करने के बाद, VS Code restart करें और पुष्टि करने के लिए python --version फिर से चलाएं।

STEP 4 — Node.js इंस्टॉल करें
मुझे nodejs.org से Node.js 22 या उच्चतर (LTS version) इंस्टॉल करने के लिए मार्गदर्शन करें।
इंस्टॉल के बाद, मुझे यह चलाने के लिए कहें: node --version
मुझसे पूछें कि यह क्या दिखाता है।
- यदि v22 या उच्चतर: बढ़िया, आगे बढ़ें।
- यदि v22 से कम: nvm (Mac/Linux) या nvm-windows (Windows) का उपयोग करके
  upgrade करने के लिए मार्गदर्शन करें।
- यदि error: troubleshoot करने में मेरी मदद करें।

STEP 5 — OpenClaw इंस्टॉल करें
मुझे VS Code terminal में यह चलाने के लिए मार्गदर्शन करें:
  npm install -g openclaw
फिर verify करें:
  openclaw --version
संभालने योग्य सामान्य errors:
- Mac पर EACCES: npm global prefix fix के माध्यम से मार्गदर्शन करें
- "openclaw not found": मुझे terminal बंद करके फिर से खोलने के लिए कहें, फिर से प्रयास करें

STEP 5b — Claude Code इंस्टॉल करें
पहले यह समझाएं:
"Claude Code Section 1 में बताए गए हाइब्रिड सेटअप का निष्पादन ज़िम्मेदार है।
यह VS Code के अंदर ही त्रुटियाँ पढ़ता है और फ़ाइलें ठीक करने से लेकर कमांड चलाने तक सब खुद करता है।
अगर आपके पास पहले से Claude Pro या उससे ऊपर का प्लान ($20/माह से) है, तो अलग से कुछ खरीदने की ज़रूरत नहीं —
claude.ai की चैट और Claude Code एक ही सब्सक्रिप्शन और एक ही उपयोग सीमा साझा करते हैं।
अगर आपने Section 1 में अपने चैट AI के रूप में Claude Pro चुना था, तो आप उसी अकाउंट से सीधे लॉगिन कर सकते हैं।
अगर आप चैट AI के लिए Claude के अलावा कुछ और (जैसे ChatGPT या Gemini) उपयोग कर रहे हैं,
तो Claude Code उपयोग करने के लिए अलग से Claude Pro या उससे ऊपर का प्लान, या Anthropic API access ज़रूरी होगा।"

फिर मुझे इसके लिए मार्गदर्शन करें:
1. VS Code टर्मिनल में यह चलाकर CLI इंस्टॉल करें:
     npm install -g @anthropic-ai/claude-code
2. इंस्टॉल की पुष्टि करें:
     claude --version
   पुष्टि करें कि एक वर्जन नंबर दिखता है
3. VS Code के extensions panel (Ctrl+Shift+X) में "Claude Code" (publisher: Anthropic) खोजें और
   इंस्टॉल करें
4. VS Code टर्मिनल में यह चलाकर पहली बार लॉगिन करें:
     claude
   ब्राउज़र खुलेगा — मुझे Claude Pro अकाउंट (या API key) से लॉगिन करने के लिए मार्गदर्शन करें
5. लॉगिन पूरा होने के बाद, टर्मिनल में वापस आकर पुष्टि करें कि prompt दिख रहा है

संभालने योग्य सामान्य errors:
- npm install में EACCES (permission error, Mac/Linux):
    mkdir -p ~/.npm-global
    npm config set prefix ~/.npm-global
    export PATH=~/.npm-global/bin:$PATH
  को क्रम से चलाने के बाद फिर से प्रयास करने के लिए मार्गदर्शन करें
- "claude: command not found": मुझे terminal बंद करके फिर से खोलने के लिए कहें, फिर से प्रयास करें
- लॉगिन स्क्रीन नहीं खुलती: console.anthropic.com पर वैध सब्सक्रिप्शन/API access है या नहीं जांचने के लिए कहें

STEP 6 — Anthropic API key प्राप्त करें
पहले यह समझाएं:
"BALIA OS आपके एजेंट्स के लिए default AI engine के रूप में Claude (Anthropic) का उपयोग करता है।
अभी के लिए हम केवल Claude सेट अप करते हैं। बाद में आप क्या बनाना चाहते हैं उसके आधार पर
अन्य AI engines जोड़े जा सकते हैं:
- जब आप अपना खुद का skill बनाते हैं (Section 6), तो आप उस skill के लिए सबसे अच्छा AI
  चुनेंगे — उदाहरण के लिए, YouTube के लिए Gemini क्योंकि यह सीधे वीडियो का विश्लेषण कर सकता है,
  या sales copy के लिए GPT-4o।
- BALIA Skill Market खुलने के बाद, आप अन्य उपयोगकर्ताओं द्वारा बनाए गए skills भी इंस्टॉल कर सकते हैं,
  प्रत्येक के अपने अनुशंसित AI engine के साथ।"

फिर मुझे इसके लिए मार्गदर्शन करें:
1. console.anthropic.com पर जाएं
2. Sign up करें या log in करें
3. API Keys → Create Key पर जाएं
4. इसे "balia-os" नाम दें
5. कुंजी कॉपी करें (sk-ant- से शुरू होती है)
मुझे बताएं: "इसे किसी सुरक्षित जगह सेव करें — आप इसे केवल एक बार देख सकते हैं।"
आगे बढ़ने से पहले मुझसे पुष्टि करने के लिए कहें कि मेरे पास कुंजी है।
मुझसे कुंजी चैट में पेस्ट करने के लिए न कहें।

STEP 7 — OpenClaw सेटअप चलाएं
मुझे VS Code टर्मिनल में यह चलाने के लिए मार्गदर्शन करें:
  openclaw setup
मुझे बताएं कि क्या अपेक्षा करें:
- यह मेरी Anthropic API कुंजी मांगेगा — वहाँ पेस्ट करें
- यह स्वचालित रूप से ~/.opengoat/ (Mac) या
  $env:USERPROFILE\.opengoat\ (Windows) फ़ोल्डर बनाएगा
  यह BALIA OS होम डायरेक्टरी है — सभी एजेंट फ़ाइलें यहाँ रहती हैं।
सेटअप पूरा होने के बाद, मुझे गेटवे शुरू करने के लिए यह कमांड चलाने का मार्गदर्शन करें:
  Windows: $env:DEBUG="-ciao*"; openclaw gateway --force
  Mac:     DEBUG="-ciao*" openclaw gateway --force
मुझसे पुष्टि करने के लिए कहें कि मुझे दिखता है:
  "✓ Gateway running on port 18789"
मुझे बताएं: "इस टर्मिनल टैब को खुला रखें — यह गेटवे है। भविष्य के कमांड के लिए एक नया टैब खोलें।"

फिर मुझसे पुष्टि करने के लिए कहें कि फ़ोल्डर बना:
- Windows: dir $env:USERPROFILE\.opengoat
- Mac:     ls ~/.opengoat
मुझसे पूछें: "क्या आपको .opengoat फ़ोल्डर दिखता है?"
यदि नहीं, तो समस्या निवारण में मेरी मदद करें।

STEP 9 — .env फ़ाइल बनाएं
मुझे .opengoat फ़ोल्डर के अंदर एक .env फ़ाइल बनाने के लिए मार्गदर्शन करें।
- Windows: VS Code में, $env:USERPROFILE\.opengoat फ़ोल्डर खोलें
           बाएं पैनल में राइट-क्लिक करें → New File → इसे .env नाम दें
- Mac:     VS Code में, ~/.opengoat फ़ोल्डर खोलें
           बाएं पैनल में राइट-क्लिक करें → New File → इसे .env नाम दें

फिर यह टेम्पलेट पेस्ट करें:

# BALIA OS
BALIA_TOKEN=paste-your-token-here
AGENT_ID=ceo

# Anthropic API
ANTHROPIC_API_KEY=sk-ant-paste-your-key-here

# Agent model
CLAUDE_MODEL=claude-sonnet-5

# Discord Webhooks — Section 4 के दौरान इन्हें भरें
# Example: DISCORD_WEBHOOK_MAYA=https://discord.com/api/webhooks/123456789/xxxxxxxxxxxx
DISCORD_WEBHOOK_[AGENT1NAME]=
DISCORD_WEBHOOK_[AGENT2NAME]=
DISCORD_WEBHOOK_[AGENT3NAME]=
DISCORD_WEBHOOK_[AGENT4NAME]=
DISCORD_WEBHOOK_[AGENT5NAME]=
DISCORD_WEBHOOK_SECURITY=

BALIA_TOKEN भरें:
"वह ईमेल जांचें जो आपको खरीद के बाद मिली थी।
विषय पंक्ति कहती है 'Your BALIA OS Access Token'।
टोकन (BALIA- से शुरू होता है) कॉपी करें और इसे BALIA_TOKEN= के बाद पेस्ट करें।
यह एकमात्र समय है जब आपको इसे दर्ज करना होगा —
Section 6 का इंस्टॉलर इसे इस फ़ाइल से स्वचालित रूप से पढ़ता है।
इसे इस चैट में पेस्ट न करें।"

AGENT_ID भरें:
"यह आपके CEO एजेंट की ID है — वह मुख्य एजेंट जिससे आप सबसे अधिक बात करते हैं।
ID निश्चित है: ceo। AGENT_ID=ceo को बिल्कुल वैसे ही छोड़ें जैसा ऊपर दिखता है।
इसे न बदलें। इंस्टॉल स्क्रिप्ट और Section 4 दोनों इस मान पर निर्भर हैं।"

मुझे बताएं: "अभी के लिए Discord webhooks खाली छोड़ें — आपको Section 4 में वास्तविक URLs मिलेंगे।
URL का प्रारूप इस तरह दिखता है: https://discord.com/api/webhooks/numbers/letters
[AGENT1NAME] से [AGENT5NAME] को अपने एजेंट्स के नाम UPPERCASE में बदलें।
DISCORD_WEBHOOK_SECURITY हमेशा अंत में होता है — यह Security Guardian एजेंट के लिए है।"

सुरक्षा नोट — यह कहें:
"यदि आप अपना टोकन किसी फ़ाइल में डालने में असहज हैं:
आप अभी BALIA_TOKEN छोड़ सकते हैं और Section 6 इंस्टॉलेशन के दौरान
संकेत मिलने पर इसे मैन्युअल रूप से दर्ज कर सकते हैं।"

मुझे बताएं: "यह फ़ाइल कभी साझा न करें। इसे GitHub पर कभी commit न करें।"

STEP 9b — .env फ़ाइल में API कुंजी लिखें
नोट: API कुंजी STEP 7 (openclaw setup) में पहले ही दर्ज की जा चुकी थी। समझाएं कि यहाँ इसकी भी आवश्यकता क्यों है।
कहें: "आप वही API कुंजी दो स्थानों पर सेट कर रहे हैं:
- openclaw setup इसे OpenClaw के अपने कॉन्फ़िगरेशन में संग्रहीत करता है।
- आपकी .env फ़ाइल इसे BALIA OS एजेंट्स के लिए संग्रहीत करती है — एजेंट अपनी कुंजी सीधे .env से पढ़ते हैं।
दोनों में एक ही कुंजी होनी चाहिए। यह एक बार का सेटअप है।"
मुझे इसके लिए मार्गदर्शन करें:
1. VS Code में .env फ़ाइल खोलें (यह .opengoat फ़ोल्डर में है)
2. यह लाइन खोजें: ANTHROPIC_API_KEY=sk-ant-paste-your-key-here
3. "sk-ant-paste-your-key-here" को अपनी वास्तविक कुंजी से बदलें
4. फ़ाइल सेव करें (Windows पर Ctrl+S / Mac पर Cmd+S)
पुष्टि करें: "आपकी API कुंजी अब आपकी .env फ़ाइल में सेव हो गई है।
यह फ़ाइल कभी साझा न करें या इसे GitHub पर commit न करें।"
मुझसे कुंजी चैट में पेस्ट करने के लिए न कहें।

STEP 9b पूरा होने पर, मुझे बताएं: "आपका परिवेश तैयार है। अगला हम Security Guardian सेट करेंगे — आपका स्वचालित सेटअप सहायक।"

अभी शुरू करें। मुझसे पहला सवाल पूछें।

🛡️ पहले अपना Security Guardian सेट करें

अपने agents बनाने से पहले, हम आपका Security Guardian शुरू करेंगे। इस बिंदु से, Security Guardian स्वचालित रूप से आपके सेटअप की जाँच करेगा, ज़रूरत पड़ने पर फ़ाइलें सही स्थान पर ले जाएगा और कोई भी लापता फ़ाइलें बनाएगा। आपको गलतियाँ करने की चिंता करने की ज़रूरत नहीं — Guardian आपका ख्याल रखता है।

---

🛡️ Deploy the Security Guardian

⚠️ चेतावनी: API लागत नियंत्रण से बाहर

[विदेश में एक वास्तविक घटना — BALIA OS से असंबंधित] नवंबर 2025 में, एक विदेशी विकास टीम का AI एजेंट अनंत लूप में चला गया और 11 दिनों तक बिना किसी की जानकारी के चलता रहा, जिसके परिणामस्वरूप $47,000 का API बिल आया। (स्रोत: Tech Startups / Hacker News)

AI एजेंट उपयोगकर्ता के बिना जाने APIs को कॉल करते रह सकते हैं। इस जोखिम को रोकने के लिए, Security Guardian 24/7 लागत की निगरानी करता है और असामान्यता का पता चलने पर तुरंत Discord अलर्ट भेजता है।

हमेशा निम्नलिखित भी कॉन्फ़िगर करें:

1. अपने AI प्रदाता के कंसोल में लागत अलर्ट सेट करें (अनुशंसित: $3–5/दिन) (Anthropic उपयोगकर्ताओं के लिए) → https://console.anthropic.com/settings/billing
2. Security Guardian की लागत निगरानी सेटिंग्स सत्यापित करें (Step 2.5)

Your environment is ready.

There is one more agent in BALIA OS: the Security Guardian (security-guardian).

This agent is pre-configured by BALIA. Do not change its name, ID, or paths. Doing so will break the integration with your other agents.

---

पूर्वशर्त: PM2 इंस्टॉल करें

PM2 एक Node.js प्रोसेस मैनेजर है। यह Security Guardian को PC रीस्टार्ट होने के बाद भी स्वचालित रूप से चलाता रहता है।

VS Code टर्मिनल खोलें और इंस्टॉल करने के लिए निम्न कमांड पेस्ट करें:

npm install -g pm2

यदि PM2 पहले से इंस्टॉल है तो इस चरण को छोड़ें।

---

Download and Run the Installer

💡 टोकन क्या है?

यह खरीद के बाद आपको भेजे गए एक्सेस URL में ?token= के बाद की स्ट्रिंग है।

उदाहरण: https://guide.baliaos.com/?token=BALIA-XXXX-XXXX-0001 इस स्थिति में, टोकन BALIA-XXXX-XXXX-0001 है।

यदि आपको ईमेल नहीं मिल रही, तो कृपया सपोर्ट से संपर्क करें।

Step 1 — Download the installer

In your VS Code terminal:

Windows:

Invoke-WebRequest -Uri "https://balia-os-guide.vercel.app/scripts/install_core_pack.py" -OutFile install_core_pack.py
python install_core_pack.py

Mac / Linux:

curl -o install_core_pack.py https://balia-os-guide.vercel.app/scripts/install_core_pack.py
python3 install_core_pack.py

Step 2 — Register the Security Guardian with OpenClaw

Windows:

openclaw agents add security-guardian --workspace $env:USERPROFILE\.opengoat\workspaces\security-guardian

Mac:

openclaw agents add security-guardian --workspace ~/.opengoat/workspaces/security-guardian

This registers security-guardian so OpenClaw can route commands to it.

Step 2.5 — रजिस्ट्रेशन सत्यापित करें

पुष्टि करें कि OpenClaw एजेंट देख सकता है:

openclaw agents list

आपको security-guardian सूची में दिखना चाहिए। अगर नहीं दिखता, तो Step 2 दोहराएं।

---

📋 guardian_config.json कस्टमाइज़ेशन गाइड

निम्नलिखित सेटिंग्स कभी भी बदली जा सकती हैं। फ़ाइल स्थान:

$env:USERPROFILE\.opengoat\workspaces\security-guardian\guardian_config.json

कुंजी	डिफ़ॉल्ट	विवरण
cost.alertHourly	1.0	प्रति घंटे API लागत अलर्ट ($)
cost.alertDaily	5.0	दैनिक API लागत अलर्ट ($)
rollback.threshold	6	रोलबैक ट्रिगर होने से पहले गायब फ़ाइलें
rollback.autoRecovery	true	स्वचालित रोलबैक (false = मैन्युअल अनुमोदन)
snapshot.intervalMinutes	10	स्नैपशॉट आवृत्ति (मिनट)
snapshot.maxSnapshots	3	रखे जाने वाले स्नैपशॉट की संख्या
watchdog.checkGateway	true	OpenClaw गेटवे की निगरानी
watchdog.checkWSL2	false	WSL2 की निगरानी (डिफ़ॉल्ट रूप से बंद)
scanner.runIntervalHours	4	संगरोध स्कैन आवृत्ति (घंटे)
git.autoPushEnabled	true	GitHub पर स्वचालित बैकअप
git.autoPushIntervalMinutes	30	बैकअप आवृत्ति (मिनट)

सेटिंग बदलने के बाद Security Guardian को पुनः प्रारंभ करें:

pm2 restart security-guardian

---

Step 3 — Have the Security Guardian run the installer

openclaw agent --agent security-guardian "Run: python install_core_pack.py --lang en (token loads from .env automatically). Tell me when done."

The token is read automatically from BALIA_TOKEN in your .env file.

Your agent will autonomously:

1. Authenticate your token
2. Download the Security Guardian files
3. Deploy to .opengoat/agents/security-guardian/ and .opengoat/workspaces/security-guardian/
4. Show "✓ Security Guardian deployed successfully" in the terminal

⚠️ Important: Do not change the Security Guardian's ID, name, or folder paths. Other configuration files reference this agent directly. Changing them will break the skill quarantine system.

Once the terminal shows "✓ Security Guardian deployed successfully", continue with the next step below.

INFO

agents/security-guardian/ vs workspaces/[agentid]/

BALIA OS uses two folder types for each agent:

• agents/[id]/ — OpenClaw config files (config.json, models.json) — OpenClaw reads these to launch the agent
• workspaces/[id]/ — Workspace files (SOUL, AGENTS, IDENTITY, HEARTBEAT, TOOLS, USER, SPEC) — the agent reads these at session start

The Security Guardian uses both:

• agents/security-guardian/ — config.json and models.json
• workspaces/security-guardian/ — SOUL.md, SPEC_SECURITY.md, scripts/, and more

Your custom agents use the same structure. Both folders are under $env:USERPROFILE/.opengoat/.

---

चरण 3.5 — gateway बंद करें, PM2 से Guardian शुरू करें, फिर पुनः प्रारंभ करें

इंस्टॉलेशन पूर्ण होने के बाद, gateway को सुरक्षित रूप से पुनः प्रारंभ करें।

① gateway बंद करें

उस PowerShell में जहाँ openclaw gateway चल रहा है, दबाएँ:

Ctrl + C

यदि पूछा जाए "समाप्त करें?", तो Y दबाएँ और फिर Enter।

② PM2 से Security Guardian शुरू करें

एक नया PowerShell खोलें और निम्नलिखित को एक-एक लाइन करके चलाएँ:

pm2 start $env:USERPROFILE\.opengoat\workspaces\security-guardian\scripts\security_guardian.js --name security-guardian

pm2 start $env:USERPROFILE\.opengoat\workspaces\security-guardian\scripts\watchdog.js --name guardian-watchdog

pm2 save

pm2 list

पुष्टि करें कि security-guardian और guardian-watchdog online दिखा रहे हैं।

③ gateway पुनः प्रारंभ करें

उसी PowerShell में, निम्नलिखित को एक-एक लाइन करके चलाएँ:

$env:DEBUG="-ciao*"

openclaw gateway --force

इस PowerShell विंडो को बंद न करें।

---

▶ जारी रखें: इसे अपने AI में पेस्ट करें

Security Guardian अब चल रहा है। आइए अपने workspace फ़ोल्डर बनाएं और सेटअप पूरा करें।

STEP 8 — प्रत्येक एजेंट के लिए वर्कस्पेस फ़ोल्डर बनाएं
मुझे बताएं: "मैं आपके एजेंट IDs स्वचालित रूप से प्राप्त करने के लिए
Section 2 से आपका Team Design Document पढ़ूंगा। कृपया इसे अभी संलग्न करें।"
संलग्न Team Design Document पढ़ें।
सभी 6 एजेंट नाम/IDs निकालें (लोअरकेस में बदलें, कोई स्पेस नहीं, स्पेस के लिए हाइफ़न उपयोग करें)।
मुझे सूची दिखाएं:
"मुझे ये 6 एजेंट मिले: [id1], [id2], [id3], [id4], [id5], [id6]
क्या यह सही है?"
मेरी पुष्टि की प्रतीक्षा करें।

फिर मुझे वास्तविक IDs पहले से भरे हुए सभी 6 वर्कस्पेस फ़ोल्डर एक साथ बनाने के सटीक कमांड दें।
इस फ़ोल्डर संरचना का उपयोग करें: workspaces\[id]\ (workspace-[id] नहीं)।
- Windows: cd $env:USERPROFILE\.opengoat
           mkdir workspaces\[id1] workspaces\[id2] workspaces\[id3] workspaces\[id4] workspaces\[id5] workspaces\[id6]
- Mac:     cd ~/.opengoat
           mkdir -p workspaces/[id1] workspaces/[id2] workspaces/[id3] workspaces/[id4] workspaces/[id5] workspaces/[id6]

चलाने के बाद, मुझसे पुष्टि करने के लिए कहें कि फ़ोल्डर बने:
- Windows: dir $env:USERPROFILE\.opengoat\workspaces
- Mac:     ls ~/.opengoat/workspaces

STEP 10 — अंतिम जांच
मेरे साथ इस चेकलिस्ट को एक-एक आइटम करके देखें:
□ code --version → एक वर्जन नंबर दिखाता है
□ node --version → v22 या उससे अधिक दिखाता है
□ openclaw --version → एक वर्जन नंबर दिखाता है
□ claude --version → एक वर्जन नंबर दिखाता है
□ VS Code में Claude Code एक्सटेंशन इंस्टॉल है और लॉग-इन हो चुका है
□ Gateway टर्मिनल "✓ Gateway running" दिखाता है
□ .opengoat फ़ोल्डर मौजूद है और पुष्टि हुई है
□ workspaces/ सभी 6 एजेंट्स के लिए सबफ़ोल्डर बने हैं
□ .env फ़ाइल .opengoat फ़ोल्डर में मौजूद है
□ BALIA_TOKEN भरा हुआ है (या Section 6 में मैन्युअल रूप से दर्ज करने का नोट)
□ AGENT_ID ceo पर सेट है
□ ANTHROPIC_API_KEY भरी हुई है
□ Security Guardian तैनात किया गया (टर्मिनल आउटपुट द्वारा पुष्टि)

जब सभी बॉक्स चेक हो जाएं, तो कहें:
"इंस्टॉलेशन पूर्ण। आप Section 4 के लिए तैयार हैं —
अपनी एजेंट फ़ाइलें बनाना।"

STEP 8 से शुरू करें। मुझसे अपना Team Design Document संलग्न करने के लिए कहें।

---

🛡️ Security Guardian ऑडिट

आपका Security Guardian अब पूरी सेटअप जांचेगा और किसी भी समस्या को स्वचालित रूप से ठीक करेगा।

Guardian क्या जांचता है:

• $env:USERPROFILE\\.opengoat\\ में सभी आवश्यक फ़ोल्डर मौजूद हैं
• सभी आवश्यक फ़ाइलें सही स्थान पर हैं
• गलत जगह पर फ़ाइलें स्वचालित रूप से स्थानांतरित की जाती हैं
• गुम फ़ाइलें स्वचालित रूप से बनाई जाती हैं (खाली — Section 4 में भरेंगे)

Guardian अभी क्या नहीं बदलता:

• फ़ाइलों की सामग्री (एजेंट की personalities और सेटिंग्स Section 4 में आएंगी)

ऑडिट चलाएं:

Windows:

node $env:USERPROFILE\\.opengoat\\workspaces\\security-guardian\\scripts\\verify_setup.js --fix

Guardian बताएगा कि उसने क्या पाया और ठीक किया। अगर सब कुछ हरे रंग में है, तो आप Section 4 के लिए तैयार हैं।