Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

พื้นที่ทำงานคือบ้านของเอเจนต์ เป็นไดเรกทอรีทำงานเดียวที่ใช้สำหรับเครื่องมือไฟล์และบริบทพื้นที่ทำงาน เก็บไว้เป็นส่วนตัวและปฏิบัติต่อมันเหมือนหน่วยความจำ สิ่งนี้แยกจาก ~/.openclaw/ ซึ่งใช้เก็บการกำหนดค่า ข้อมูลประจำตัว และเซสชัน
พื้นที่ทำงานคือ cwd เริ่มต้น ไม่ใช่แซนด์บ็อกซ์แบบบังคับ เครื่องมือจะแปลงพาธแบบสัมพัทธ์โดยอิงกับพื้นที่ทำงาน แต่พาธแบบสัมบูรณ์ยังสามารถเข้าถึงที่อื่นบนโฮสต์ได้ เว้นแต่จะเปิดใช้แซนด์บ็อกซ์ หากคุณต้องการการแยกสภาพแวดล้อม ให้ใช้ agents.defaults.sandbox (และ/หรือการกำหนดค่าแซนด์บ็อกซ์รายเอเจนต์)เมื่อเปิดใช้แซนด์บ็อกซ์และ workspaceAccess ไม่ใช่ "rw" เครื่องมือจะทำงานภายในพื้นที่ทำงานแซนด์บ็อกซ์ใต้ ~/.openclaw/sandboxes ไม่ใช่พื้นที่ทำงานบนโฮสต์ของคุณ

​
ตำแหน่งเริ่มต้น

  • ค่าเริ่มต้น: ~/.openclaw/workspace
  • หากตั้งค่า OPENCLAW_PROFILE และไม่ใช่ "default" ค่าเริ่มต้นจะกลายเป็น ~/.openclaw/workspace-<profile>
  • แทนที่ใน ~/.openclaw/openclaw.json:
{
  agents: {
    defaults: {
      workspace: "~/.openclaw/workspace",
    },
  },
}
openclaw onboard, openclaw configure หรือ openclaw setup จะสร้างพื้นที่ทำงานและใส่ไฟล์บูตสแตรปเริ่มต้นให้ หากไฟล์เหล่านั้นหายไป
การคัดลอก seed สำหรับแซนด์บ็อกซ์ยอมรับเฉพาะไฟล์ปกติที่อยู่ในพื้นที่ทำงานเท่านั้น นามแฝงแบบ symlink/hardlink ที่แปลงแล้วชี้ออกนอกพื้นที่ทำงานต้นทางจะถูกละเว้น
หากคุณจัดการไฟล์พื้นที่ทำงานด้วยตัวเองอยู่แล้ว คุณสามารถปิดการสร้างไฟล์บูตสแตรปได้: 
{ agents: { defaults: { skipBootstrap: true } } }

​
โฟลเดอร์พื้นที่ทำงานเพิ่มเติม

การติดตั้งเก่าอาจเคยสร้าง ~/openclaw ไว้ การเก็บไดเรกทอรีพื้นที่ทำงานหลายชุดไว้อาจทำให้ข้อมูลยืนยันตัวตนหรือสถานะคลาดเคลื่อนจนสับสนได้ เพราะมีพื้นที่ทำงานที่ใช้งานอยู่ได้เพียงชุดเดียวในแต่ละครั้ง
คำแนะนำ: เก็บพื้นที่ทำงานที่ใช้งานอยู่เพียงชุดเดียว หากคุณไม่ได้ใช้โฟลเดอร์เพิ่มเติมแล้ว ให้เก็บถาวรหรือย้ายไปถังขยะ (เช่น trash ~/openclaw) หากคุณตั้งใจเก็บพื้นที่ทำงานหลายชุด ตรวจสอบให้แน่ใจว่า agents.defaults.workspace ชี้ไปยังชุดที่ใช้งานอยู่openclaw doctor จะเตือนเมื่อตรวจพบไดเรกทอรีพื้นที่ทำงานเพิ่มเติม

​
แผนผังไฟล์พื้นที่ทำงาน

ต่อไปนี้คือไฟล์มาตรฐานที่ OpenClaw คาดว่าจะพบภายในพื้นที่ทำงาน:
คำสั่งการปฏิบัติงานสำหรับเอเจนต์และวิธีที่เอเจนต์ควรใช้หน่วยความจำ โหลดเมื่อเริ่มทุกเซสชัน เหมาะสำหรับกฎ ลำดับความสำคัญ และรายละเอียด “วิธีปฏิบัติตัว”
บุคลิก โทน และขอบเขต โหลดทุกเซสชัน คู่มือ: คู่มือบุคลิกภาพ SOUL.md
ผู้ใช้คือใครและควรเรียกพวกเขาอย่างไร โหลดทุกเซสชัน
ชื่อ บรรยากาศ และอีโมจิของเอเจนต์ สร้าง/อัปเดตระหว่างพิธีบูตสแตรป
หมายเหตุเกี่ยวกับเครื่องมือและข้อตกลงโลคัลของคุณ ไม่ได้ควบคุมความพร้อมใช้งานของเครื่องมือ เป็นเพียงคำแนะนำเท่านั้น
เช็กลิสต์ขนาดเล็กที่เป็นทางเลือกสำหรับการรัน Heartbeat ควรทำให้สั้นเพื่อหลีกเลี่ยงการใช้โทเค็นมากเกินไป
เช็กลิสต์เริ่มต้นที่เป็นทางเลือก ซึ่งรันอัตโนมัติเมื่อ Gateway รีสตาร์ต (เมื่อเปิดใช้ ฮุกภายใน) ควรทำให้สั้น ใช้เครื่องมือข้อความสำหรับการส่งออก
พิธีรันครั้งแรกแบบครั้งเดียว สร้างเฉพาะสำหรับพื้นที่ทำงานใหม่เอี่ยม ลบทิ้งหลังจากพิธีเสร็จสมบูรณ์
บันทึกหน่วยความจำรายวัน (หนึ่งไฟล์ต่อวัน) แนะนำให้อ่านของวันนี้ + เมื่อวานเมื่อเริ่มเซสชัน
หน่วยความจำระยะยาวที่คัดสรรแล้ว: ข้อเท็จจริงที่คงทน ความชอบ การตัดสินใจ และสรุปสั้น ๆ เก็บบันทึกรายละเอียดไว้ใน memory/YYYY-MM-DD.md เพื่อให้เครื่องมือหน่วยความจำดึงมาใช้เมื่อต้องการได้ โดยไม่ต้องแทรกเข้าไปในทุก prompt โหลด MEMORY.md เฉพาะในเซสชันหลักแบบส่วนตัวเท่านั้น (ไม่ใช่บริบทที่แชร์/กลุ่ม) ดู หน่วยความจำ สำหรับเวิร์กโฟลว์และการล้างหน่วยความจำอัตโนมัติ
Skills เฉพาะพื้นที่ทำงาน ตำแหน่ง Skill ที่มีลำดับความสำคัญสูงสุดสำหรับพื้นที่ทำงานนั้น แทนที่ Skills ของเอเจนต์โปรเจกต์, Skills ของเอเจนต์ส่วนตัว, Skills ที่จัดการ, Skills ที่บันเดิลมา และ skills.load.extraDirs เมื่อชื่อชนกัน
ไฟล์ Canvas UI สำหรับการแสดงผลโหนด (เช่น canvas/index.html)
หากไฟล์บูตสแตรปใดหายไป OpenClaw จะแทรกเครื่องหมาย “ไฟล์หายไป” เข้าไปในเซสชันและทำงานต่อ ไฟล์บูตสแตรปขนาดใหญ่จะถูกตัดทอนเมื่อแทรก ปรับขีดจำกัดได้ด้วย agents.defaults.bootstrapMaxChars (ค่าเริ่มต้น: 12000) และ agents.defaults.bootstrapTotalMaxChars (ค่าเริ่มต้น: 60000) openclaw setup สามารถสร้างค่าเริ่มต้นที่หายไปใหม่ได้โดยไม่เขียนทับไฟล์ที่มีอยู่

​
สิ่งที่ไม่ได้อยู่ในพื้นที่ทำงาน

สิ่งเหล่านี้อยู่ใต้ ~/.openclaw/ และไม่ควร commit ไปยัง repo ของพื้นที่ทำงาน:
  • ~/.openclaw/openclaw.json (การกำหนดค่า)
  • ~/.openclaw/agents/<agentId>/agent/auth-profiles.json (โปรไฟล์การยืนยันตัวตนของโมเดล: OAuth + API keys)
  • ~/.openclaw/agents/<agentId>/agent/codex-home/ (บัญชีรันไทม์ Codex รายเอเจนต์ การกำหนดค่า Skills, plugins และสถานะเธรด native)
  • ~/.openclaw/credentials/ (สถานะช่องทาง/ผู้ให้บริการ รวมถึงข้อมูลนำเข้า OAuth เดิม)
  • ~/.openclaw/agents/<agentId>/sessions/ (ทรานสคริปต์เซสชัน + เมทาดาตา)
  • ~/.openclaw/skills/ (Skills ที่จัดการ)
หากคุณต้องย้ายเซสชันหรือการกำหนดค่า ให้คัดลอกแยกต่างหากและเก็บไว้นอกการควบคุมเวอร์ชัน

​
การสำรองข้อมูลด้วย Git (แนะนำ, ส่วนตัว)

ปฏิบัติต่อพื้นที่ทำงานเหมือนหน่วยความจำส่วนตัว ใส่ไว้ใน repo git แบบ ส่วนตัว เพื่อให้มีข้อมูลสำรองและกู้คืนได้ รันขั้นตอนเหล่านี้บนเครื่องที่ Gateway รันอยู่ (ซึ่งเป็นที่ที่พื้นที่ทำงานอยู่)
1

เริ่มต้น repo

หากติดตั้ง git แล้ว พื้นที่ทำงานใหม่เอี่ยมจะถูกเริ่มต้นโดยอัตโนมัติ หากพื้นที่ทำงานนี้ยังไม่ใช่ repo ให้รัน:
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"
2

เพิ่ม remote ส่วนตัว

  1. สร้าง repository ส่วนตัว ใหม่บน GitHub
  2. อย่าเริ่มต้นด้วย README (เพื่อหลีกเลี่ยง merge conflicts)
  3. คัดลอก HTTPS remote URL
  4. เพิ่ม remote และ push:
git branch -M main
git remote add origin <https-url>
git push -u origin main
3

การอัปเดตต่อเนื่อง

git status
git add .
git commit -m "Update memory"
git push

​
อย่า commit ความลับ

แม้จะอยู่ใน repo ส่วนตัว ให้หลีกเลี่ยงการเก็บความลับไว้ในพื้นที่ทำงาน:
  • API keys, OAuth tokens, รหัสผ่าน หรือข้อมูลประจำตัวส่วนตัว
  • ทุกอย่างภายใต้ ~/.openclaw/
  • ดัมพ์ดิบของแชตหรือไฟล์แนบที่ละเอียดอ่อน
หากคุณต้องเก็บการอ้างอิงที่ละเอียดอ่อน ให้ใช้ placeholder และเก็บความลับจริงไว้ที่อื่น (ตัวจัดการรหัสผ่าน ตัวแปรสภาพแวดล้อม หรือ ~/.openclaw/)
ตัวอย่างเริ่มต้น .gitignore ที่แนะนำ: 
.DS_Store
.env
**/*.key
**/*.pem
**/secrets*

​
การย้ายพื้นที่ทำงานไปยังเครื่องใหม่

1

Clone repo

Clone repo ไปยังพาธที่ต้องการ (ค่าเริ่มต้น ~/.openclaw/workspace)
2

อัปเดตการกำหนดค่า

ตั้งค่า agents.defaults.workspace เป็นพาธนั้นใน ~/.openclaw/openclaw.json
3

Seed ไฟล์ที่หายไป

รัน openclaw setup --workspace <path> เพื่อ seed ไฟล์ที่หายไป
4

คัดลอกเซสชัน (ทางเลือก)

หากคุณต้องใช้เซสชัน ให้คัดลอก ~/.openclaw/agents/<agentId>/sessions/ จากเครื่องเก่าแยกต่างหาก

​
หมายเหตุขั้นสูง

  • การกำหนดเส้นทางแบบหลายเอเจนต์สามารถใช้พื้นที่ทำงานที่ต่างกันต่อเอเจนต์ได้ ดู การกำหนดเส้นทางช่องทาง สำหรับการกำหนดค่าการกำหนดเส้นทาง
  • หากเปิดใช้ agents.defaults.sandbox เซสชันที่ไม่ใช่ main สามารถใช้พื้นที่ทำงานแซนด์บ็อกซ์รายเซสชันใต้ agents.defaults.sandbox.workspaceRoot

​
ที่เกี่ยวข้อง