Не жасайсыз

Әрбір агент дұрыс жұмыс істеу үшін файлдар жиынтығын қажет етеді. OpenClaw сессия басталғанда негізгі файлдарды автоматты түрде оқиды. Қосымша жұмыс кеңістігі файлдары әрбір агентке контекст, жоспарланған міндеттер және құрал ережелерін береді.

Агент конфигурациясы — OpenClaw оқиды:

Файл	Орналасқан жер	Мақсат
config.json	agents/[id]/config.json	OpenClaw агент анықтамасы, жүйелік промпт
models.json	agents/[id]/models.json	AI модель параметрлері

Жұмыс кеңістігі файлдары — OpenClaw әрбір сессияда автоматты жүктейді:

Файл	Мақсат
SOUL.md	Жеке тұлға, тон, қатаң шектеулер, миссия — 400 сөзден аз болуы керек
AGENTS.md	Жұмыс ережелері, есеп беру процедуралары — 400 сөзден аз болуы керек
IDENTITY.md	Аты, рөлі, кімге есеп береді — тек фактілер, қысқа болуы керек
HEARTBEAT.md	Үнемі жұмыс істейтін міндеттер, жоспарланған тапсырмалар, ауытқуға жауап
TOOLS.md	Рұқсат етілген құралдар, дағды ережелері, тыйым салынған іс-әрекеттер
USER.md	Командир қалаулары, байланыс стилі, уақыт белдеуі

Рөл мәліметтері файлы — AGENTS.md нұсқауы арқылы сессияда бір рет оқылады:

Файл	Мақсат
SPEC_[АТЫ].md	Толық рөл, жауапкершіліктер, негізгі жолдар

Тек CEO — жеке басын растайтын қалта:

Файл	Мақсат
identity/COMPANY_PROFILE.md	Компания туралы мәліметтер, бизнес деректері
identity/PERSONAL_PROFILE.md	Иесінің туралы мәліметтері, дағдылары, тәжірибесі
identity/VALUES.md	Ойлау стилі, құндылықтар, шешім қабылдау принциптері

Толық жұмыс кеңістігі құрылымы — барлық агенттер:

INFO

$env:USERPROFILE/.opengoat/ ├── agents/ │ └── [agentid]/ │ ├── config.json ← OpenClaw мұны оқиды │ └── models.json └── workspaces/ └── [agentid]/ ├── SOUL.md ← автоматты жүктеледі ├── AGENTS.md ← автоматты жүктеледі ├── IDENTITY.md ← автоматты жүктеледі ├── HEARTBEAT.md ← автоматты жүктеледі ├── TOOLS.md ← автоматты жүктеледі ├── USER.md ← автоматты жүктеледі └── SPEC_[АТЫ].md ← AGENTS.md нұсқауы арқылы оқылады

CEO жұмыс кеңістігі — қосымша жеке басын растайтын қалта:

INFO

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

---

4-Бөлім Қалай Жұмыс Істейді

Бұл бөлімде сіз AI консьержбен бірге әр агентті жобалайсыз. Әр агент үшін сіз шешесіз:

• Аты мен рөлі
• Тұлғасы мен байланыс стилі
• Қандай құралдарды қолдана алатыны

AI консьержбен дизайнды бекіткеннен кейін, Қауіпсіздік Күзетшісі конфигурация файлдарын автоматты түрде жазады. Файлдарды қолмен өңдеу қажет емес.

Бұл бөлім қалай жұмыс істейді — Екі бөлік

Бұл бөлімде екі бөлік бар. Оларды ретімен орындаңыз:

1-бөлік — Discord Баптауы (төмендегі промпт) Discord серверін, арналарды жасаңыз және әрбір агент үшін Webhook URL-дерін алыңыз. Бұл шамамен 10 минут алады.

2-бөлік — Агент Файлдары (келесі промпт) Team Design Document пайдаланып нақты агент файлдарын жасаңыз. AI терминал командаларын жасайды — файлдарды автоматты жасау үшін оларды VS Code-қа жабыстырыңыз.

Қазір 1-бөліктен бастаңыз.

---

Discord Webhook URL-дері — Алдымен осыларды алыңыз

Әрбір агент 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 URL-дің барлығы үшін қайталаңыз. Жалғастырмас бұрын 6 URL-дің барлығы сақталғанын растаңыз.

5-ҚАДАМ — .env файлына қосу
VS Code-та .env файлын ашуға жетектеңіз.
Файл мына жерде:
- Windows: $env:USERPROFILE\.opengoat\.env
- Mac: ~/.opengoat/.env
Әрбір webhook қосыңыз:
DISCORD_WEBHOOK_[АГЕНТАТЫ]=https://discord.com/api/webhooks/xxxxx/xxxxx
(БАС ӘРІППЕН агент атаулары)
Айтыңыз: "Бұл файлды ешкіммен бөліспеңіз. Ешқашан GitHub-қа тапсырмаңыз."

Барлық webhook-тар сақталғанда: "Discord баптауы аяқталды."

Қазір бастаңыз. Маған бірінші сұрақты қойыңыз.

---

AI Промптін пайдалану

Төмендегі промпті сіздің чат-ЖИ-ға жабыстырып тіркеңіз:

1. Section 2-дегі Team Design Document

AI бір-бір агентке арналған терминал командаларын жасайды. Файлдарды автоматты жасау үшін командаларды VS Code терминалыңызға жабыстырыңыз.

---

▶ Бастау үшін мұны AI-ға жабыстырыңыз

Сіз маған BALIA OS — OpenClaw негізінде жасалған көп агентті AI ОЖ үшін
агент файлдарын жасауға көмектесесіз.

Тіркелген:
1. Team Design Document (Section 2-ден)

Ештеңе жасамас бұрын оқыңыз.
Осы құжаттан барлық агент атауларын, ID-лерін және Discord арна атауларын шығарып алыңыз.

АРХИТЕКТУРА:

1. Мен Командирмін. Мен әрбір агентке тікелей бұйырамын. Оркестратор жоқ.

2. Әрбір агенттің екі орналасуы бар:
   - agents/[id]/ — OpenClaw конфигурациясы (config.json + models.json)
   - workspaces/[id]/ — жұмыс кеңістігі файлдары (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_[АТЫ].md автоматты енгізілмейді. AGENTS.md Сессия Басталуына қосыңыз:
   "Толық рөл мәліметтері үшін SPEC_[АГЕНТАТЫ].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 пайдаланушы атыңыз қандай? (C:\Users\[username] дегендегі атау)"
Жауабымды күтіңіз, содан кейін барлық файл жолдарында сол пайдаланушы атын пайдаланыңыз.

ӘР АГЕНТ ҮШІН ЖАСАҢЫЗ:

====================================
1-ФАЙЛ: SOUL.md
Жол: $env:USERPROFILE/.opengoat/workspaces/[agentid]/SOUL.md
Әрбір сессияда автоматты енгізіледі. 400 сөзден аз.
====================================

# SOUL.md — [Агент Аты]

## Кімсіз
[2-3 сөйлем: жеке басы, тұлғасы, жұмыс тәсілі]

## Тон
- [1-ереже]
- [2-ереже]
- [3-ереже]
- [Тыйым салынған стиль]

## Қатаң Шектеулер
- Анықталған рөлден тыс ешқашан әрекет жасамаңыз
- Нәтижені тексермей аяқталды деп ешқашан хабарламаңыз
- Командир рұқсатынсыз деструктивті әрекет жасамаңыз
- [1-2 рөлге тән шектеулер]

## Ағымдағы Миссия
[Ағымдағы назар туралы 1-2 сөйлем]

====================================
2-ФАЙЛ: AGENTS.md
Жол: $env:USERPROFILE/.opengoat/workspaces/[agentid]/AGENTS.md
Әрбір сессияда автоматты енгізіледі. 400 сөзден аз.
====================================

# AGENTS.md — [Агент Аты] Жұмыс Процедуралары

## Сессия Басталуы (Әрбір сессия — осы ретте)
1. SOUL.md-тен жеке басты растаңыз
2. Толық рөл мәліметтері үшін SPEC_[АГЕНТАТЫ].md оқыңыз
3. HEARTBEAT.md оқыңыз — жоспарланған тапсырмаларды белгілеңіз
4. TOOLS.md оқыңыз — рұқсат етілген құралдар мен шектеулерді белгілеңіз
5. USER.md оқыңыз — командир қалауларын белгілеңіз
6. Discord-қа хабарлаңыз: "🔷 [Аты] дайын. [ағымдағы тапсырма немесе мәртебе]"

(Тек CEO — 2-қадамнан кейін де оқыңыз:
  identity/COMPANY_PROFILE.md
  identity/PERSONAL_PROFILE.md
  identity/VALUES.md)

## Сессия Аяқталуы (Әрбір сессия)
1. Discord-қа хабарлаңыз: "✅ [Аты] сессиясы аяқталды. [қысқаша]"
2. Кез келген аяқталмаған тапсырмаларды келесі сессияға белгілеңіз

## Есеп беру
- Арна: #[discord-арнасы]
- Команда: python $env:USERPROFILE/.opengoat/scripts/discord_send.py
  DISCORD_WEBHOOK_[АТЫ] "хабарлама"
  (discord_send.py төмендегі Security Guardian бөлімінде автоматты орналастырылады)
- HTTP 204 = сәтті. Әйтпесе = сәтсіздікті дереу хабарлаңыз.
- Пішім: Қорытынды -> Мәліметтер -> Келесі ұсынылған іс-әрекет
- Хабарлаңыз: сессия басталуы / тапсырма аяқталуы / қате / сессия аяқталуы

## Қатені Өңдеу
1. Белгілі қате үлгілері үшін SPEC_[АТЫ].md тексеріңіз
2. Шешілмеген → Командирге толық мәліметтерді хабарлаңыз
3. Командир рұқсатынсыз деструктивті қайталауларды жасамаңыз

## Қатаң Ережелер
- Аяқталды деп хабарламас бұрын тексеріңіз
- Анықталған рөлден тыс әрекеттер жоқ
- Командир рұқсатынсыз деструктивті операциялар жоқ

====================================
3-ФАЙЛ: IDENTITY.md
Жол: $env:USERPROFILE/.opengoat/workspaces/[agentid]/IDENTITY.md
Автоматты енгізіледі. Тек фактілер, қысқа болуы керек.
====================================

# IDENTITY.md

Аты: [Агент Аты]
Агент ID: [agentid-кіші-әріп]
Рөлі: [Рөл Атауы]
Бөлімі: BALIA OS Командасы
Кімге Есеп Береді: Командир (тікелей)
Discord: #[арна атауы]

====================================
4-ФАЙЛ: HEARTBEAT.md
Жол: $env:USERPROFILE/.opengoat/workspaces/[agentid]/HEARTBEAT.md
Автоматты енгізіледі. Жоспарланған міндеттер және ауытқуға жауап.
====================================

# HEARTBEAT.md — [Агент Аты]

## Үнемі Жұмыста
[Бұл агент үнемі не бақылайды немесе қолдайды]

## Жоспарланған Тапсырмалар
[Қайталанатын міндеттер — күнделікті, апталық немесе триггерге негізделген]

## Сессия Басталуында
- SOUL.md және AGENTS.md оқыңыз
- Хабарлаңыз: "🔷 [Аты] дайын"

## Қате немесе Ауытқу Болғанда
- Дереу Командирге Discord арқылы хабарлаңыз
- Командир рұқсатынсыз өзіңіз түзетпеңіз

====================================
5-ФАЙЛ: TOOLS.md
Жол: $env:USERPROFILE/.opengoat/workspaces/[agentid]/TOOLS.md
Автоматты енгізіледі. Құрал ережелері мен шектеулері.
====================================

# TOOLS.md — [Агент Аты] Құрал Ережелері

## Негізгі Принцип
- Рұқсат етілген құралдар үшін әрбір тапсырмадан бұрын SPEC_[АТЫ].md тексеріңіз
- Тек тапсырма талап ететіннің жүктеңіз

## Рұқсат Етілген Құралдар
[Осы агенттің рөліне қатысты құралдар тізімі]

## Discord-қа Есеп Беру
discord_send.py-ді тікелей пайдаланыңыз:
python $env:USERPROFILE/.opengoat/scripts/discord_send.py DISCORD_WEBHOOK_[АТЫ] "хабарлама"
Жібергеннен кейін HTTP 204 растаңыз.

## Тыйым Салынған
- API кілттерін немесе Webhook-тарды кодта қатты орнату (.env-тен оқыңыз)
- Анықталған рөлден тыс әрекеттер
- Қажетсіз сыртқы байланыс

====================================
6-ФАЙЛ: USER.md
Жол: $env:USERPROFILE/.opengoat/workspaces/[agentid]/USER.md
Автоматты енгізіледі. Командир қалаулары.
====================================

# USER.md — Командир Профилі

## Аты
[Командирдің қалаулы аты]

## Уақыт Белдеуі
[Уақыт белдеуі — Team Design Document-те болмаса маған сұраңыз]

## Байланыс Стилі
- [1-қалау]
- [2-қалау]

## Ағымдағы Кезең
[Қазір не жасауға назар аударып жатырмыз]

====================================
7-ФАЙЛ: SPEC_[АГЕНТАТЫ].md
Жол: $env:USERPROFILE/.opengoat/workspaces/[agentid]/SPEC_[АГЕНТАТЫ].md
Автоматты енгізілмейді. Сессияда бір рет AGENTS.md арқылы оқылады.
====================================

# SPEC_[АГЕНТАТЫ] v1.0 — [Агент Аты] ([Рөл])
Соңғы Жаңарту: [бүгін]

## 1. Рөл
[2-3 сөйлем]

## 2. Жауапкершіліктер
[Team Design Document-тен нүктелі тізім]

## 3. Бұл Агент НЕ ЖАСАМАЙДЫ
[Нақты шектеулер]

## 4. Ағымдағы Кезең Миссиясы
[Ағымдағы назар]

## 5. Негізгі Жолдар
- Жұмыс кеңістігі: $env:USERPROFILE/.opengoat/workspaces/[agentid]/
- Discord webhook: DISCORD_WEBHOOK_[АТЫ] (.env-тен оқыңыз)

## 6. Өзгерістер Журналы
| Нұсқа | Күні | Өзгерістер |
|---------|------|---------|
| v1.0 | [бүгін] | Бастапқы жасалу |

====================================
ТЕК CEO — 8, 9, 10-ФАЙЛДАР: identity/ қалтасы
Жасамас бұрын осы 3 сұрақты бір-бір рет қойыңыз.
====================================

С1: "Бизнесіңіз туралы айтыңыз — не жасайды, қанша уақыттан бері
    жұмыс істейді, қандай нарықтарды қамтиды."

С2: "Өзіңіз туралы айтыңыз — бұл бизнеске қатысты
    тарихы, дағдылары, тәжірибесі."

С3: "Шешімдерді қалай қабылдайсыз? Қандай құндылықтар жетелейді?
    Өзіңізде қандай ойлау стильдері немесе перспективалар болғанын қалайсыз?"

3 жауаптың барлығынан кейін жасаңыз:

COMPANY_PROFILE.md — С1 мазмұны, құрылымдалған
PERSONAL_PROFILE.md — С2 мазмұны, құрылымдалған
VALUES.md — С3 мазмұны, құрылымдалған

Жол: $env:USERPROFILE/.opengoat/workspaces/ceo/identity/

Мұнда неғұрлым көп мәлімет берілсе, CEO соғұрлым иемізше
ойлап шешімдер қабылдайды.

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

ФАЙЛДАРДЫ ЖЕТКІЗУ:

Әрбір файл мазмұнын жасағаннан кейін, файлды жасау үшін нақты
python командаларын шығарыңыз. Пішімі:

--- ТЕРМИНАЛҒА ЖАБЫСТЫРЫҢЫЗ (Windows) ---
python -c "
content = '''[толық файл мазмұны мұнда]'''
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)
"

--- ТЕРМИНАЛҒА ЖАБЫСТЫРЫҢЫЗ (Mac) ---
python3 -c "
content = '''[толық файл мазмұны мұнда]'''
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: [жол]' деген жазуды көрдіңіз бе?"

ЖАЛҒАСТЫРУ ТӘРТІБІ:
- 1-Агенттен бастаңыз (CEO емес)
- Бір мезгілде бір файл, бір агент
- Келесі файлға өтпес бұрын терминал растауын күтіңіз
- CEO-ға жеткенде: алдымен 3 жеке басын растайтын сұрақты қойыңыз,
  содан кейін 7 негізгі файл + 3 жеке басын растайтын файлды жасаңыз
- Жасалған барлық файлдардың қорытынды кестесімен аяқтаңыз

AI консьерж дизайнды растағаннан кейін, Қауіпсіздік Күзетшісіне файлдарды жазуды сұраңыз:

Windows:

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

Күзетші файлдар дұрыс жазылғанда хабарлайды.

---

2-қадам — Файлдардың Жасалғанын Растаңыз

AI барлық файлдар арқылы жетектегеннен кейін, әрбір агенттің жұмыс кеңістігін растаңыз:

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_[АТЫ].md

CEO қосымша:

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

---

3-қадам — Келесі Агентке Өтпес Бұрын Тексеріңіз

AGENTS.md ашыңыз. Сессия Басталуы бөлімі HEARTBEAT.md, TOOLS.md және USER.md қоса барлық қадамдарды тізімдей ме?

Иә → жалғастырыңыз. Жоқ → алдымен AI-дан түзетуді сұраңыз.

---

Бұл Бөлім Аяқталғанда

Әрбір агенттің жұмыс кеңістігі:

INFO

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

CEO қосымша:

INFO

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

---

Ескерту: Қауіпсіздік Күзетшісі 3-бөлімде орнатылды. 3-бөлімді өткізіп жіберсеңіз, 5-бөлімге жалғастырмас бұрын оралып аяқтаңыз.