โครงสร้างโฟลเดอร์ .opengoat เมื่อจบส่วนนี้

โฟลเดอร์เหล่านี้จะถูกสร้างขึ้นทีละขั้นตอนตลอดส่วนที่ 1–8 ไม่ต้องกังวลหากตอนนี้ยังดูว่างเปล่า — แต่ละส่วนจะเพิ่มไฟล์ที่คุณต้องการเข้ามาเรื่อยๆ

📁 โครงสร้างโฟลเดอร์ .opengoat แบบเต็ม

$env:USERPROFILE\.opengoat\          ← โฟลเดอร์หลักของ BALIA OS
├── identity\                         ← สร้างในส่วนที่ 2
│   └── team_design.md               ← เอกสารออกแบบทีม
├── .env                              ← สร้างในส่วนที่ 3 (API key และ webhooks)
├── workspaces\                       ← สร้างในส่วนที่ 3
│   ├── [agentid]\                    ← สร้างต่อ agent หนึ่งตัวในส่วนที่ 4
│   │   ├── SOUL.md
│   │   ├── AGENTS.md
│   │   ├── IDENTITY.md
│   │   ├── HEARTBEAT.md
│   │   ├── TOOLS.md
│   │   ├── USER.md
│   │   └── SPEC_[name].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 ตัวตน ความทรงจำ และ skill ทั้งหมดของ agent จะถูกเก็บไว้ที่นี่

---

💡 API คืออะไร — และเหตุใดคุณจึงต้องใช้มัน?

ลองคิดของ AI agents ของคุณเป็นพนักงานที่ต้อง คิด ก่อนที่จะลงมือทำ

ทุกครั้งที่ agent วิเคราะห์สถานการณ์ เขียนรายงาน หรือตัดสินใจ มันต้องเรียก AI model เพื่อทำการคิดนั้น API คือช่องทางที่ทำให้การเรียกนั้นเกิดขึ้น — และเชื้อเพลิงที่ขับเคลื่อนมัน

Chat AI กับ API — สองสิ่งที่ต่างกัน:

	Chat AI	API
คืออะไร	ผู้ช่วยส่วนตัวของคุณ	เครื่องยนต์การคิดของ agents
ใครใช้งาน	คุณ โดยตรง	Agents ของคุณ โดยอัตโนมัติ
รูปแบบค่าใช้งาน	การสมัครสมาชิก (อัตราเดียว)	จ่ายตามการใช้งาน (input + output tokens)
แนะนำ	แผนแบบจ่ายเงิน — การให้เหตุผลที่ดีกว่า	เริ่มต้นด้วยเครดิต $5

เหตุใดต้องใช้ทั้งคู่? (การตั้งค่าแบบไฮบริด)

การเรียกเก็บเงิน API ทำงานบน input + output tokens — ทุกคำที่ส่งไปให้ agent และทุกคำที่ agent ตอบกลับมาจะมีต้นทุนเล็กน้อย

ซึ่งหมายความว่าวิธีการที่คุณสั่งการ agents มีความสำคัญ

ใช้AI แชทของคุณ (แนะนำแผนแบบจ่ายเงิน) เพื่อ:

• ร่างคำแนะนำที่ชัดเจนและกระชับก่อนส่งให้ agents
• สรุปเอกสารยาวก่อนส่งให้ agents
• จัดโครงสร้างงานล่วงหน้าเพื่อไม่ให้ agents เสียเวลา tokens ในการเข้าใจสิ่งที่คุณต้องการ

คำแนะนำที่มีโครงสร้างดี 200-token มีต้นทุนน้อยกว่าการสนทนากลับไปกลับมาแบบคลุมเครือ 2,000-token มาก Chat AI ของคุณคือนักกลยุทธ์ Agents ของคุณคือผู้ปฏิบัติงาน การรวมกันนี้ช่วยให้ต้นทุน API ต่ำในขณะที่รักษาคุณภาพของผลลัพธ์ให้สูง

ก่อนเริ่มต้น — ความโปร่งใสเรื่องค่าใช้จ่าย API

BALIA OS ต้องการ AI API Key เพื่อรันเอเจนต์ของคุณ ซึ่งแยกต่างหากจากค่าคู่มือ $48

สิ่งที่คุณต้องมี：

• บัญชี Anthropic พร้อมเครดิตล่วงหน้าอย่างน้อย $5
• เอเจนต์ทั้งหมดในคู่มือนี้ใช้ Claude Sonnet 5

ทำไม $5 ถึงพอสำหรับการเริ่มต้น： Claude Sonnet 5 มีราคา $2 ต่อล้าน token สำหรับ input และ $10 ต่อล้าน token สำหรับ output (ราคาเปิดตัว ใช้ได้ถึงวันที่ 31 สิงหาคม 2026 หลังจากนั้นจะปรับเป็น $3 สำหรับ input และ $15 สำหรับ output) เซสชันเอเจนต์ทั่วไปใช้โทเคนเพียงไม่กี่พัน $5 เพียงพอสำหรับหลายสิบเซสชันในการเรียนรู้

Anthropic API ไม่มีแผนฟรี ต้องใช้บัตรเครดิต เติมเครดิต: console.anthropic.com → Billing → Add credits (ขั้นต่ำ $5)

นี่คือค่าใช้จ่ายภายนอกเพียงอย่างเดียวที่จำเป็นสำหรับการรัน BALIA OS เพื่อให้เห็นภาพ: การจ้างผู้ช่วยมนุษย์มีค่าใช้จ่าย $2,000–$5,000 ต่อเดือน ทีม AI ของคุณทำงานได้ด้วยเครดิต API มูลค่า $5 เพื่อเริ่มต้น งานเดิม ค่าใช้จ่ายเพียงเสี้ยวหนึ่ง

---

สิ่งที่คุณจะติดตั้ง

เมื่อสิ้นสุดส่วนนี้ คุณจะมีห้าสิ่งที่พร้อมใช้งาน:

• VS Code — workspace สำหรับแก้ไขไฟล์เอเจนต์และรันคำสั่งต่างๆ
• Claude Code — ผู้รับผิดชอบการดำเนินการของระบบไฮบริดที่แก้ไข error และแก้ไขไฟล์โดยอัตโนมัติภายใน VS Code (ดูส่วนที่ 1) หากคุณสมัครแผน Claude Pro เป็น AI แชทของคุณอยู่แล้ว ใช้สัญญาสมาชิกเดิมได้เลยโดยไม่ต้องซื้อเพิ่ม
• Node.js — จำเป็นสำหรับการรัน OpenClaw และ Claude Code
• OpenClaw — กรอบงาน AI เอเจนต์ที่ขับเคลื่อน BALIA OS
• Anthropic API key — เครื่องยนต์ AI ที่เอเจนต์ของคุณใช้คิดวิเคราะห์
• ผู้ดูแลความปลอดภัย — ผู้ช่วยตั้งค่าอัตโนมัติที่จัดการไฟล์และตรวจสอบการกำหนดค่าของคุณ

วิธีการใช้งานส่วนนี้: คัดลอก prompt ด้านล่างแล้ววางลงในAI แชทของคุณ AI จะแนะนำคุณตลอดกระบวนการติดตั้งทั้งหมด — โดยถามระบบปฏิบัติการของคุณ พาคุณผ่านแต่ละขั้นตอน และช่วยแก้ไขปัญหาที่อาจเกิดขึ้น หากคุณติดขัดที่จุดใด เพียงอธิบายปัญหาให้ AI ฟัง แล้วมันจะช่วยคุณผ่านไปได้

---

▶ วางสิ่งนี้ลงในเอไอของคุณเพื่อเริ่มต้น

คุณกำลังช่วยฉันติดตั้งและตั้งค่า BALIA OS — ระบบปฏิบัติการ AI แบบมัลติเอเจนต์ที่สร้างบน OpenClaw

หน้าที่ของคุณคือแนะนำฉันผ่านการติดตั้งทีละขั้นตอน ถามฉันทีละคำถาม รอคำตอบของฉันก่อนดำเนินการต่อ หากฉันเจอข้อผิดพลาด ช่วยฉันแก้ไขก่อนดำเนินการต่อ

นี่คือทุกสิ่งที่เราต้องติดตั้งและตั้งค่า ตามลำดับ:

ขั้นตอนที่ 1 — ตรวจสอบระบบปฏิบัติการของฉัน
ถามฉันว่า: "คุณใช้ Windows หรือ Mac?"
จากนั้นให้คำแนะนำที่ถูกต้องสำหรับ OS ของฉันตลอดทุกขั้นตอน

ขั้นตอนที่ 2 — ติดตั้ง VS Code
แนะนำให้ติดตั้ง VS Code จาก code.visualstudio.com
- Windows: ดาวน์โหลดและรันตัวติดตั้ง ตรวจสอบให้แน่ใจว่าติ๊ก "Add to PATH" แล้ว
- Mac: ดาวน์โหลด แตกไฟล์ ลากไปที่ Applications จากนั้นรันคำสั่ง shell เพื่อเพิ่ม "code" ลงใน PATH: Cmd+Shift+P → "Shell Command: Install 'code' command in PATH"
หลังติดตั้งเสร็จ ให้ฉันเปิด terminal ใน VS Code แล้วรัน:
  code --version
ถามฉันว่าแสดงผลอะไร หากมีข้อผิดพลาด ช่วยฉันแก้ไข

ขั้นตอนที่ 2b — เปลี่ยนภาษาที่แสดงผลของ VS Code (ไม่บังคับ)
VS Code แสดงผลเป็นภาษาอังกฤษตามค่าเริ่มต้น หากผู้ใช้ต้องการใช้งานเป็นภาษาไทย ให้แจ้งว่า
ขณะนี้ Microsoft ยังไม่มี Language Pack ภาษาไทยอย่างเป็นทางการสำหรับ 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
แนะนำให้ติดตั้ง Node.js เวอร์ชัน 22 ขึ้นไปจาก nodejs.org (เวอร์ชัน LTS)
หลังติดตั้งเสร็จ ให้ฉันรัน: node --version
ถามฉันว่าแสดงผลอะไร
- ถ้า v22 ขึ้นไป: ดีมาก ไปต่อได้เลย
- ถ้าต่ำกว่า v22: แนะนำให้อัปเกรดด้วย nvm (Mac/Linux) หรือ nvm-windows (Windows)
- ถ้ามีข้อผิดพลาด: ช่วยแก้ไขปัญหา

ขั้นตอนที่ 5 — ติดตั้ง OpenClaw
แนะนำให้รันในเทอร์มินัล VS Code:
  npm install -g openclaw
จากนั้นตรวจสอบด้วย:
  openclaw --version
ข้อผิดพลาดที่พบบ่อย:
- EACCES บน Mac: แนะนำวิธีแก้ไข npm global prefix
- "openclaw not found": ให้ปิดและเปิดเทอร์มินัลใหม่ แล้วลองอีกครั้ง

ขั้นตอนที่ 5b — ติดตั้ง Claude Code
อธิบายก่อนว่า:
"Claude Code คือผู้รับผิดชอบการดำเนินการของระบบไฮบริดที่แนะนำไว้ในส่วนที่ 1
มันอ่าน error ได้ทันทีในหน้า VS Code และจัดการแก้ไขไฟล์รวมถึงรันคำสั่งให้คุณ
หากคุณสมัครแผน Claude Pro ขึ้นไป ($20/เดือนขึ้นไป) อยู่แล้ว ไม่ต้องซื้อเพิ่ม —
แชทที่ claude.ai กับ Claude Code ใช้การสมัครสมาชิกและโควตาการใช้งานเดียวกัน
ถ้าในส่วนที่ 1 คุณเลือก Claude Pro เป็น AI แชทของคุณ ก็ล็อกอินด้วยบัญชีเดิมได้เลยที่นี่
ถ้าใช้ 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 (Ctrl+Shift+X) ค้นหา "Claude Code"
   (ผู้เผยแพร่: Anthropic) แล้วติดตั้ง
4. รันคำสั่งต่อไปนี้ในเทอร์มินัล VS Code เพื่อล็อกอินครั้งแรก:
     claude
   หน้าต่างเบราว์เซอร์จะเปิดขึ้น — แนะนำให้ฉันล็อกอินด้วยบัญชี
   Claude Pro ของฉัน (หรือ API key)
5. หลังล็อกอินสำเร็จ ตรวจสอบว่าเทอร์มินัลกลับมาแสดง prompt ตามปกติ

ข้อผิดพลาดที่พบบ่อย:
- EACCES ตอน npm install (ปัญหาสิทธิ์บน 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 ว่ามี subscription หรือ API access ที่ใช้งานได้หรือไม่

ขั้นตอนที่ 6 — รับ Anthropic API key
อธิบายก่อนว่า:
"BALIA OS ใช้ Claude (Anthropic) เป็นเครื่องยนต์ AI เริ่มต้นสำหรับเอเจนต์ของคุณ
ตอนนี้เราจะตั้งค่าเฉพาะ Claude ก่อน ส่วนเครื่องยนต์ AI อื่นสามารถเพิ่มทีหลังได้
ขึ้นอยู่กับสิ่งที่คุณต้องการสร้าง:
- เมื่อสร้างคาสเซ็ตของคุณเอง (ส่วนที่ 6) คุณจะเลือก AI ที่เหมาะสมที่สุด
  สำหรับคาสเซ็ตนั้น เช่น Gemini สำหรับ YouTube เพราะวิเคราะห์วิดีโอได้โดยตรง
  หรือ GPT-4o สำหรับงานเขียนขาย
- หลังจาก BALIA Skill Market เปิดตัว คุณจะสามารถติดตั้ง skill
  ที่สร้างโดยผู้ใช้คนอื่นได้ด้วย แต่ละอันมีเครื่องยนต์ AI ที่แนะนำของตัวเอง"

จากนั้นแนะนำให้ฉัน:
1. ไปที่ console.anthropic.com
2. สมัครสมาชิกหรือล็อกอิน
3. ไปที่ API Keys → Create Key
4. ตั้งชื่อว่า "balia-os"
5. คัดลอก key (เริ่มต้นด้วย sk-ant-)
บอกฉัน: "เก็บสิ่งนี้ไว้ในที่ปลอดภัย — คุณจะเห็นมันได้เพียงครั้งเดียว"
ให้ฉันยืนยันว่ามี key แล้วก่อนดำเนินการต่อ
ห้ามขอให้ฉันวาง key ลงในแชทเด็ดขาด

ขั้นตอนที่ 7 — รัน OpenClaw setup
แนะนำให้รันในเทอร์มินัล VS Code:
  openclaw setup
บอกฉันว่าจะเกิดอะไรขึ้น:
- มันจะถาม Anthropic API key ของฉัน — วางไว้ตรงนั้น
- มันจะสร้างโฟลเดอร์ ~/.opengoat/ (Mac) หรือ
  $env:USERPROFILE\.opengoat\ (Windows) ให้อัตโนมัติ
  นี่คือโฟลเดอร์หลักของ BALIA OS — ไฟล์เอเจนต์ทั้งหมดจะอยู่ที่นี่
หลังตั้งค่าเสร็จ แนะนำให้ฉันรันคำสั่งนี้เพื่อเริ่ม gateway:
  Windows: $env:DEBUG="-ciao*"; openclaw gateway --force
  Mac:     DEBUG="-ciao*" openclaw gateway --force
ให้ฉันยืนยันว่าเห็น:
  "✓ Gateway running on port 18789"
บอกฉัน: "เปิดแท็บเทอร์มินัลนี้ทิ้งไว้ — นี่คือ gateway ของคุณ เปิดแท็บใหม่สำหรับคำสั่งอื่นๆ ทั้งหมดต่อจากนี้"

จากนั้นให้ฉันยืนยันว่าโฟลเดอร์ถูกสร้างแล้ว:
- Windows: dir $env:USERPROFILE\.opengoat
- Mac:     ls ~/.opengoat
ถามฉันว่า: "คุณเห็นโฟลเดอร์ .opengoat หรือไม่?"
ถ้าไม่เห็น ช่วยแก้ไขปัญหา

ขั้นตอนที่ 9 — สร้างไฟล์ .env
แนะนำให้ฉันสร้างไฟล์ .env ในโฟลเดอร์ .opengoat
- Windows: ใน VS Code เปิดโฟลเดอร์ $env:USERPROFILE\.opengoat
           คลิกขวาที่แผงด้านซ้าย → New File → ตั้งชื่อว่า .env
- Mac:     ใน VS Code เปิดโฟลเดอร์ ~/.opengoat
           คลิกขวาที่แผงด้านซ้าย → New File → ตั้งชื่อว่า .env

จากนั้นวาง template นี้:

# BALIA OS
BALIA_TOKEN=ใส่-token
AGENT_ID=ceo

# Anthropic API
ANTHROPIC_API_KEY=sk-ant-ใส่-key

# โมเดล agent
CLAUDE_MODEL=claude-sonnet-5

# Discord Webhooks — กรอกในส่วนที่ 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'
คัดลอก token (เริ่มต้นด้วย BALIA-) แล้ววางหลัง BALIA_TOKEN=
นี่คือครั้งเดียวที่คุณต้องกรอก —
ตัวติดตั้งในส่วนที่ 6 จะอ่านมันโดยอัตโนมัติจากไฟล์นี้
ห้ามวาง token ลงในแชทนี้เด็ดขาด"

กรอก AGENT_ID:
"นี่คือ ID ของเอเจนต์ CEO ของคุณ — เอเจนต์หลักที่คุณคุยด้วยบ่อยที่สุด
ID นี้ตายตัว: ceo ให้เก็บ AGENT_ID=ceo ไว้ตามที่ปรากฏด้านบนเป๊ะๆ
อย่าเปลี่ยนแปลง สคริปต์ติดตั้งและส่วนที่ 4 ทั้งคู่พึ่งพาค่านี้"

บอกฉัน: "เว้น Discord webhooks ว่างไว้ก่อน — คุณจะได้ URL จริงในส่วนที่ 4
รูปแบบของ URL จะเป็นแบบนี้: https://discord.com/api/webhooks/numbers/letters
แทนที่ [AGENT1NAME] ถึง [AGENT5NAME] ด้วยชื่อเอเจนต์ของคุณเป็นตัวพิมพ์ใหญ่
DISCORD_WEBHOOK_SECURITY อยู่ท้ายสุดเสมอ — สำหรับเอเจนต์ Security Guardian"

ข้อควรระวังด้านความปลอดภัย — บอกสิ่งนี้:
"หากคุณไม่สบายใจที่จะใส่ token ของคุณลงในไฟล์:
คุณสามารถข้าม BALIA_TOKEN ไว้ก่อนได้ แล้วกรอกด้วยตนเอง
เมื่อระบบถามระหว่างการติดตั้งในส่วนที่ 6"

บอกฉัน: "ห้ามแชร์ไฟล์นี้เด็ดขาด ห้าม commit ขึ้น GitHub เด็ดขาด"

ขั้นตอนที่ 9b — เขียน API key ลงในไฟล์ .env
หมายเหตุ: API key ถูกกรอกไปแล้วในขั้นตอนที่ 7 (openclaw setup) อธิบายว่าทำไมต้องกรอกที่นี่ด้วย
บอกว่า: "คุณกำลังตั้งค่า API key เดียวกันไว้สองที่:
- openclaw setup เก็บมันไว้ในการตั้งค่าภายในของ OpenClaw เอง
- ไฟล์ .env ของคุณเก็บมันไว้ให้เอเจนต์ BALIA OS — เอเจนต์อ่าน key ของตัวเองจาก .env โดยตรง
ทั้งสองที่ต้องมี key เดียวกัน นี่คือการตั้งค่าเพียงครั้งเดียว"
แนะนำให้ฉัน:
1. เปิดไฟล์ .env ใน VS Code (อยู่ในโฟลเดอร์ .opengoat)
2. หาบรรทัด: ANTHROPIC_API_KEY=sk-ant-ใส่-key
3. แทนที่ "sk-ant-ใส่-key" ด้วย key จริงของฉัน
4. บันทึกไฟล์ (Ctrl+S บน Windows / Cmd+S บน Mac)
ยืนยัน: "API key ของคุณถูกบันทึกในไฟล์ .env แล้ว
ห้ามแชร์ไฟล์นี้หรือ commit ขึ้น GitHub เด็ดขาด"
ห้ามขอให้ฉันวาง key ลงในแชทเด็ดขาด

เมื่อเสร็จสิ้นขั้นตอนที่ 9b บอกฉันว่า: "สภาพแวดล้อมของคุณพร้อมแล้ว ต่อไปเราจะตั้งค่าผู้ดูแลความปลอดภัย — ผู้ช่วยการตั้งค่าอัตโนมัติของคุณ"

เริ่มได้เลย ถามคำถามแรกฉัน

🛡️ ตั้งค่าผู้ดูแลความปลอดภัยก่อน

ก่อนสร้าง agents เราจะเริ่มต้นผู้ดูแลความปลอดภัยของคุณ จากนี้เป็นต้นไป ผู้ดูแลความปลอดภัยจะตรวจสอบการตั้งค่าของคุณโดยอัตโนมัติ ย้ายไฟล์ไปยังตำแหน่งที่ถูกต้องหากจำเป็น และสร้างไฟล์ที่ขาดหายไป คุณไม่ต้องกังวลเกี่ยวกับการทำผิดพลาด — ผู้ดูแลดูแลคุณ

---

🛡️ ปรับใช้ผู้ดูแลความปลอดภัย

⚠️ คำเตือน: ค่าใช้จ่าย API ที่ควบคุมไม่ได้

[เหตุการณ์จริงในต่างประเทศ — ไม่เกี่ยวข้องกับ BALIA OS] ในเดือนพฤศจิกายน 2025 เอเจนต์ AI ในทีมพัฒนาต่างประเทศเข้าสู่สภาวะวนซ้ำไม่สิ้นสุด และทำงานต่อเนื่องนาน 11 วันโดยไม่มีใครสังเกตเห็น ส่งผลให้เกิดค่า API $47,000 (ที่มา: Tech Startups / Hacker News)

เอเจนต์ AI อาจเรียก API ต่อเนื่องโดยที่ผู้ใช้ไม่รู้ตัว เพื่อป้องกันความเสี่ยงนี้ Security Guardian ตรวจสอบค่าใช้จ่ายตลอด 24 ชั่วโมง และส่งการแจ้งเตือน 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 ทำงานโดยอัตโนมัติ แม้หลังจากรีสตาร์ท PC

เปิด Terminal ของ VS Code แล้ววางคำสั่งต่อไปนี้เพื่อติดตั้ง:

npm install -g pm2

ข้ามขั้นตอนนี้หาก PM2 ติดตั้งอยู่แล้ว

---

ดาวน์โหลดและรันตัวติดตั้ง

💡 Token คืออะไร?

คือสตริงหลัง ?token= ในลิงก์เข้าถึงที่ส่งมาหลังการซื้อ

ตัวอย่าง: https://guide.baliaos.com/?token=BALIA-XXXX-XXXX-0001 ในกรณีนี้ Token คือ 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

token จะถูกอ่านโดยอัตโนมัติจาก BALIA_TOKEN ในไฟล์ .env ของคุณ

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
rollback.autoRecovery	true	Rollback อัตโนมัติ (false = อนุมัติด้วยตนเอง)
snapshot.intervalMinutes	10	ความถี่ในการสร้าง snapshot (นาที)
snapshot.maxSnapshots	3	จำนวน snapshot ที่เก็บไว้
watchdog.checkGateway	true	ตรวจสอบ gateway ของ OpenClaw
watchdog.checkWSL2	false	ตรวจสอบ WSL2 (ปิดโดยค่าเริ่มต้น)
scanner.runIntervalHours	4	ความถี่การสแกนกักกัน (ชั่วโมง)
git.autoPushEnabled	true	สำรองข้อมูลอัตโนมัติไปยัง GitHub
git.autoPushIntervalMinutes	30	ความถี่การสำรองข้อมูล (นาที)

หลังจากเปลี่ยนการตั้งค่า ให้รีสตาร์ท Security Guardian:

pm2 restart security-guardian

---

ขั้นตอนที่ 3 — ให้เอเจนต์รันตัวติดตั้ง

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

token จะถูกอ่านโดยอัตโนมัติจาก BALIA_TOKEN ในไฟล์ .env ของคุณ

เอเจนต์จะดำเนินการโดยอัตโนมัติ:

1. ยืนยันโทเค็นของคุณ
2. ดาวน์โหลดไฟล์ Security Guardian
3. ปรับใช้ไปที่ .opengoat/agents/security-guardian/ และ .opengoat/workspaces/security-guardian/
4. แสดง "✓ Security Guardian deployed successfully" ใน terminal

⚠️ สำคัญ: ห้ามเปลี่ยน ID ชื่อ หรือเส้นทางโฟลเดอร์ของ Security Guardian ไฟล์การกำหนดค่าอื่นๆ อ้างอิงเอเจนต์นี้โดยตรง การเปลี่ยนแปลงจะทำให้ระบบกักกัน skill เสียหาย

เมื่อ terminal แสดง "✓ Security Guardian deployed successfully" ให้ดำเนินการต่อไปยังขั้นตอนถัดไปด้านล่าง

INFO

agents/security-guardian/ กับ workspaces/[agentid]/

BALIA OS ใช้โฟลเดอร์สองประเภทสำหรับ agent แต่ละตัว:

• agents/[id]/ — ไฟล์การตั้งค่าของ OpenClaw (config.json, models.json) — OpenClaw อ่านไฟล์เหล่านี้เพื่อเปิดใช้งาน agent
• workspaces/[id]/ — ไฟล์ workspace (SOUL, AGENTS, IDENTITY, HEARTBEAT, TOOLS, USER, SPEC) — agent จะอ่านไฟล์เหล่านี้ตอนเริ่ม session

Security Guardian ใช้ทั้งสองแบบ:

• agents/security-guardian/ — config.json และ models.json
• workspaces/security-guardian/ — SOUL.md, SPEC_SECURITY.md, scripts/ และอื่นๆ

agent ที่คุณสร้างเองก็ใช้โครงสร้างเดียวกันนี้ ทั้งสองโฟลเดอร์อยู่ภายใต้ $env:USERPROFILE/.opengoat/

---

ขั้นตอน 3.5 — หยุด gateway เริ่ม Guardian ด้วย PM2 แล้วรีสตาร์ต

เมื่อการติดตั้งเสร็จสมบูรณ์ รีสตาร์ต gateway อย่างปลอดภัย

① หยุด gateway

ใน PowerShell ที่รัน openclaw gateway กด:

Ctrl + C

หากถูกถามว่า "สิ้นสุด?" ให้กด Y แล้ว Enter

② เริ่ม Security Guardian ด้วย PM2

เปิด 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 — สร้างโฟลเดอร์ workspace สำหรับแต่ละเอเจนต์
บอกฉัน: "ฉันจะอ่านเอกสารออกแบบทีมของคุณจากส่วนที่ 2 เพื่อรับ ID เอเจนต์
ของคุณโดยอัตโนมัติ กรุณาแนบมันตอนนี้"
อ่านเอกสารออกแบบทีมที่แนบมา
ดึงชื่อ/ID เอเจนต์ทั้ง 6 คน (แปลงเป็นตัวพิมพ์เล็ก ไม่มีช่องว่าง ใช้ขีดกลางแทนช่องว่าง)
แสดงรายการให้ฉันดู:
"ฉันพบเอเจนต์ 6 คนนี้: [id1], [id2], [id3], [id4], [id5], [id6]
ถูกต้องหรือไม่?"
รอการยืนยันจากฉัน

จากนั้นให้คำสั่งที่แน่นอนสำหรับสร้างโฟลเดอร์ workspace ทั้ง 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 → แสดงหมายเลขเวอร์ชัน
□ ส่วนขยาย Claude Code ติดตั้งใน VS Code แล้วและล็อกอินเรียบร้อย
□ เทอร์มินัล Gateway แสดง "✓ Gateway running"
□ โฟลเดอร์ .opengoat มีอยู่และได้รับการยืนยันแล้ว
□ โฟลเดอร์ย่อยใน workspaces/ ถูกสร้างครบทั้ง 6 เอเจนต์
□ ไฟล์ .env มีอยู่ในโฟลเดอร์ .opengoat
□ BALIA_TOKEN ถูกกรอกแล้ว (หรือบันทึกไว้ว่าจะกรอกด้วยตนเองในส่วนที่ 6)
□ AGENT_ID ถูกตั้งเป็น ceo
□ ANTHROPIC_API_KEY ถูกกรอกแล้ว
□ ผู้ดูแลความปลอดภัยถูกปรับใช้แล้ว (ยืนยันผ่านเอาต์พุต terminal)

เมื่อทุกช่องถูกเลือกแล้ว บอกว่า:
"การติดตั้งเสร็จสมบูรณ์ คุณพร้อมสำหรับส่วนที่ 4 —
การสร้างไฟล์เอเจนต์ของคุณ"

เริ่มด้วยขั้นตอนที่ 8 ขอให้ฉันแนบเอกสารการออกแบบทีม

---

🛡️ การตรวจสอบ Security Guardian

Security Guardian ของคุณจะตรวจสอบการตั้งค่าทั้งหมดและแก้ไขปัญหาอัตโนมัติ

สิ่งที่ Guardian ตรวจสอบ:

• โฟลเดอร์ที่จำเป็นทั้งหมดมีอยู่ใน $env:USERPROFILE\.opengoat\
• ไฟล์ที่จำเป็นทั้งหมดอยู่ในตำแหน่งที่ถูกต้อง
• ไฟล์ที่อยู่ผิดตำแหน่งจะถูกย้ายอัตโนมัติ
• ไฟล์ที่ขาดหายจะถูกสร้างอัตโนมัติ (ว่างเปล่า — คุณจะกรอกใน Section 4)

สิ่งที่ Guardian ยังไม่เปลี่ยนแปลง:

• เนื้อหาในไฟล์ (บุคลิกและการตั้งค่าของ agent จะมาใน Section 4)

เรียกใช้การตรวจสอบ:

Windows:

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

Mac:

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

Guardian จะรายงานสิ่งที่พบและแก้ไข หากทุกอย่างเป็นสีเขียว คุณพร้อมสำหรับ Section 4