พื้นที่ทำงานของเอเจนต์

พื้นที่ทำงานคือบ้านของเอเจนต์ เป็นไดเรกทอรีทำงานเดียวที่ใช้สำหรับเครื่องมือไฟล์และบริบทพื้นที่ทำงาน เก็บไว้เป็นส่วนตัวและปฏิบัติต่อมันเหมือนหน่วยความจำ

สิ่งนี้แยกจาก ~/.openclaw/ ซึ่งใช้เก็บการกำหนดค่า ข้อมูลประจำตัว และเซสชัน

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

• ค่าเริ่มต้น: ~/.openclaw/workspace
• หากตั้งค่า OPENCLAW_PROFILE และไม่ใช่ "default" ค่าเริ่มต้นจะกลายเป็น ~/.openclaw/workspace-<profile>
• แทนที่ใน ~/.openclaw/openclaw.json:

{  agents: {    defaults: {      workspace: "~/.openclaw/workspace",    },  },}

openclaw onboard, openclaw configure หรือ openclaw setup จะสร้างพื้นที่ทำงานและใส่ไฟล์บูตสแตรปเริ่มต้นให้ หากไฟล์เหล่านั้นหายไป

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

{ agents: { defaults: { skipBootstrap: true } } }

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

การติดตั้งเก่าอาจเคยสร้าง ~/openclaw ไว้ การเก็บไดเรกทอรีพื้นที่ทำงานหลายชุดไว้อาจทำให้ข้อมูลยืนยันตัวตนหรือสถานะคลาดเคลื่อนจนสับสนได้ เพราะมีพื้นที่ทำงานที่ใช้งานอยู่ได้เพียงชุดเดียวในแต่ละครั้ง

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

ต่อไปนี้คือไฟล์มาตรฐานที่ OpenClaw คาดว่าจะพบภายในพื้นที่ทำงาน:

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

สิ่งเหล่านี้อยู่ใต้ ~/.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 รันอยู่ (ซึ่งเป็นที่ที่พื้นที่ทำงานอยู่)

cd ~/.openclaw/workspacegit initgit add AGENTS.md SOUL.md TOOLS.md IDENTITY.md USER.md HEARTBEAT.md memory/git commit -m "Add agent workspace"

git branch -M maingit remote add origin <https-url>git push -u origin main

gh auth logingh repo create openclaw-workspace --private --source . --remote origin --push

git branch -M maingit remote add origin <https-url>git push -u origin main

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

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

ตัวอย่างเริ่มต้น .gitignore ที่แนะนำ:

.DS_Store.env**/*.key**/*.pem**/secrets*

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

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

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

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

• Heartbeat - ไฟล์พื้นที่ทำงาน HEARTBEAT.md
• แซนด์บ็อกซ์ - การเข้าถึงพื้นที่ทำงานในสภาพแวดล้อมที่เป็นแซนด์บ็อกซ์
• เซสชัน - พาธที่เก็บเซสชัน
• คำสั่งประจำ - คำสั่งถาวรในไฟล์พื้นที่ทำงาน