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

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

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

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

• ค่าเริ่มต้น: ~/.openclaw/workspace
• หากตั้งค่า OPENCLAW_PROFILE และค่าไม่ใช่ "default" ค่าเริ่มต้นจะเปลี่ยนเป็น ~/.openclaw/workspace-<profile>
• เมื่อตั้งค่า OPENCLAW_WORKSPACE_DIR ค่านี้จะแทนที่ทั้งสองค่าข้างต้น
• เอเจนต์ที่ไม่ใช่ค่าเริ่มต้น (agents.list[]) ซึ่งไม่ได้ระบุพื้นที่ทำงานอย่างชัดเจน จะใช้ <state-dir>/workspace-<agentId> ไม่ใช่พื้นที่ทำงานเริ่มต้นที่ใช้ร่วมกัน

แทนที่ค่าใน ~/.openclaw/openclaw.json:

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

การแทนที่ค่ารายเอเจนต์: agents.list[].workspace

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

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

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

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

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

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

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

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

รายการต่อไปนี้อยู่ภายใต้ ~/.openclaw/ และไม่ควรคอมมิตไปยังรีโพซิทอรีพื้นที่ทำงาน:

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

หากต้องการย้ายเซสชันหรือการกำหนดค่า ให้คัดลอกแยกต่างหากและอย่านำเข้าไปอยู่ในการควบคุมเวอร์ชัน

OpenClaw รุ่นเก่าเขียนไฟล์ประกอบพื้นที่ทำงาน openclaw-workspace-state.json, .openclaw/workspace-state.json และ .attested รันไทม์ปัจจุบัน ใช้เฉพาะฐานข้อมูล SQLite ที่ใช้ร่วมกันสำหรับสถานะดังกล่าว หาก Doctor รายงาน ไฟล์ใดไฟล์หนึ่งเหล่านี้ ให้เรียกใช้ openclaw doctor --fix; Doctor จะนำเข้าสถานะ แบบเดิมที่ถูกต้องและลบต้นทางหลังจากตรวจสอบแถวในฐานข้อมูลแล้วเท่านั้น

การสำรองข้อมูลด้วย Git (แนะนำ ให้เป็นส่วนตัว)

ถือว่าพื้นที่ทำงานเป็นหน่วยความจำส่วนตัว ให้นำไปไว้ในรีโพซิทอรี 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

อย่าคอมมิตข้อมูลลับ

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

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

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

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

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

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

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