ทำไม Workspace Files สำคัญ?
Workspace คือบ้านของ Agent ซึ่งเก็บข้อมูลความทรงจำ การตั้งค่า และข้อมูลผู้ใช้ทั้งหมด
Workspace แยกจาก ~/.openclaw/ ซึ่งเก็บ config, credentials และ sessions ต่างหาก — ดังนั้นเพียงแค่สำรอง workspace ก็เพียงพอสำหรับการกู้คืนความทรงจำ
ทุกครั้งที่อัปเดตไฟล์ใน workspace ให้อย่าลืม commit/push และรัน git pull บน server 192.168.77.34
โครงสร้างไฟล์ Workspace
สิ่งที่ต้องเตรียม
-
สถานที่เก็บ
ค่า default:~/.openclaw/workspaceหรือ override ในopenclaw.json -
git
ติดตั้งแล้ว และสามารถใช้คำสั่ง git init, add, commit, push ได้ -
เวลาที่ใช้
ติดตั้งครั้งแรก: 10 นาที | สำรอง git: 5 นาที
คู่มือไฟล์แต่ละไฟล์
AGENTS.md
คำสั่งการใช้งานสำหรับ agent และวิธีการใช้ memory
- โหลดทุกครั้งที่เริ่ม session
- ที่ดีสำหรับกฎ, ลำดับความสำคัญ, วิธีการปฏิบัติ
- ตัวอย่าง: โครงสร้าง session, วิธีเขียน memory
ตัวอย่าง AGENTS.md:
# AGENTS.md - คำสั่งการใช้งาน Agent
## การใช้งาน:
1. อ่านทุกครั้งที่เริ่ม session
2. ปฏิบัติตามกฎและขั้นตอน
3. ใช้ memory/YYYY-MM-DD.md สำหรับรายวัน
SOUL.md
บุคลิก, โทนเสียง และขอบเขตของ agent
- โหลดทุกครั้งที่เริ่ม session
- กำหนดวิธีการสื่อสารกับคุณ
- ตัวอย่าง: ใช้ภาษาไทย, ชื่อคุณคือ Yimmy
ตัวอย่าง SOUL.md:
# SOUL.md - จิตวิญญาณของ Agent
## หลักการ:
- ช่วยให้จริง ไม่ใช่แสดง
- มีความเห็นและสไตล์
- แก้ปัญหาด้วยตัวเองก่อนถาม
## สไตล์การสื่อสาร:
- สื่อสารกับคุณเป็นภาษาไทย
USER.md
ข้อมูลเกี่ยวกับคุณและวิธีการติดต่อ
- โหลดทุกครั้งที่เริ่ม session
- ตั้งค่า timezone, สื่อสาร, ความชอบส่วนตัว
- ตัวอย่าง: คุณชื่อ Yimmy, timezone เป็น Thailand
ตัวอย่าง USER.md:
# USER.md - ข้อมูลผู้ใช้
- ชื่อ: Yimmy
- วิธีเรียก: คุณ
- Timezone: Asia/Bangkok
- ความชอบ: โปรแกรมเมอร์ที่รักเทคโนโลยี
IDENTITY.md
ชื่อ, รูปแบบ, และอิโมจิของ agent
- สร้าง/อัปเดตในพิธี bootstrap
- กำหนดตัวตนของ agent
- ตัวอย่าง: ชื่อ Praewa_AI_Assistant, emoji 🤖
ตัวอย่าง IDENTITY.md:
# IDENTITY.md - ตัวตนของ Agent
## ข้อมูลพื้นฐาน:
- ชื่อ: Praewa_AI_Assistant (พร้ว AI Assistant)
- ลักษณะ: ผู้ช่วยระบบ AI
- อิโมจิ: 🤖
- โทน: อบอุ่น, ทำงานได้จริง
TOOLS.md
หมายเหตุเกี่ยวกับเครื่องมือและกิจวัตรที่ใช้ในเครื่อง
- ไม่ควบคุมความสามารถของ tools
- ใช้สำหรับกำกับตัวอย่าง SSH, เครื่องมือเฉพาะ
- ตัวอย่าง: SSH hosts, API keys, ชื่อ device
ตัวอย่าง TOOLS.md:
# TOOLS.md - Local Notes
### SSH Hosts:
- home-server: 192.168.1.100
### Cameras:
- living-room: Main area
### TTS Voice:
- ชอบ: "Nova" (warm, slightly British)
HEARTBEAT.md
รายการตรวจสอบขนาดเล็กสำหรับ heartbeat runs
- ทำโดยอัตโนมัติ ทุกๆ 30 นาที
- เก็บไว้สั้นเพื่อลด token burn
- ตัวอย่าง: ตรวจสอบ calendar, อีเมล, คำแนะนำ
ตัวอย่าง HEARTBEAT.md:
# HEARTBEAT.md - รายการตรวจสอบ
## งานที่ต้องทำตอนเช้า:
1. ตรวจสอบ calendar
2. อ่านอีเมลสำคัญ
3. ดูอากาศ
BOOTSTRAP.md
พิธีการครั้งเดียวเมื่อเริ่มงานใหม่
- สร้างเฉพาะสำหรับ workspace ใหม่
- ลบออกหลังจากพิธีเสร็จ
- คู่มือแนะนำการตั้งค่าตัวตน
ตัวอย่าง BOOTSTRAP.md:
# BOOTSTRAP.md - ยินดีต้อนรับ!
## เริ่มต้น:
1. สร้างตัวตน (IDENTITY.md)
2. เรียนรู้ผู้ใช้ (USER.md)
3. อ่านจิตวิญญาณ (SOUL.md)
➡️ เมื่อเสร็จแล้ว ลบไฟล์นี้ทิ้ง
MEMORY.md
ความทรงจำที่คัดกรองเรามาแล้ว (ยังไม่ใช่ในที่นี้)
- โหลดเฉพาะใน session หลัก (private)
- ความทรงจำระยะยาวที่คัดเลือกมาแล้ว
- ตัวอย่าง: ข้อมูลบุคคล, ความชอบ, ข้อมูลสำคัญ
ตัวอย่าง MEMORY.md:
# MEMORY.md - ความทรงจำระยะยาว
- ชอบเทคโนโลยีใหม่ๆ
- บุคคลที่เชื่อถือได้: คุณ Yimmy
- วันเกิด: 7 กุมภาพันธ์ 2026
- เวลาที่ใช้บ่อย: Thailand (UTC+7)
memory/YYYY-MM-DD.md
บันทึกความทรงจำรายวัน (หนึ่งไฟล์ต่อหนึ่งวัน)
- ไฟล์หนึ่งต่อวัน
- แนะนำให้อ่านวันนี้ + เมื่อวาน
- ตัวอย่าง: บันทึกการตั้งค่า, บทสนทนา
ตัวอย่าง memory/2026-02-07.md:
# บันทึกประจำวัน - 7 กุมภาพันธ์ 2026
## งานที่ทำ
- สร้างคู่มือ OpenClaw Workspace Files
- อัปเดต index.html พร้อม new card
## สถานะ
- เริ่มต้น nvm guide
- เสร็จแล้ว OpenClaw workspace files guide
Git Backup (แนะนำ)
Initialize git repo
รันคำสั่งในเครื่องที่ Gateway ทำงาน:
cd ~/.openclaw/workspace
git init
git add AGENTS.md SOUL.md TOOLS.md IDENTITY.md USER.md HEARTBEAT.md memory/
git commit -m "Add agent workspace"
Add private remote
สร้าง private repo บน GitHub, GitLab หรือใช้ Git CLI:
git branch -M main
git remote add origin <https-url>
git push -u origin main
หรือใช้ GitHub CLI: gh repo create openclaw-workspace --private --source . --remote origin --push
อัปเดตongoing
เมื่ออัปเดตไฟล์ใน workspace ให้รัน:
cd /path/to/workspace
git status
git add .
git commit -m "type: desc"
git push origin master
คำถามที่พบบ่อย (FAQ)
ไฟล์ไหนอยู่ใน workspace ไหนอยู่ใน ~/.openclaw/?
Workspace: AGENTS.md, SOUL.md, USER.md, IDENTITY.md, TOOLS.md, HEARTBEAT.md, BOOTSTRAP.md, MEMORY.md, memory/YYYY-MM-DD.md, skills/ (optional)
~/.openclaw/: openclaw.json, credentials/, agents///sessions/, skills/
แนะนำ Git Backup สำหรับ workspace?
ทุกครั้งที่อัปเดตไฟล์ใน workspace ให้รัน:
git status
git add .
git commit -m "type: desc"
git push origin master