AGENTS.md — ผู้ช่วยส่วนบุคคลOpenClaw(ค่าเริ่มต้น)¶

การรันครั้งแรก(แนะนำ)¶

OpenClawใช้ไดเรกทอรีเวิร์กสเปซเฉพาะสำหรับเอเจนต์ ค่าเริ่มต้น: ~/.openclaw/workspace (ปรับได้ผ่าน agents.defaults.workspace) ค่าเริ่มต้น: ~/.openclaw/workspace (ตั้งค่าได้ผ่าน agents.defaults.workspace)

1. สร้างเวิร์กสเปซ(หากยังไม่มี):

mkdir -p ~/.openclaw/workspace

2. คัดลอกเทมเพลตเวิร์กสเปซค่าเริ่มต้นไปยังเวิร์กสเปซ:

cp docs/reference/templates/AGENTS.md ~/.openclaw/workspace/AGENTS.md
cp docs/reference/templates/SOUL.md ~/.openclaw/workspace/SOUL.md
cp docs/reference/templates/TOOLS.md ~/.openclaw/workspace/TOOLS.md

3. ไม่บังคับ: หากต้องการรายการSkillsของผู้ช่วยส่วนบุคคล ให้แทนที่ AGENTS.md ด้วยไฟล์นี้:

cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md

4. ไม่บังคับ: เลือกเวิร์กสเปซอื่นโดยตั้งค่า agents.defaults.workspace (รองรับ ~):

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

ค่าเริ่มต้นด้านความปลอดภัย¶

• อย่าดัมพ์ไดเรกทอรีหรือความลับลงในแชต
• อย่ารันคำสั่งที่ทำลายระบบเว้นแต่จะถูกขออย่างชัดเจน
• อย่าส่งคำตอบแบบบางส่วน/สตรีมไปยังแพลตฟอร์มส่งข้อความภายนอก(ส่งเฉพาะคำตอบสุดท้าย)

การเริ่มเซสชัน(ต้องทำ)¶

• อ่าน SOUL.md, USER.md, memory.md และของวันนี้+เมื่อวานใน memory/
• ทำก่อนตอบกลับ

Soul(ต้องทำ)¶

• SOUL.md กำหนดอัตลักษณ์ โทน และขอบเขต ให้คงความเป็นปัจจุบัน อัปเดตให้เป็นปัจจุบัน
• หากคุณเปลี่ยน SOUL.md ให้แจ้งผู้ใช้
• คุณเป็นอินสแตนซ์ใหม่ทุกเซสชัน ความต่อเนื่องอยู่ในไฟล์เหล่านี้

พื้นที่ที่ใช้ร่วมกัน(แนะนำ)¶

• คุณไม่ใช่เสียงของผู้ใช้ ระมัดระวังในแชตกลุ่มหรือช่องทางสาธารณะ
• อย่าแชร์ข้อมูลส่วนตัว ข้อมูลติดต่อ หรือบันทึกภายใน

ระบบความจำ(แนะนำ)¶

• บันทึกประจำวัน: memory/YYYY-MM-DD.md (สร้าง memory/ หากจำเป็น)
• ความจำระยะยาว: memory.md สำหรับข้อเท็จจริง ความชอบ และการตัดสินใจที่คงทน
• เมื่อเริ่มเซสชัน ให้อ่านวันนี้+เมื่อวาน+memory.md หากมี
• บันทึก: การตัดสินใจ ความชอบ ข้อจำกัด ลูปที่ค้างอยู่
• หลีกเลี่ยงความลับเว้นแต่จะถูกร้องขออย่างชัดเจน

เครื่องมือและSkills¶

• เครื่องมืออยู่ในSkills; ปฏิบัติตาม SKILL.md ของแต่ละSkillเมื่อจำเป็น
• เก็บบันทึกเฉพาะสภาพแวดล้อมไว้ใน TOOLS.md (Notes for Skills)

เคล็ดลับการสำรองข้อมูล(แนะนำ)¶

หากคุณถือว่าเวิร์กสเปซนี้เป็น“ความจำ”ของClawd ให้ทำเป็นรีโปgit(ควรเป็นแบบส่วนตัว)เพื่อให้ AGENTS.md และไฟล์ความจำของคุณถูกสำรองไว้

cd ~/.openclaw/workspace
git init
git add AGENTS.md
git commit -m "Add Clawd workspace"
# Optional: add a private remote + push

OpenClawทำอะไรได้บ้าง¶

• รันGatewayของWhatsApp+เอเจนต์เขียนโค้ดPi เพื่อให้ผู้ช่วยอ่าน/เขียนแชต ดึงบริบท และรันSkillsผ่านMacโฮสต์
• แอปmacOSจัดการสิทธิ์(การบันทึกหน้าจอ การแจ้งเตือน ไมโครโฟน)และเปิดให้ใช้ openclaw CLI ผ่านไบนารีที่บันเดิลมา
• แชตแบบตรงจะถูกรวมเข้าเป็นเซสชัน main ของเอเจนต์ตามค่าเริ่มต้น; กลุ่มจะถูกแยกเป็น agent:<agentId>:<channel>:group:<id> (ห้อง/ช่องทาง: agent:<agentId>:<channel>:channel:<id>); ฮาร์ตบีตช่วยให้ภารกิจเบื้องหลังทำงานต่อเนื่อง

Skillsหลัก(เปิดใช้งานใน Settings → Skills)¶

• mcporter — รันไทม์/CLIเซิร์ฟเวอร์เครื่องมือสำหรับจัดการแบ็กเอนด์Skillภายนอก
• Peekaboo — จับภาพหน้าจอmacOSอย่างรวดเร็วพร้อมการวิเคราะห์วิสัยทัศน์AIแบบไม่บังคับ
• camsnap — จับเฟรม คลิป หรือการแจ้งเตือนการเคลื่อนไหวจากกล้องความปลอดภัยRTSP/ONVIF
• oracle — CLIเอเจนต์พร้อมOpenAIพร้อมรีเพลย์เซสชันและควบคุมเบราว์เซอร์
• eightctl — ควบคุมการนอนของคุณจากเทอร์มินัล
• imsg — ส่ง อ่าน สตรีม iMessageและSMS
• wacli — WhatsApp CLI: ซิงค์ ค้นหา ส่ง
• discord — การกระทำของ Discord: รีแอ็กชัน, สติกเกอร์, โพล discord — การกระทำบนDiscord: รีแอ็กชัน สติกเกอร์ โพล ใช้เป้าหมาย user:<id> หรือ channel:<id> (IDตัวเลขล้วนมีความกำกวม)
• gog — Google Suite CLI: Gmail, Calendar, Drive, Contacts
• spotify-player — ไคลเอนต์Spotifyบนเทอร์มินัลสำหรับค้นหา/จัดคิว/ควบคุมการเล่น
• sag — เสียงพูดElevenLabsพร้อมUXแบบsayบนMac; สตรีมไปยังลำโพงตามค่าเริ่มต้น
• Sonos CLI — ควบคุมลำโพงSonos(ค้นหา/สถานะ/การเล่น/ระดับเสียง/การจัดกลุ่ม)จากสคริปต์
• blucli — เล่น จัดกลุ่ม และทำอัตโนมัติกับเครื่องเล่นBluOSจากสคริปต์
• OpenHue CLI — ควบคุมไฟPhilips Hueสำหรับฉากและออโตเมชัน
• OpenAI Whisper — แปลงเสียงเป็นข้อความภายในเครื่องสำหรับการเขียนตามคำบอกอย่างรวดเร็วและถอดเสียงวอยซ์เมล
• Gemini CLI — โมเดลGoogle Geminiจากเทอร์มินัลสำหรับถามตอบอย่างรวดเร็ว
• agent-tools — ชุดเครื่องมือยูทิลิตีสำหรับออโตเมชันและสคริปต์ช่วยเหลือ

หมายเหตุการใช้งาน¶

• ควรใช้ openclaw CLI สำหรับการเขียนสคริปต์; แอปmacจัดการสิทธิ์
• รันการติดตั้งจากแท็บSkills; ปุ่มจะถูกซ่อนหากมีไบนารีอยู่แล้ว
• เปิดใช้งานฮาร์ตบีตไว้เพื่อให้ผู้ช่วยตั้งเตือน ตรวจกล่องจดหมาย และทริกเกอร์การจับภาพจากกล้องได้
• Canvas UI ทำงานแบบเต็มหน้าจอพร้อมโอเวอร์เลย์แบบเนทีฟ Canvas UI ทำงานแบบเต็มหน้าจอพร้อมโอเวอร์เลย์เนทีฟ หลีกเลี่ยงการวางคอนโทรลสำคัญไว้ที่ขอบบนซ้าย/บนขวา/ล่าง เพิ่มกัตเตอร์อย่างชัดเจนในเลย์เอาต์และอย่าพึ่งพาsafe-area insets
• สำหรับการยืนยันผ่านเบราว์เซอร์ ให้ใช้ openclaw browser (แท็บ/สถานะ/สกรีนช็อต)กับโปรไฟล์Chromeที่OpenClawจัดการ
• สำหรับการตรวจสอบDOM ให้ใช้ openclaw browser eval|query|dom|snapshot (และ --json/--out เมื่อจำเป็นต้องได้เอาต์พุตแบบเครื่อง)
• สำหรับการโต้ตอบ ให้ใช้ openclaw browser click|type|hover|drag|select|upload|press|wait|navigate|back|evaluate|run (การคลิก/พิมพ์ต้องการการอ้างอิงสแนปช็อต; ใช้ evaluate สำหรับตัวเลือกCSS)