ติดตั้งจาก 0

3.1 ก่อนเริ่ม

การติดตั้ง Oracle จากศูนย์ควรทำตามลำดับ dependency ไม่ใช่สุ่ม clone ทุก repo เพราะแต่ละชั้นมีหน้าที่ต่างกัน

3.2 Clone หรือ install Oracle memory

เริ่มจาก runtime หลักคือ arra-oracle-v3 เพราะ agent และ UI ต้องพึ่ง memory layer

export ORACLE_SOURCE_ORG=Soul-Brews-Studio  # org ของอาจารย์ Nat
ghq get "$ORACLE_SOURCE_ORG/arra-oracle-v3"
cd "$HOME/ghq/github.com/$ORACLE_SOURCE_ORG/arra-oracle-v3"
bun install

ตั้ง ORACLE_SOURCE_ORG เป็น org หรือ fork ที่ทีมใช้จริง โดยต้นน้ำหลักคือ Soul-Brews-Studio (org ของอาจารย์ Nat) ถ้าเครื่องนี้ใช้ fork ส่วนตัว ให้ clone fork ได้ แต่ต้องจำว่าระบบจริงคือ memory layer ไม่ใช่หนังสือหรือ UI

3.3 ตั้ง data dir

เลือก data dir กลางหนึ่งที่ agent ทุกตัวใช้ร่วมกัน เช่น ~/.oracle

export ORACLE_DATA_DIR="$HOME/.oracle"
mkdir -p "$ORACLE_DATA_DIR"

fleet หนึ่งควรมี data store กลางเดียว ไม่อย่างนั้น Codex, Claude และ UI จะเห็นจำนวนเอกสารไม่เท่ากัน

3.4 Start HTTP API และตรวจสุขภาพ

หลัง install แล้วให้เปิด HTTP API ก่อน เพื่อให้ UI และ maw ตรวจได้

ORACLE_DATA_DIR="$HOME/.oracle" bun run src/server.ts
curl -s http://localhost:47778/api/stats
curl -s "http://localhost:47778/api/search?q=oracle&limit=5"

ถ้า API ตอบ แต่ search ว่าง ให้แยกปัญหาเป็นเรื่อง index/data ไม่ใช่เรื่อง network

3.5 Register MCP ให้ agent

MCP คือทางที่ agent ใช้เรียก Oracle tools ผ่าน stdio ตัวอย่าง Codex ควรชี้ไปที่ wrapper script ของ repo ที่ติดตั้งจริง และส่ง env ORACLE_DATA_DIR ให้ถูก

codex mcp list
codex mcp get arra-oracle-v3

ถ้ายังไม่ได้ register ให้เพิ่มผ่าน config ของ agent นั้น แล้ว restart session เพื่อให้ tool list โหลดใหม่

3.6 ติดตั้ง skills

ใช้ arra-oracle-skills-cli เพื่อให้ agent หลายตัวมี command และ workflow เดียวกัน

bun add -g "github:$ORACLE_SOURCE_ORG/arra-oracle-skills-cli"
arra-oracle-skills install -g --profile lab

profile คือชุดของ skill ที่ติดตั้งให้ agent ใช้ งานจริงควรลงให้ครบ เพราะ skill เป็นไฟล์ markdown ในเครื่อง ไม่ได้เป็น process ที่กิน CPU หรือ RAM ตลอดเวลา

แนะนำ: ลง lab ให้ครบ เพราะ skill ที่ไม่ได้ใช้ไม่เปลือง resource มันแค่เป็นไฟล์ใน ~/.claude/skills/ หรือ ~/.codex/skills/

คำสั่ง switch profile:

# ดู profile ปัจจุบัน
arra-oracle-skills list -g

# เปลี่ยน profile (ใช้ /go skill ใน Claude Code)
/go lab          # เปลี่ยนเป็น lab profile
/go full         # เปลี่ยนเป็น full profile
/go standard     # ลดลงเป็น standard

ติดตั้งให้หลาย agent พร้อมกัน:

# Claude Code
arra-oracle-skills install -g --agent claude --profile lab

# Codex
arra-oracle-skills install -g --agent codex --profile lab

# ตรวจสอบ
ls ~/.claude/skills/ | wc -l    # ควรได้ 47+
ls ~/.codex/skills/ | wc -l     # ควรได้ 47+

หลังติดตั้งให้ตรวจว่า path ของ agent นั้นมี skill จริง เช่น ~/.codex/skills และ ~/.claude/skills

3.7 ติดตั้ง maw-js

เมื่อต้องคุมหลาย agent ให้ติดตั้ง maw-js

bun add -g "github:$ORACLE_SOURCE_ORG/maw-js"
maw --help
maw ls

ตั้งค่า maw ให้รู้จัก Oracle HTTP API โดยแก้ไฟล์ config ของ instance นั้นโดยตรง

mkdir -p ~/.config/maw
$EDITOR ~/.config/maw/maw.config.json
# ตั้ง oracleUrl = http://localhost:47778

3.8 Start maw server และ UI

maw serve เปิด API, websocket และ packed UI บน port default 3456

maw serve
curl -s http://localhost:3456/api/config

ถ้าใช้ UI แยก ให้ maw-ui อ่านจาก maw API ไม่ใช่ถือ state เอง

3.9 ติดตั้ง plugin

Core plugins เช่น wake, sleep, stop, done ควรถูก bootstrap ก่อน ส่วน optional plugins ติดตั้งลง ~/.maw/plugins

maw plugin list
maw plugin install <plugin-name>

plugin ที่ดีควรมี plugin.json, handler, manifest surface และ version/hash ที่ตรวจสอบได้

3.10 Verify end-to-end

3.11 ข้อควรระวัง

• อย่าใช้ book repo เป็น runtime dependency
• อย่าให้ Codex กับ Claude ชี้คนละ ORACLE_DATA_DIR
• อย่า debug UI ก่อนตรวจ HTTP API
• อย่าลบ psi เพื่อแก้ปัญหา search ก่อน backup
• ถ้าเปลี่ยน env ของ service ที่รันค้าง ต้อง restart process นั้น