OpenClaw: วิธีการเชื่อมต่อ OpenClaw และ Google Workspace

gog.md

เอกสารนี้เป็นคำแปลจากต้นฉบับภาษาอังกฤษที่ผู้ใช้ให้มา

รายการตรวจสอบทางเทคนิคสำหรับเดโม: การเชื่อมต่อ OpenClaw และ Google Workspace

คู่มือนี้สรุปขั้นตอนภาพรวมในการให้สิทธิ์และเชื่อมต่อ OpenClaw Gateway เข้ากับเครื่องมือของ Google Workspace โดยใช้สภาพแวดล้อมการทำงานที่ปลอดภัยบนเครื่อง local

1. Google Cloud และการยืนยันตัวตน

• การเตรียมโปรเจกต์: สร้างโปรเจกต์เฉพาะใน Google Cloud Console และเปิดใช้งาน Gmail API และ Google Calendar API
• ข้อมูลรับรองความปลอดภัย: ตั้งค่าหน้าจอขอความยินยอม OAuth (OAuth consent screen) และดาวน์โหลดไฟล์ credentials.json สำหรับแอปพลิเคชันบนเดสก์ท็อป
• การเชื่อมโยงข้อมูลรับรอง: เริ่มต้นยูทิลิตี้ gog โดยเชื่อมโยงกับไฟล์ความปลอดภัยที่ดาวน์โหลดมาด้วยคำสั่ง: gog auth credentials ~/Downloads/credentials.json
• การให้สิทธิ์บัญชี: ยืนยันตัวตนบัญชี Workspace ที่ต้องการเพื่อเข้าถึงข้อมูลด้วยคำสั่ง: gog auth add your.email@example.com

2. การกำหนดค่าความปลอดภัยและสภาพแวดล้อม

• การตั้งค่า Keyring: กำหนดค่า environment variable แบบถาวรสำหรับ keyring ที่เข้ารหัสบนเครื่อง local ซึ่งทำหน้าที่เหมือน "กุญแจหลัก" (master key) ทำให้ background service ของ gateway สามารถปลดล็อก access token ได้โดยไม่ต้องให้ผู้ใช้ยืนยันด้วยตนเองทุกครั้ง: export GOG_KEYRING_PASSWORD='YOUR_CHOSEN_PASSWORD'
• การใส่ค่า Config: อัปเดตไฟล์ ~/.openclaw/openclaw.json ในระดับบนสุด (root level) เพื่อรวมข้อมูลระบุตัวตนของบัญชี (account identity) และรหัสผ่านของ keyring

3. สิทธิ์ของ Agent และ Skills

• การกำหนดค่า Sandbox: ตั้งค่า sandbox.mode เป็น "off" ภายในไฟล์ config เพื่อให้ AI agent สามารถโต้ตอบกับเครื่องมือ (binary tools) บนเครื่อง Mac ที่เป็นโฮสต์ได้
• การให้สิทธิ์ในการรันคำสั่ง: กำหนดค่า exec tool เพื่อให้สิทธิ์ AI ในการรันคำสั่ง shell บนเครื่องโฮสต์:

  "exec": { "host": "gateway", "security": "allowlist" }

• การเปิดใช้งาน Skill: เปิดใช้งาน google-workspace skill อย่างชัดเจน เพื่อให้ AI มีตรรกะที่จำเป็นในการแยกวิเคราะห์และสรุปข้อมูลจาก Workspace

4. การจัดการบริการและการตรวจสอบ

• การซิงค์ Gateway: รีสตาร์ท background service เพื่อใช้ค่า config ใหม่ในไฟล์ JSON และ environment variables ที่ตั้งค่าไว้: openclaw gateway restart
• การทดสอบ End-to-End: ตรวจสอบการเชื่อมต่อผ่านการส่งคำสั่งใน terminal โดยตรง เพื่อให้แน่ใจว่า AI สามารถดึงข้อมูลได้สำเร็จ: gog gmail search "is:unread"

---

ฉันต้องการตรวจสอบการสื่อสารล่าสุดของฉัน ใช้คำสั่ง gog gmail search 'is:unread' เพื่อแสดงรายการอีเมลที่ยังไม่ได้อ่าน 5 ฉบับล่าสุด กรุณาแสดงแค่ชื่อผู้ส่งและหัวเรื่อง เพื่อที่ฉันจะได้ดูว่ามีอะไรเร่งด่วนหรือไม่