Осы бөлім аяқталғаннан кейінгі .opengoat қалтасының құрылымы

1-8 бөлімдерде бұл қалталар қадамдап салынады. Қазір бос болса алаңдамаңыз.

$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 конфигурация файлдары 4-бөлімде орналастырылады
│   └── [agentid]
│       ├── config.json
│       └── models.json
├── skills\                           ← 6-бөлімде кассеталар қосылады
└── cassettes\                        ← 6-бөлімде жасалады
    ├── _SKILL_STATUS.md
    └── [mode-name]\

Бұл қалта — BALIA OS-тың үйі. Барлық агент жеке басы, жады және дағдылар осында сақталады.

---

💡 API дегеніміз не? — және ол сізге неге қажет?

AI агенттеріңізді іс-әрекет жасамас бұрын ойлануы керек қызметкерлер ретінде елестетіңіз.

Агент бір жағдайды талдаған, есеп жазған немесе шешім қабылдаған сайын, ол ойлау үшін AI моделін шақыруы керек. API — осы шақыруды жасайтын арна және оны қоректендіретін отын.

Chat AI және API — екі түрлі нәрсе:

	Chat AI (Claude / Gemini / ChatGPT)	API
Не екені	Жеке консьержіңіз	Агенттеріңіздің ойлау қозғалтқышы
Кім пайдаланады	Тікелей сіз	Агенттеріңіз, автоматты түрде
Төлем моделі	Жазылым (бекітілген баға)	Пайдаланған сайын төлеу (кіріс + шығыс токендер)
Ұсынылатын	Ақылы жоспар — жақсырақ ой жүгірту	$5 несиеден бастаңыз

Екеуін де не үшін іске қосу керек? (Гибридті баптау)

API төлемі кіріс + шығыс токендер бойынша жұмыс істейді — агентке жіберілген әрбір сөз және оның жауабындағы әрбір сөз аз мөлшерде тұрады.

Яғни агенттеріңізге берген нұсқаулықтарыңыздың маңызы бар.

Сіздің чат-ЖИ-ды (жақсырақ ой жүгірту үшін ақылы жоспар ұсынылады) мына мақсаттар үшін пайдаланыңыз:

• Агенттерге жіберер алдында нақты, қысқаша нұсқаулықтар жасаңыз
• Ұзын құжаттарды агенттерге берер алдында қысқартыңыз
• Агенттер не қалайтыныңызды анықтауға токен жұмсамауы үшін тапсырмаларды алдын ала құрылымдаңыз

Жақсы құрылымдалған 200 токендік нұсқаулық бұлдыр 2000 токендік алмасудың бір бөлігіне тұрады. Сіздің чат-ЖИ — стратег. Агенттеріңіз — орындаушылар. Бұл комбинация API шығындарын төмен ұстай отырып, шығыс сапасын жоғары сақтайды.

Бастамас бұрын — API шығындарының ашықтығы

BALIA OS агенттеріңізді іске қосу үшін AI API кілтін қажет етеді. Бұл нұсқаулықтың $48 бағасынан бөлек.

Сізге не қажет:

• Кемінде $5 алдын ала несиесі бар Anthropic тіркелгісі
• Бұл нұсқаулықтағы барлық агенттер Claude Sonnet 5 пайдаланады

$5 неге бастауға жеткілікті: Claude Sonnet 5-тің бағасы — миллион кіріс токеніне $2 және миллион шығыс токеніне $10 (2026 жылдың 31 тамызына дейінгі енгізу бағасы; одан кейін кіріс $3, шығыс $15-ке ауысады). Типтік агент сессиясы бірнеше мың токен пайдаланады. $5 сізге көп жұмсамастан оқып-үйренуге және тәжірибе жасауға ондаған сессия береді.

Anthropic API-дің тегін деңгейі жоқ. Несие картасы қажет. Несие қосу үшін: console.anthropic.com → Billing → Add credits (ең аз $5)

Бұл BALIA OS іске қосу үшін қажет жалғыз сыртқы шығын. Перспектива үшін: адам көмекшісін жалдау айына $2,000–$5,000 тұрады. Сіздің AI командаңыз бастау үшін $5 API несиесімен жұмыс істейді. Бірдей жұмыс. Шығынның бір бөлігі.

---

Не орнатасыз

Осы бөлімнің соңында сізде бес нәрсе дайын болады:

• VS Code — агент файлдарын өңдеу және командаларды іске қосу жұмыс кеңістігі
• Claude Code — VS Code ішінде қатені түзету мен файлдарды өңдеуді автоматтандыратын гибридті жұмыс тәсілінің орындаушысы (1-бөлімді қараңыз). Чат-ЖИ ретінде Claude Pro пайдалансаңыз, сол жазылыммен тікелей қолдана аласыз — қосымша төлем қажет емес.
• Node.js — OpenClaw іске қосу үшін қажет
• OpenClaw — BALIA OS-ті қоректендіретін AI агент негізі
• Anthropic API кілті — агенттеріңіздің ойлауы үшін пайдаланатын AI қозғалтқышы
• Қауіпсіздік Күзетшісі — файлдарды басқаратын және конфигурацияңызды тексеретін автоматтандырылған орнату көмекшісі

Бұл бөлім қалай жұмыс істейді: Төмендегі промпті көшіріп, сіздің чат-ЖИ-ға жабыстырыңыз. AI сізді бүкіл орнату процесі арқылы жетектейді — операциялық жүйеңізді сұрайды, әрбір қадамнан өткізеді және қателерді түзетуге көмектеседі. Қандай да бір жерде тығырыққа тірелсеңіз, сіздің чат-ЖИ-ға мәселені сипаттаңыз, ол сізге көмектеседі.

---

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

Сіз маған BALIA OS — OpenClaw негізінде жасалған көп агентті AI
операциялық жүйесін орнатып, баптауға көмектесесіз.

Сіздің міндетіңіз — орнатуды қадамма-қадам жетектеу.
Маған бір мезгілде бір сұрақ қойыңыз. Жалғастырмас бұрын жауабымды күтіңіз.
Қате кездессе, жалғастырмас бұрын түзетуге көмектесіңіз.

Орнатып, баптауымыз керек нәрселер, ретімен:

1-ҚАДАМ — Операциялық жүйемді тексеру
Маған сұраңыз: "Сіз Windows-та ма, Mac-та ма?"
Содан кейін барлық қадамдар үшін ОЖ-ма дұрыс нұсқаулықтарды беріңіз.

2-ҚАДАМ — VS Code орнату
code.visualstudio.com сайтынан VS Code орнатуға жетектеңіз
- Windows: орнатушыны жүктеп іске қосыңыз. "Add to PATH" белгіленгенін тексеріңіз.
- Mac: жүктеп алыңыз, архивті ашыңыз, Applications-қа апарыңыз, содан кейін
  "code"-ты PATH-қа қосу үшін shell командасын іске қосыңыз:
  Cmd+Shift+P → "Shell Command: Install 'code' command in PATH"
Орнатудан кейін VS Code-та терминал ашып іске қосуды сұраңыз:
  code --version
Не көрсететінін сұраңыз. Қате болса, түзетуге көмектесіңіз.

2б-ҚАДАМ — VS Code интерфейс тілін ауыстыру (қалауыңызша)
VS Code әдепкі бойынша ағылшын тілінде ашылады. Егер оны қазақ тілінде пайдалануды қаласаңыз, мынаны түсіндіріңіз:
"Microsoft-тың ресми VS Code тіл пакеттерінің ішінде қазіргі уақытта қазақ тілі жоқ.
Сондықтан бұл қадамды өткізіп жіберіп, келесі қадамға тікелей өтуге болады."
Бейресми (қауымдастық жасаған) кеңейтімдерді ұсынудың қажеті жоқ.

3-ҚАДАМ — Python орнату
VS Code терминалында пайдаланушыдан мынаны іске қосуды сұраңыз:
  python --version
"Python 3.x.x" пайда болса, Python бұрыннан орнатылған. Келесі ҚАДАМҒА өтіңіз.

Болмаса, https://www.python.org/downloads/ сайтынан орнатуды айтыңыз
- Windows: Орнатушыны іске қосыңыз. "Add Python to PATH" белгіленгенін тексеріңіз.
- Mac: Орнатушыны іске қосып, әдепкі параметрлер арқылы жалғастырыңыз.

Орнатудан кейін VS Code-ты қайта іске қосып, растау үшін python --version командасын қайта іске қосыңыз.

4-ҚАДАМ — Node.js орнату
nodejs.org сайтынан Node.js 22 немесе одан жоғарысын орнатуға жетектеңіз (LTS нұсқасы).
Орнатудан кейін іске қосуды сұраңыз: node --version
Не көрсететінін сұраңыз.
- v22 немесе одан жоғары болса: тамаша, жалғастырыңыз.
- v22-ден төмен болса: nvm (Mac/Linux) немесе nvm-windows (Windows) арқылы
  жаңартуға жетектеңіз.
- Қате болса: ақауларды жоюға көмектесіңіз.

5-ҚАДАМ — OpenClaw орнату
VS Code терминалында іске қосуға жетектеңіз:
  npm install -g openclaw
Содан кейін тексеріңіз:
  openclaw --version
Жиі кездесетін қателер:
- Mac-та EACCES: npm global prefix түзетуі арқылы жетектеңіз
- "openclaw not found": терминалды жауып қайта ашуды, қайта көруді сұраңыз

5б-ҚАДАМ — Claude Code орнату
Алдымен мынаны түсіндіріңіз:
"Claude Code — Section 1-де таныстырылған гибридті жұмыс тәсілінің орындаушысы.
Ол VS Code ішінде қатені оқып, файлды түзетуден команданы орындауға дейін жасайды.
Claude Pro немесе одан жоғары жоспарға ($20/ай-дан) жазылған болсаңыз, қосымша төлем қажет емес —
claude.ai чаты мен Claude Code бір жазылымды, бір пайдалану лимитін бөліседі.
Section 1-де чат-ЖИ ретінде Claude Pro таңдаған болсаңыз, сол аккаунтпен тікелей кіре аласыз.
Чат-ЖИ ретінде Claude-тан басқасын (ChatGPT, Gemini және т.б.) пайдаланатын болсаңыз,
Claude Code үшін бөлек Claude Pro немесе одан жоғары жазылым, немесе Anthropic API қолжетімділігі қажет."

Мыналарды орындауға жетектеңіз:
1. VS Code терминалында мынаны іске қосып, CLI-ды орнатыңыз:
     npm install -g @anthropic-ai/claude-code
2. Орнатуды растаңыз:
     claude --version
   Нұсқа нөмірі көрсетілетінін тексеріңіз
3. VS Code кеңейтімдер панелінде (Ctrl+Shift+X) "Claude Code" (баспагері: Anthropic)
   деп іздеп, орнатыңыз
4. VS Code терминалында мынаны іске қосып, алғаш рет кіріңіз:
     claude
   Браузер ашылады — Claude Pro аккаунтымен (немесе API кілтімен) кіруге жетектеңіз
5. Кіру аяқталған соң терминалға оралып, промпт көрсетілетінін растаңыз

Жиі кездесетін қателер:
- npm install кезінде EACCES (рұқсат қатесі, Mac/Linux):
    mkdir -p ~/.npm-global
    npm config set prefix ~/.npm-global
    export PATH=~/.npm-global/bin:$PATH
  дегендерді ретімен орындап, қайта көруге жетектеңіз
- "claude: command not found": терминалды жауып, қайта ашып, қайта көруді сұраңыз
- Кіру терезесі ашылмаса: console.anthropic.com сайтында жарамды жазылым/API қолжетімділігі бар-жоғын тексеруді сұраңыз

6-ҚАДАМ — Anthropic API кілтін алу
Алдымен мынаны түсіндіріңіз:
"BALIA OS агенттеріңіз үшін әдепкі AI қозғалтқышы ретінде Claude (Anthropic) пайдаланады.
Қазір тек Claude орнатамыз. Басқа AI қозғалтқыштарын кейінірек қалауыңызға
қарай қосуға болады:
- Өзіңіздің дағдыңызды жасаған кезде (Section 6), сол дағды үшін ең жақсы AI-ды
  таңдайсыз — мысалы, бейнені тікелей талдай алатындықтан YouTube үшін Gemini,
  немесе сату мәтіні үшін GPT-4o.
- BALIA Skill Market ашылғаннан кейін басқа пайдаланушылардың жасаған
  дағдыларын да орнатуға болады, олардың әрқайсысының өз ұсынылған AI
  қозғалтқышы болады."

Содан кейін мыналарды орындауға жетектеңіз:
1. console.anthropic.com сайтына өтіңіз
2. Тіркеліңіз немесе кіріңіз
3. API Keys → Create Key бөліміне өтіңіз
4. Оны "balia-os" деп атаңыз
5. Кілтті көшіріңіз (sk-ant- деп басталады)
Айтыңыз: "Мұны қауіпсіз жерде сақтаңыз — тек бір рет көруге болады."
Жалғастырмас бұрын кілтті алғаныңызды растауды сұраңыз.
Кілтті чатқа жабыстыруды сұрамаңыз.

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 қалтасын көресіз бе?"
Болмаса, ақауларды жоюға көмектесіңіз.

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 кезінде толтырыңыз
# Мысал: 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 webhook-тарды қазір бос қалдырыңыз — нақты URL-дерді Section 4-те аласыз.
URL пішімі: https://discord.com/api/webhooks/numbers/letters
[AGENT1NAME] -ден [AGENT5NAME]-ге дейін агенттеріңіздің атауларымен БАС ӘРІППЕН ауыстырыңыз.
DISCORD_WEBHOOK_SECURITY әрқашан соңғы — ол Security Guardian агенті үшін."

Қауіпсіздік ескертуі — мынаны айтыңыз:
"Токенді файлға қоюдан ыңғайсызданасыз ба:
BALIA_TOKEN-ды қазір өткізіп жіберіп, Section 6 орнатуы кезінде
сұралғанда қолмен енгізуге болады."

Маған айтыңыз: "Бұл файлды ешкіммен бөліспеңіз. Ешқашан GitHub-қа тапсырмаңыз."

9б-ҚАДАМ — API кілтін .env файлына жазу
Ескерту: API кілті 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-қа тапсырмаңыз."
Кілтті чатқа жабыстыруды сұрамаңыз.

9b-ҚАДАМДЫ аяқтаған соң, маған айтыңыз: «Орта дайын. Келесіде Қауіпсіздік Күзетшісін — автоматтандырылған орнату көмекшіңізді орнатамыз.»

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

🛡️ Алдымен Қауіпсіздік Күзетшісін орнатыңыз

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

---

🛡️ Security Guardian орналастыру

⚠️ Ескерту: API шығындарының бақылаусыз өсуі

[Шетелдегі нақты оқиға — BALIA OS-пен байланысты емес] 2025 жылдың қарашасында шетелдік әзірлеуші топтың AI агенті шексіз цикл күйіне кірді және 11 күн бойы ешкім байқамай жұмыс жасай берді, нәтижесінде $47,000 API шоты жиналды. (Дерек: Tech Startups / Hacker News)

AI агенттері пайдаланушы байқамай-ақ API-ді шақыра беруі мүмкін. Осы қауіпті болдырмау үшін Security Guardian тәулік бойы шығындарды бақылайды және ауытқу анықталған кезде Discord-қа дереу ескерту жібереді.

Міндетті түрде мынаны да орнатыңыз:

1. AI провайдерінің консолінде шығын ескертуін орнатыңыз (ұсынылады: $3–5/күн) (Anthropic пайдаланушылары үшін) → https://console.anthropic.com/settings/billing
2. Security Guardian-дың шығын бақылау параметрлерін тексеріңіз (2.5-қадам)

Агент файлдарыңыз дайын.

BALIA OS-те тағы бір агент бар: Security Guardian (security-guardian).

Бұл агент BALIA-мен алдын ала конфигурацияланған. Оның атын, ID-сін немесе жолдарын өзгертпеңіз. Оны өзгерту басқа агенттермен интеграцияны бұзады.

---

Алдын ала шарт: PM2 орнату

PM2 — Node.js процесс менеджері. ПК қайта іске қосылғаннан кейін де Security Guardian автоматты түрде жұмыс істеуін қамтамасыз етеді.

VS Code терминалын ашып, орнату үшін мына команданы қойып жіберіңіз:

npm install -g pm2

PM2 бұрыннан орнатылған болса, бұл қадамды өткізіп жіберіңіз.

---

Орнатушыны жүктеп іске қосыңыз

💡 Токен дегеніміз не?

Бұл сатып алудан кейін сізге жіберілген кіру URL-індегі ?token= кейінгі жол.

Мысал: https://guide.baliaos.com/?token=BALIA-XXXX-XXXX-0001 Бұл жағдайда токен BALIA-XXXX-XXXX-0001.

Электрондық поштаны таппасаңыз, қолдау қызметіне хабарласыңыз.

1-қадам — Орнатушыны жүктеу

VS Code терминалыңызда:

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

2-қадам — Security Guardian-ды 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

Бұл security-guardian-ды тіркейді, сондықтан OpenClaw оған командаларды бағыттай алады.

2.5-қадам — Тіркеуді тексеру

OpenClaw агентті көре алатынын растаңыз:

openclaw agents list

security-guardian тізімде көрсетілуі тиіс. Көрсетілмесе — 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

---

3-қадам — Security Guardian орнатушыны іске қосады

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

Токен .env файлыңыздағы BALIA_TOKEN-нан автоматты оқылады.

Агентіңіз дербес:

1. Токенді аутентификациялайды
2. Security Guardian файлдарын жүктейді
3. .opengoat/agents/security-guardian/ және .opengoat/workspaces/security-guardian/ орналастырады
4. Терминалда "✓ Security Guardian deployed successfully" көрсетеді

⚠️ Маңызды: Security Guardian-ның ID-сін, атын немесе қалта жолдарын өзгертпеңіз. Басқа конфигурация файлдары бұл агентке тікелей сілтеме жасайды. Оларды өзгерту дағды карантин жүйесін бұзады.

Терминалда "✓ Security Guardian deployed successfully" пайда болғаннан кейін келесі қадамға өтіңіз.

INFO

agents/security-guardian/ мен workspaces/[agentid]/ айырмашылығы

BALIA OS әрбір агент үшін екі қалта түрін пайдаланады:

• agents/[id]/ — OpenClaw конфигурация файлдары (config.json, models.json) — OpenClaw агентті іске қосу үшін оларды оқиды
• workspaces/[id]/ — Жұмыс кеңістігі файлдары (SOUL, AGENTS, IDENTITY, HEARTBEAT, TOOLS, USER, SPEC) — агент сессия басталуында оларды оқиды

Security Guardian екеуін де пайдаланады:

• agents/security-guardian/ — config.json және models.json
• workspaces/security-guardian/ — SOUL.md, SPEC_SECURITY.md, scripts/ және басқалары

Арнаулы агенттеріңіз бірдей құрылымды пайдаланады. Екі қалта да $env:USERPROFILE/.opengoat/ астында.

---

Баптауыңызды тексеріңіз

Терминалда "✓ Security Guardian deployed successfully" пайда болғаннан кейін іске қосыңыз:

Windows:

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

Mac:

node ~/.opengoat/workspaces/security-guardian/scripts/verify_setup.js --section 4

Бұл Section 5-те командаңызды іске қоспас бұрын барлық агент файлдарының орнында екенін және Security Guardian дұрыс тіркелгенін растайды.

---

3.5-қадам — gateway-ді тоқтатып, PM2 арқылы Guardian-ды іске қосып, қайта жүктеу

Орнату аяқталғаннан кейін, gateway-ді қауіпсіз түрде қайта іске қосыңыз.

① gateway-ді тоқтатыңыз

openclaw gateway іске қосылған PowerShell-де мынаны басыңыз:

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-ға қойыңыз

Қауіпсіздік Күзетшісі іске қосылды. Workspace қалталарын жасап, орнатуды аяқтайық.

8-ҚАДАМ — Әрбір агент үшін жұмыс кеңістігі қалталарын жасау
Маған айтыңыз: "Section 2-дегі Team Design Document-тен агент
ID-лерін автоматты түрде аламын. Оны қазір тіркеңіз."
Тіркелген Team Design Document-ті оқыңыз.
6 агент атауын/ID-сін шығарып алыңыз (кіші әріппен, бос орынсыз, бос орындар үшін дефис).
Маған тізімді көрсетіңіз:
"Мен осы 6 агентті таптым: [id1], [id2], [id3], [id4], [id5], [id6]
Бұл дұрыс па?"
Растауымды күтіңіз.

Содан кейін барлық 6 жұмыс кеңістігі қалтасын бірден жасау үшін
нақты ID-лер толтырылған нақты командаларды беріңіз.
Мына қалта құрылымын пайдаланыңыз: 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

10-ҚАДАМ — Соңғы тексеру
Осы тізімді маған бір элементтен өтіңіз:
□ code --version → нұсқа нөмірін көрсетеді
□ node --version → v22 немесе одан жоғарысын көрсетеді
□ openclaw --version → нұсқа нөмірін көрсетеді
□ claude --version → нұсқа нөмірін көрсетеді
□ VS Code-та Claude Code кеңейтімі орнатылған және кіру жасалған
□ Шлюз терминалы "✓ Gateway running" деп көрсетеді
□ .opengoat қалтасы бар және расталды
□ 6 агенттің барлығы үшін workspaces/ ішкі қалталары жасалды
□ .opengoat қалтасында .env файлы бар
□ BALIA_TOKEN толтырылды (немесе Section 6-да қолмен енгізу белгіленді)
□ AGENT_ID ceo-ға орнатылды
□ ANTHROPIC_API_KEY толтырылды
□ Қауіпсіздік Күзетшісі орнатылды (терминал шығысы арқылы расталды)

Барлық ұяшықтар белгіленгенде айтыңыз:
"Орнату аяқталды. Section 4-ке дайынсыз —
Агент файлдарыңызды жасау."

8-ҚАДАМНАН бастаңыз. Команда дизайн құжатын тіркеуімді сұраңыз.

---

🛡️ Қауіпсіздік Күзетшісінің Аудиті

Сіздің Қауіпсіздік Күзетшісі бүкіл баптауыңызды тексеріп, барлық мәселелерді автоматты түрде түзетеді.

Күзетші нені тексереді:

• $env:USERPROFILE\\.opengoat\\ астындағы барлық қажетті қалталардың бар-жоғы
• Барлық қажетті файлдардың дұрыс орында екені
• Дұрыс орында емес файлдар автоматты түрде жылжытылады
• Жетіспейтін файлдар автоматты түрде жасалады (бос — 4-бөлімде толтырасыз)

Күзетші әзірше НЕ өзгертеді:

• Файлдардың мазмұны (агент тұлғалары мен баптаулары 4-бөлімде анықталады)

Аудитті іске қосыңыз:

Windows:

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

Күзетші тапқаны мен түзеткені туралы есеп береді. Егер бәрі жасыл болса, 4-бөлімге өтуге дайынсыз.