आप क्या बना रहे हैं

प्रत्येक एजेंट को सही तरीके से काम करने के लिए फ़ाइलों का एक सेट चाहिए। OpenClaw सत्र शुरू होने पर स्वचालित रूप से मुख्य फ़ाइलें पढ़ता है। अतिरिक्त workspace फ़ाइलें प्रत्येक एजेंट को संदर्भ, निर्धारित कार्य और टूल नियम देती हैं।

एजेंट config — OpenClaw द्वारा स्वचालित रूप से जनरेट। यहाँ बनाने की जरूरत नहीं:

फ़ाइल	स्थान	उद्देश्य
config.json	agents/[id]/config.json	OpenClaw एजेंट परिभाषा, सिस्टम प्रॉम्प्ट
models.json	agents/[id]/models.json	AI मॉडल सेटिंग्स

इन फ़ाइलों को Section 4 में बनाने की जरूरत नहीं है। Section 5 में openclaw agents add [id] --workspace ... चलाने पर, प्रत्येक एजेंट को पंजीकृत करते समय दोनों फ़ाइलें स्वचालित रूप से जनरेट होती हैं — यहाँ बस इतना जानना काफी है कि ये फ़ाइलें मौजूद रहेंगी।

Workspace फ़ाइलें — OpenClaw द्वारा हर सत्र में स्वतः लोड:

फ़ाइल	उद्देश्य
SOUL.md	व्यक्तित्व, टोन, कठोर सीमाएं, मिशन — 400 शब्दों से कम रखें
AGENTS.md	संचालन नियम, रिपोर्टिंग प्रक्रियाएं — 400 शब्दों से कम रखें
IDENTITY.md	नाम, भूमिका, वे किसे रिपोर्ट करते हैं — केवल तथ्य, संक्षिप्त रखें
HEARTBEAT.md	हमेशा सक्रिय कार्य, निर्धारित टास्क, असंगति प्रतिक्रिया
TOOLS.md	अनुमत टूल, स्किल नियम, निषिद्ध कार्य
USER.md	कमांडर की प्राथमिकताएं, संवाद शैली, टाइमज़ोन

भूमिका विवरण फ़ाइल — AGENTS.md निर्देश के अनुसार प्रति सत्र एक बार पढ़ी जाती है:

फ़ाइल	उद्देश्य
SPEC_[NAME].md	विस्तृत भूमिका, जिम्मेदारियां, मुख्य पथ

केवल CEO — identity फ़ोल्डर:

फ़ाइल	उद्देश्य
identity/COMPANY_PROFILE.md	कंपनी की पृष्ठभूमि, व्यावसायिक विवरण
identity/PERSONAL_PROFILE.md	मालिक की पृष्ठभूमि, कौशल, अनुभव
identity/VALUES.md	सोचने का तरीका, मूल्य, निर्णय सिद्धांत

पूर्ण workspace संरचना — सभी एजेंट:

INFO

$env:USERPROFILE/.opengoat/ ├── agents/ │ └── [agentid]/ │ ├── config.json ← Section 5 में स्वतः जनरेट │ └── models.json ← Section 5 में स्वतः जनरेट └── workspaces/ └── [agentid]/ ├── SOUL.md ← auto-loaded ├── AGENTS.md ← auto-loaded ├── IDENTITY.md ← auto-loaded ├── HEARTBEAT.md ← auto-loaded ├── TOOLS.md ← auto-loaded ├── USER.md ← auto-loaded └── SPEC_[NAME].md ← read via AGENTS.md instruction

CEO workspace — अतिरिक्त identity फ़ोल्डर:

INFO

workspaces/ceo/ └── identity/ ├── COMPANY_PROFILE.md ├── PERSONAL_PROFILE.md └── VALUES.md

---

Section 4 कैसे काम करता है

इस सेक्शन में, आप प्रत्येक एजेंट को डिज़ाइन करने के लिए अपने AI concierge के साथ काम करेंगे। प्रत्येक एजेंट के लिए, आप तय करेंगे:

• नाम और भूमिका
• व्यक्तित्व और संचार शैली
• वे कौन से टूल इस्तेमाल कर सकते हैं

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

यह सेक्शन कैसे काम करता है — दो भाग

इस सेक्शन के दो भाग हैं। उन्हें क्रम में पूरा करें:

भाग 1 — Discord सेटअप (नीचे दिया प्रॉम्प्ट) अपना Discord सर्वर, चैनल बनाएं और प्रत्येक एजेंट के लिए Webhook URL प्राप्त करें। इसमें लगभग 10 मिनट लगते हैं।

भाग 2 — एजेंट फ़ाइलें (अगला प्रॉम्प्ट) अपने Team Design Document का उपयोग करके वास्तविक एजेंट फ़ाइलें बनाएं। AI टर्मिनल कमांड जेनरेट करता है — फ़ाइलें स्वचालित रूप से बनाने के लिए उन्हें VS Code में पेस्ट करें।

भाग 1 से शुरू करें।

---

Discord Webhook URLs — पहले ये प्राप्त करें

प्रत्येक एजेंट Webhook URL के माध्यम से अपने Discord चैनल को रिपोर्ट करता है। AGENTS.md फ़ाइलें लिखने से पहले आपको इनकी जरूरत होगी।

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

भेजने से पहले अपना Team Design Document संलग्न करें।

आप मेरी BALIA OS मल्टी-एजेंट टीम के लिए Discord चैनल और
Webhook URL सेट करने में मेरी मदद कर रहे हैं।

मुझे चरण-दर-चरण मार्गदर्शन दें। एक समय में एक प्रश्न पूछें।
अगर मैं अटक जाऊं, तो मुझसे स्क्रीनशॉट लेने और बताने के लिए
कहें कि मैं क्या देख रहा हूं।

मैंने अपना Team Design Document संलग्न किया है।

चरण 1 — Discord जांचें
पूछें: "क्या आपके पास Discord इंस्टॉल है और अकाउंट सेट है?"
अगर नहीं: मुझे discord.com पर डाउनलोड करने और अकाउंट बनाने
के लिए मार्गदर्शन दें।
अगर हां: चरण 2 पर जाएं।

चरण 2 — Discord सर्वर बनाएं
मुझे एक नया सर्वर बनाने में मार्गदर्शन दें:
- बाईं साइडबार में + बटन पर क्लिक करें
- "Create My Own" -> "For me and my friends" चुनें
- इसे "BALIA OS Team" नाम दें
आगे बढ़ने से पहले पुष्टि करें कि मैं इसे देख सकता हूं।

चरण 3 — प्रत्येक एजेंट के लिए चैनल बनाएं
चैनल नामों के लिए मेरा Team Design Document पढ़ें।
प्रत्येक एजेंट के लिए एक टेक्स्ट चैनल बनाएं:
- "Text Channels" पर राइट-क्लिक करें -> Add Channel -> Text
- मेरे Team Design Document से चैनल नाम का उपयोग करें
सभी 6 एजेंटों के लिए दोहराएं। आगे बढ़ने से पहले पुष्टि करें
कि सभी चैनल मौजूद हैं।

चरण 4 — प्रत्येक चैनल के लिए Webhook URL प्राप्त करें
एक-एक चैनल के लिए:
1. चैनल पर राइट-क्लिक करें -> Edit Channel
2. Integrations -> Webhooks -> New Webhook
3. इसे एजेंट के नाम पर रखें (जैसे "Marcus")
4. Webhook URL कॉपी करें
5. मुझसे इसे किसी सुरक्षित स्थान पर पेस्ट करने के लिए कहें
सभी 6 के लिए दोहराएं। आगे बढ़ने से पहले पुष्टि करें कि
सभी 6 URL सहेजे गए हैं।

चरण 5 — .env फ़ाइल में जोड़ें
मुझे VS Code में .env फ़ाइल खोलने में मार्गदर्शन दें।
फ़ाइल यहां है:
- Windows: $env:USERPROFILE\.opengoat\.env
- Mac: ~/.opengoat/.env
प्रत्येक webhook जोड़ें:
DISCORD_WEBHOOK_[AGENTNAME]=https://discord.com/api/webhooks/xxxxx/xxxxx
(एजेंट नाम UPPERCASE में)
मुझे बताएं: "इस फ़ाइल को कभी साझा न करें। इसे GitHub पर
कभी commit न करें।"

जब सभी webhooks सहेज लिए जाएं: "Discord सेटअप पूर्ण।"

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

---

AI प्रॉम्प्ट का उपयोग करना

नीचे दिए प्रॉम्प्ट को अपने चैट AI में पेस्ट करें और संलग्न करें:

1. Section 2 से अपना Team Design Document

AI एक समय में प्रत्येक एजेंट के लिए टर्मिनल कमांड जेनरेट करता है। फ़ाइलें स्वचालित रूप से बनाने के लिए कमांड को अपने VS Code टर्मिनल में पेस्ट करें।

---

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

आप BALIA OS के लिए एजेंट फ़ाइलें बनाने में मेरी मदद कर रहे हैं,
जो OpenClaw पर बना एक मल्टी-एजेंट AI OS है।

संलग्न:
1. मेरा Team Design Document (Section 2 से)

कुछ भी जेनरेट करने से पहले इसे पढ़ें।
इस दस्तावेज़ से सभी एजेंट नाम, ID और Discord चैनल नाम निकालें।

आर्किटेक्चर:

1. मैं Commander हूं। मैं प्रत्येक एजेंट को सीधे कमांड देता हूं।
   कोई orchestrator नहीं।

2. प्रत्येक एजेंट के दो स्थान हैं:
   - agents/[id]/ — OpenClaw config (config.json + models.json)
   - workspaces/[id]/ — workspace फ़ाइलें (SOUL, AGENTS, IDENTITY,
     HEARTBEAT, TOOLS, USER, SPEC)
   सभी पथ $env:USERPROFILE/.opengoat/ के
   अंतर्गत हैं

3. OpenClaw हर सत्र शुरू होने पर SOUL.md, AGENTS.md, IDENTITY.md,
   HEARTBEAT.md, TOOLS.md, USER.md स्वतः इंजेक्ट करता है।
   उनमें "खुद को पढ़ें" निर्देश न लिखें।

4. SPEC_[NAME].md स्वतः इंजेक्ट नहीं होता। AGENTS.md Session
   Start में जोड़ें:
   "पूर्ण भूमिका विवरण के लिए SPEC_[AGENTNAME].md पढ़ें"

5. केवल CEO के workspaces/ceo/ के अंदर identity/ फ़ोल्डर होता है:
   identity/COMPANY_PROFILE.md
   identity/PERSONAL_PROFILE.md
   identity/VALUES.md
   केवल CEO एजेंट के लिए ये जेनरेट करें।

6. SOUL.md और AGENTS.md: प्रत्येक 400 शब्दों से कम (हर सत्र
   इंजेक्ट होते हैं)।
   SPEC: विस्तृत हो सकता है (प्रति सत्र एक बार पढ़ा जाता है)।

जेनरेट करने से पहले — मुझसे पूछें:
"आपका Windows username क्या है? (C:\Users\[username] में नाम)"
मेरे उत्तर की प्रतीक्षा करें, फिर सभी फ़ाइल पथों में वह
username उपयोग करें।

प्रत्येक एजेंट के लिए जेनरेट करें:

====================================
FILE 1: SOUL.md
Path: $env:USERPROFILE/.opengoat/workspaces/[agentid]/SOUL.md
हर सत्र में स्वतः इंजेक्ट। 400 शब्दों से कम।
====================================

# SOUL.md — [एजेंट नाम]

## आप कौन हैं
[2-3 वाक्य: पहचान, व्यक्तित्व, कार्य दृष्टिकोण]

## टोन
- [नियम 1]
- [नियम 2]
- [नियम 3]
- [निषिद्ध शैली]

## कठोर सीमाएं
- परिभाषित भूमिका से बाहर कभी काम न करें
- परिणाम सत्यापित किए बिना पूर्ण रिपोर्ट कभी न करें
- Commander की अनुमति के बिना कोई विनाशकारी कार्य न करें
- [1-2 भूमिका-विशिष्ट सीमाएं]

## वर्तमान मिशन
[वर्तमान फोकस पर 1-2 वाक्य]

====================================
FILE 2: AGENTS.md
Path: $env:USERPROFILE/.opengoat/workspaces/[agentid]/AGENTS.md
हर सत्र में स्वतः इंजेक्ट। 400 शब्दों से कम।
====================================

# AGENTS.md — [एजेंट नाम] संचालन प्रक्रियाएं

## सत्र शुरुआत (हर सत्र — इस क्रम में)
1. SOUL.md से पहचान की पुष्टि करें
2. भूमिका विवरण के लिए SPEC_[AGENTNAME].md पढ़ें
3. HEARTBEAT.md पढ़ें — निर्धारित कार्यों पर ध्यान दें
4. TOOLS.md पढ़ें — अनुमत टूल और प्रतिबंधों पर ध्यान दें
5. USER.md पढ़ें — Commander की प्राथमिकताओं पर ध्यान दें
6. Discord को रिपोर्ट करें: "🔷 [नाम] तैयार। [वर्तमान कार्य
   या स्थिति]"

(केवल CEO — चरण 2 के बाद, ये भी पढ़ें:
  identity/COMPANY_PROFILE.md
  identity/PERSONAL_PROFILE.md
  identity/VALUES.md)

## सत्र समाप्ति (हर सत्र)
1. Discord को रिपोर्ट करें: "✅ [नाम] सत्र पूर्ण। [सारांश]"
2. अगले सत्र के लिए अधूरे कार्यों को नोट करें

## रिपोर्टिंग
- चैनल: #[discord-channel]
- कमांड: python $env:USERPROFILE/.opengoat/scripts/discord_send.py
  DISCORD_WEBHOOK_[NAME] "message"
  (discord_send.py नीचे Security Guardian सेक्शन में स्वचालित
  रूप से deploy होता है)
- HTTP 204 = सफलता। अन्यथा = तुरंत विफलता रिपोर्ट करें।
- प्रारूप: निष्कर्ष -> विवरण -> अगली अनुशंसित कार्रवाई
- रिपोर्ट करें: सत्र शुरुआत / कार्य पूर्ण / त्रुटि / सत्र
  समाप्ति पर

## त्रुटि प्रबंधन
1. ज्ञात त्रुटि पैटर्न के लिए SPEC_[NAME].md जांचें
2. अनसुलझी -> Commander को पूर्ण विवरण रिपोर्ट करें
3. Commander की अनुमति के बिना कोई विनाशकारी पुनः-प्रयास नहीं

## कठोर नियम
- पूर्ण रिपोर्ट करने से पहले सत्यापित करें
- परिभाषित भूमिका से बाहर कोई कार्य नहीं
- Commander की अनुमति के बिना कोई विनाशकारी ऑपरेशन नहीं

====================================
FILE 3: IDENTITY.md
Path: $env:USERPROFILE/.opengoat/workspaces/[agentid]/IDENTITY.md
स्वतः इंजेक्ट। केवल तथ्य, संक्षिप्त रखें।
====================================

# IDENTITY.md

Name: [एजेंट नाम]
Agent ID: [agentid-lowercase]
Role: [भूमिका शीर्षक]
Department: BALIA OS Team
Reports To: Commander (directly)
Discord: #[channel name]

====================================
FILE 4: HEARTBEAT.md
Path: $env:USERPROFILE/.opengoat/workspaces/[agentid]/HEARTBEAT.md
स्वतः इंजेक्ट। निर्धारित कार्य और असंगति प्रतिक्रिया।
====================================

# HEARTBEAT.md — [एजेंट नाम]

## हमेशा चालू
[यह एजेंट क्या निरंतर निगरानी या रखरखाव करता है]

## निर्धारित कार्य
[आवर्ती कार्य — दैनिक, साप्ताहिक, या ट्रिगर-आधारित]

## सत्र शुरुआत पर
- SOUL.md और AGENTS.md पढ़ें
- रिपोर्ट करें: "🔷 [नाम] तैयार"

## त्रुटि या असंगति पर
- Discord के माध्यम से तुरंत Commander को रिपोर्ट करें
- Commander की अनुमति के बिना स्व-सुधार कभी नहीं

====================================
FILE 5: TOOLS.md
Path: $env:USERPROFILE/.opengoat/workspaces/[agentid]/TOOLS.md
स्वतः इंजेक्ट। टूल नियम और प्रतिबंध।
====================================

# TOOLS.md — [एजेंट नाम] टूल नियम

## मूल सिद्धांत
- प्रत्येक कार्य से पहले अनुमत टूल के लिए SPEC_[NAME].md जांचें
- केवल वही लोड करें जो कार्य के लिए आवश्यक है

## अनुमत टूल
[इस एजेंट की भूमिका से संबंधित टूल सूचीबद्ध करें]

## Discord रिपोर्टिंग
हमेशा discord_send.py का सीधे उपयोग करें:
python $env:USERPROFILE/.opengoat/scripts/discord_send.py
DISCORD_WEBHOOK_[NAME] "message"
भेजने के बाद HTTP 204 की पुष्टि करें।

## निषिद्ध
- API keys या Webhooks को hardcode करना (हमेशा .env से पढ़ें)
- परिभाषित भूमिका से बाहर के कार्य
- अनावश्यक बाहरी संचार

====================================
FILE 6: USER.md
Path: $env:USERPROFILE/.opengoat/workspaces/[agentid]/USER.md
स्वतः इंजेक्ट। Commander की प्राथमिकताएं।
====================================

# USER.md — Commander प्रोफ़ाइल

## नाम
[Commander का पसंदीदा नाम]

## टाइमज़ोन
[टाइमज़ोन — Team Design Document में न हो तो मुझसे पूछें]

## संवाद शैली
- [प्राथमिकता 1]
- [प्राथमिकता 2]

## वर्तमान चरण
[हम अभी क्या बना रहे हैं उस पर फोकस]

====================================
FILE 7: SPEC_[AGENTNAME].md
Path: $env:USERPROFILE/.opengoat/workspaces/[agentid]/SPEC_[AGENTNAME].md
स्वतः इंजेक्ट नहीं। AGENTS.md के माध्यम से प्रति सत्र एक बार
पढ़ा जाता है।
====================================

# SPEC_[AGENTNAME] v1.0 — [एजेंट नाम] ([भूमिका])
Last Updated: [आज]

## 1. भूमिका
[2-3 वाक्य]

## 2. जिम्मेदारियां
[Team Design Document से बुलेट सूची]

## 3. यह एजेंट क्या नहीं करता
[स्पष्ट सीमाएं]

## 4. वर्तमान चरण मिशन
[वर्तमान फोकस]

## 5. मुख्य पथ
- Workspace: $env:USERPROFILE/.opengoat/workspaces/[agentid]/
- Discord webhook: DISCORD_WEBHOOK_[NAME] (.env से पढ़ें)

## 6. परिवर्तन लॉग
| Version | Date | Changes |
|---------|------|---------|
| v1.0 | [आज] | Initial creation |

====================================
केवल CEO — FILES 8, 9, 10: identity/ फ़ोल्डर
जेनरेट करने से पहले ये 3 प्रश्न एक-एक करके पूछें।
====================================

Q1: "अपने व्यवसाय के बारे में बताएं — यह क्या करता है, कितने
    समय से चल रहा है, किन बाजारों में सेवा देता है।"

Q2: "अपने बारे में बताएं — पृष्ठभूमि, कौशल, अनुभव जो इस
    व्यवसाय से संबंधित है।"

Q3: "आप निर्णय कैसे लेते हैं? आपको कौन से मूल्य मार्गदर्शन
    देते हैं? आप किस सोच की शैली या दृष्टिकोण की अधिक इच्छा
    रखते हैं?"

सभी 3 उत्तरों के बाद, जेनरेट करें:

COMPANY_PROFILE.md — Q1 सामग्री, संरचित
PERSONAL_PROFILE.md — Q2 सामग्री, संरचित
VALUES.md — Q3 सामग्री, संरचित

Path: $env:USERPROFILE/.opengoat/workspaces/ceo/identity/

यहां जितना अधिक विवरण दिया जाए, CEO उतना ही मालिक की तरह
सोचता और निर्णय लेता है।

====================================

फ़ाइलें कैसे डिलीवर करें:

प्रत्येक फ़ाइल की सामग्री जेनरेट करने के बाद, फ़ाइल बनाने के
लिए सटीक python कमांड आउटपुट करें। प्रारूप:

--- PASTE INTO TERMINAL (Windows) ---
python -c "
content = '''[full file content here]'''
import os
path = r'$env:USERPROFILE/.opengoat/workspaces/[agentid]/SOUL.md'
os.makedirs(os.path.dirname(path), exist_ok=True)
open(path, 'w', encoding='utf-8').write(content)
print('Created:', path)
"

--- PASTE INTO TERMINAL (Mac) ---
python3 -c "
content = '''[full file content here]'''
import os
path = os.path.expanduser('~/.opengoat/workspaces/[agentid]/SOUL.md')
os.makedirs(os.path.dirname(path), exist_ok=True)
open(path, 'w', encoding='utf-8').write(content)
print('Created:', path)
"

अगली फ़ाइल पर जाने से पहले मेरे कमांड पेस्ट करने और पुष्टि
करने की प्रतीक्षा करें। पूछें: "क्या आपने 'Created: [path]'
देखा?"

कैसे आगे बढ़ें:
- Agent #1 से शुरू करें (CEO नहीं)
- एक समय में एक फ़ाइल, एक एजेंट
- अगली फ़ाइल से पहले हमेशा टर्मिनल पुष्टि की प्रतीक्षा करें
- जब CEO तक पहुंचें: पहले 3 identity प्रश्न पूछें,
  फिर 7 मुख्य फ़ाइलें + 3 identity फ़ाइलें जेनरेट करें
- सभी बनाई गई फ़ाइलों की सारांश तालिका के साथ समाप्त करें

जब आपका AI concierge डिज़ाइन की पुष्टि कर दे, तो Security Guardian से फ़ाइलें लिखने के लिए कहें:

Windows:

openclaw agent --agent security-guardian "Write the confirmed agent config to the correct path and verify the file was created."

Guardian पुष्टि करेगा जब फ़ाइलें सही तरीके से लिख दी जाएंगी।

---

चरण 2 — पुष्टि करें कि फ़ाइलें बनाई गईं

AI के सभी फ़ाइलों के बारे में मार्गदर्शन करने के बाद, प्रत्येक एजेंट के workspace की पुष्टि करें:

Windows:

dir $env:USERPROFILE\.opengoat\workspaces\[agentid]

Mac:

ls ~/.opengoat/workspaces/[agentid]

आपको यह दिखना चाहिए:

SOUL.md
AGENTS.md
IDENTITY.md
HEARTBEAT.md
TOOLS.md
USER.md
SPEC_[NAME].md

CEO अतिरिक्त रूप से:

identity/
├── COMPANY_PROFILE.md
├── PERSONAL_PROFILE.md
└── VALUES.md

---

चरण 3 — अगले एजेंट पर जाने से पहले जांचें

AGENTS.md खोलें। क्या Session Start सेक्शन HEARTBEAT.md, TOOLS.md और USER.md सहित सभी चरण सूचीबद्ध करता है?

हां -> आगे बढ़ें। नहीं -> पहले AI को इसे ठीक करने के लिए कहें।

---

जब यह सेक्शन पूर्ण हो

प्रत्येक एजेंट का workspace:

INFO

workspaces/[agentid]/ ├── SOUL.md ✅ ├── AGENTS.md ✅ ├── IDENTITY.md ✅ ├── HEARTBEAT.md ✅ ├── TOOLS.md ✅ ├── USER.md ✅ └── SPEC_[NAME].md ✅

CEO अतिरिक्त रूप से:

INFO

workspaces/ceo/ └── identity/ ├── COMPANY_PROFILE.md ✅ ├── PERSONAL_PROFILE.md ✅ └── VALUES.md ✅

---

नोट: Security Guardian Section 3 में तैनात किया गया था। यदि आपने Section 3 छोड़ दिया, तो Section 5 पर जाने से पहले वापस जाएं और इसे पूरा करें।