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

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

สิ่งนี้แยกจาก ~/.openclaw/ ซึ่งเก็บ config, credentials และ sessions

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

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

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

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

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

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

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

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

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

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

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

สิ่งเหล่านี้อยู่ใต้ ~/.openclaw/ และไม่ควร commit ไปยัง repo พื้นที่ทำงาน:

• ~/.openclaw/openclaw.json (config)
• ~/.openclaw/agents/<agentId>/agent/auth-profiles.json (โปรไฟล์ auth ของโมเดล: OAuth + API keys)
• ~/.openclaw/agents/<agentId>/agent/codex-home/ (บัญชี runtime, config, Skills, plugins และ native thread state ของ Codex รายเอเจนต์)
• ~/.openclaw/credentials/ (state ของช่องทาง/ผู้ให้บริการ รวมถึงข้อมูลนำเข้า OAuth แบบ legacy)
• ~/.openclaw/agents/<agentId>/sessions/ (transcripts ของ session + metadata)
• ~/.openclaw/skills/ (Skills ที่จัดการแล้ว)

หากคุณต้องย้าย sessions หรือ config ให้คัดลอกแยกต่างหากและเก็บไว้นอก version control

# สำรองด้วย Git (แนะนำ, ส่วนตัว)

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

รันขั้นตอนเหล่านี้บนเครื่องที่ 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"

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

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

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

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

# อย่า commit secrets

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

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

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

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

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

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

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