วิธีเชื่อมต่อ Google Workspace CLI กับ OpenClaw

สรุป (TL;DR)

Google Workspace CLI (gws) เป็นเครื่องมือบรรทัดคำสั่งที่ช่วยให้เอเจนต์ AI เข้าถึง Gmail, Drive, Calendar, Sheets, Docs และทุก API ของ Google Workspace ได้โดยตรงผ่านเอาต์พุต JSON ที่มีโครงสร้าง ด้วยการรองรับ OpenClaw แบบเนทีฟและทักษะเอเจนต์ที่สร้างไว้ล่วงหน้ากว่า 100 รายการ คุณสามารถทำให้ขั้นตอนการทำงานของ Workspace ทั้งหมดเป็นไปโดยอัตโนมัติผ่านแอปส่งข้อความเช่น WhatsApp หรือ Discord การตั้งค่าใช้เวลาเพียง 5 นาทีด้วย npm install -g @googleworkspace/cli ตามด้วย gws auth setup

บทนำ

จะเกิดอะไรขึ้นถ้าเอเจนต์ AI ของคุณสามารถอ่าน Gmail ของคุณ อัปเดตปฏิทินของคุณ และจัดระเบียบ Google Drive ของคุณได้โดยที่คุณไม่ต้องลงมือทำอะไรเลย?

เครื่องมืออัตโนมัติของ Google Workspace ส่วนใหญ่ต้องการการตั้งค่า API ที่ซับซ้อน โค้ดที่กำหนดเอง หรือบริการจากบุคคลที่สามที่มีราคาแพง นักพัฒนาใช้เวลาหลายชั่วโมงต่อสู้กับ OAuth flows, อัตราการใช้งานที่จำกัด และเอกสารเก่าๆ ในขณะเดียวกัน เอเจนต์ AI ก็ไม่มีประโยชน์เพราะขาดการเข้าถึงโดยตรงไปยังเครื่องมือที่เราใช้ในแต่ละวัน

วิศวกรของ Google เพิ่งเปิดตัวสิ่งที่เปลี่ยนแปลงทุกอย่าง Google Workspace CLI (gws) ได้รับดาวบน GitHub แล้วกว่า 12,400 ดวง และมาพร้อมกับทักษะเอเจนต์ที่สร้างไว้ล่วงหน้ากว่า 100 รายการ สร้างขึ้นด้วย Rust อ่าน Google's Discovery Service แบบเรียลไทม์ และส่งออก JSON ที่มีโครงสร้างที่เอเจนต์ AI ทุกตัวสามารถแยกวิเคราะห์ได้

Google Workspace CLI คืออะไร?

Google Workspace CLI (gws) เป็นเครื่องมือบรรทัดคำสั่งเดียวที่รวมทุก Google Workspace API เข้ากับคำสั่งที่สะอาดและประกอบได้ ครอบคลุม Gmail, Google Drive, Calendar, Sheets, Docs, Slides, Chat, Tasks, Meet, Forms, Keep, Classroom, Admin และโดยพื้นฐานแล้วทุก Google Workspace API ที่มีอยู่

นี่คือสิ่งที่ทำให้มันแตกต่างจากเครื่องมือ CLI อื่นๆ ที่คุณเคยใช้

เครื่องมือนักพัฒนาส่วนใหญ่มาพร้อมกับรายการคำสั่งที่ตายตัว เมื่อ Google เพิ่มปลายทาง API ใหม่ ใครบางคนจะต้องอัปเดตเครื่องมือด้วยตนเอง ออกเวอร์ชันใหม่ และหวังว่าทุกคนจะอัปเกรด มันเป็นงานซ้ำซากที่ไม่มีวันสิ้นสุด แร็ปเปอร์ Google Workspace ส่วนใหญ่ที่คุณเคยเห็นนั้นล้าสมัยแล้วตั้งแต่วินาทีที่คุณติดตั้ง

gws แก้ปัญหานี้ด้วยวิธีที่แตกต่างกันโดยสิ้นเชิง แทนที่จะฮาร์ดโค้ดคำสั่ง มันสื่อสารโดยตรงกับ Google's Discovery Service ลองนึกภาพว่านี่คือแค็ตตาล็อกสดของ Google เองเกี่ยวกับทุกการกระทำที่มีอยู่ในแอป Workspace ทั้งหมดของพวกเขา ทุก API, ทุกเมธอด, ทุกพารามิเตอร์ Google ดูแลแค็ตตาล็อกนี้ด้วยตนเอง และมันอัปเดตอยู่เสมอ

เมื่อคุณเรียกใช้ gws สิ่งแรกที่มันทำคือดึงแค็ตตาล็อกสดนี้และสร้างโครงสร้างคำสั่งทั้งหมดแบบเรียลไทม์จากสิ่งที่ Google บอกว่ามีอยู่ในขณะนั้น หาก Google เปิดตัวคุณสมบัติ Sheets ใหม่ในวันนี้เวลาบ่าย 2 โมง CLI ของคุณจะรองรับมันแล้วในเวลาบ่าย 2 โมง 1 นาที ไม่มีการอัปเดต ไม่มีการเปลี่ยนแปลงเวอร์ชันใหม่ ไม่ต้องรอผู้ดูแลมารอให้ทัน

เครื่องมือนี้ไม่สามารถล้าหลังได้เลยเพราะมันอ่านจากแหล่งข้อมูลที่ถูกต้องทุกครั้ง

ตัวอย่างรวดเร็ว

# แสดงรายการไฟล์ล่าสุด 10 ไฟล์
gws drive files list --params '{"pageSize": 10}'

# สร้างสเปรดชีต
gws sheets spreadsheets create --json '{"properties": {"title": "งบประมาณไตรมาส 1"}}'

# ส่งข้อความ Chat
gws chat spaces messages create \
  --params '{"parent": "spaces/xyz"}' \
  --json '{"text": "การปรับใช้เสร็จสมบูรณ์แล้ว"}'

ทุกการตอบสนองจะกลับมาเป็น JSON ที่มีโครงสร้าง ไม่ใช่ HTML ไม่ใช่ข้อความที่จัดรูปแบบ ข้อมูลที่สะอาด คาดเดาได้ และเครื่องสามารถอ่านได้ ซึ่งเอเจนต์ AI สามารถตีความและดำเนินการได้ทันที

ทำไม gws ถึงสำคัญสำหรับเอเจนต์ AI

ชุมชนเอเจนต์ AI รู้สึกตื่นเต้นกับ gws ด้วยเหตุผลทางเทคนิคที่เฉพาะเจาะจง

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

ไม่จำเป็นต้องใช้เครื่องมือแบบกำหนดเอง: การตั้งค่าเอเจนต์ AI ส่วนใหญ่ต้องการให้คุณสร้างเครื่องมือแบบกำหนดเองสำหรับแต่ละ API ที่คุณต้องการเข้าถึง ด้วย gws เครื่องมือได้ถูกสร้างขึ้นแล้ว เอเจนต์ของคุณเพียงแค่ต้องรู้วิธีการดำเนินการคำสั่งเชลล์

ทักษะเอเจนต์ที่สร้างไว้ล่วงหน้ากว่า 100 รายการ: Repo มาพร้อมกับไฟล์ SKILL.md กว่า 100 ไฟล์ - หนึ่งไฟล์สำหรับทุก API ที่รองรับ พร้อมตัวช่วยระดับสูงสำหรับเวิร์กโฟลว์ทั่วไป และสูตรอาหารที่คัดสรรมาแล้ว 50 รายการสำหรับ Gmail, Drive, Docs, Calendar และ Sheets

การรองรับ OpenClaw แบบเนทีฟ: Google ได้รวมคำแนะนำการตั้งค่า OpenClaw โดยตรงใน README นี่ไม่ใช่การแฮ็กชุมชนหรืองานแก้ปัญหา มันคือการรองรับที่สร้างขึ้นมาโดยตรงและเป็นลำดับแรก

เซิร์ฟเวอร์ MCP ในตัว: gws มีเซิร์ฟเวอร์ Model Context Protocol ที่เปิดเผย Google Workspace APIs เป็นเครื่องมือที่มีโครงสร้าง ไคลเอนต์ที่เข้ากันได้กับ MCP (Claude Desktop, Gemini CLI, VS Code) สามารถเรียกใช้เครื่องมือเหล่านี้ได้โดยตรง

โครงสร้างพื้นฐานของ Agent Economy

เรากำลังเห็นการเกิดขึ้นของโครงสร้างพื้นฐานของเอเจนต์เร็วกว่าที่คนส่วนใหญ่ตระหนัก เครื่องมือเช่น gws แสดงถึงระบบท่อที่จะขับเคลื่อนเวิร์กโฟลว์อัตโนมัติ แทนที่จะสร้างการผสานรวมแบบกำหนดเองสำหรับแพลตฟอร์ม SaaS ทุกแพลตฟอร์ม เอเจนต์สามารถพึ่งพา CLI มาตรฐานที่มีรูปแบบเอาต์พุตที่สอดคล้องกัน

สิ่งนี้สำคัญเพราะมันลดอุปสรรคในการเข้าสู่ตลาด คุณไม่จำเป็นต้องมีทีมวิศวกรเพื่อสร้างระบบอัตโนมัติ AI สำหรับ Workspace ของคุณ คุณเพียงแค่ต้องการ npm และเวลา 5 นาที

gws ทำงานอย่างไร: สถาปัตยกรรม

gws ใช้กลยุทธ์การแยกวิเคราะห์สองเฟสที่ควรทำความเข้าใจ

เฟส 1: การระบุบริการ

เมื่อคุณรัน gws drive files list, CLI จะอ่านอาร์กิวเมนต์แรก (drive) เพื่อระบุบริการ

เฟส 2: การสร้างคำสั่งแบบไดนามิก

CLI จะดึง Discovery Document ของบริการจาก Google (แคชไว้ 24 ชั่วโมง) มันจะสร้างโครงสร้างคำสั่ง `clap::Command` จากทรัพยากรและเมธอดของเอกสาร นี่คือจุดที่เวทมนตร์เกิดขึ้น - พื้นผิวคำสั่งทั้งหมดถูกสร้างขึ้นจากข้อกำหนด API ของ Google เอง

เฟส 3: การดำเนินการคำขอ

CLI จะแยกวิเคราะห์อาร์กิวเมนต์ที่เหลือใหม่ ตรวจสอบสิทธิ์โดยใช้ข้อมูลรับรองที่คุณกำหนดค่า สร้างคำขอ HTTP และดำเนินการ

ผลลัพธ์ทั้งหมด - การตอบสนองที่สำเร็จ, ข้อผิดพลาด, เมตาดาต้าการดาวน์โหลด - เป็น JSON ที่มีโครงสร้าง

┌─────────────────────────────────────────────────────────┐
│  argv[1] = "drive"                                      │
│       ↓                                                 │
│  ดึง Discovery Document (แคชไว้ 24 ชม.)               │
│       ↓                                                 │
│  สร้างโครงสร้างคำสั่ง clap::Command จากทรัพยากรและเมธอด│
│       ↓                                                 │
│  แยกวิเคราะห์อาร์กิวเมนต์ที่เหลือใหม่                  │
│       ↓                                                 │
│  ตรวจสอบสิทธิ์ → สร้างคำขอ HTTP → ดำเนินการ            │
│       ↓                                                 │
│  เอาต์พุต: JSON ที่มีโครงสร้าง                          │
└─────────────────────────────────────────────────────────┘

สถาปัตยกรรมนี้หมายความว่า gws สามารถรองรับทุก Google Workspace API โดยไม่ต้องฮาร์ดโค้ดคำสั่งเดียว Discovery Document เป็นแหล่งข้อมูลความจริง และ gws จะอ่านมันแบบสดทุกครั้ง

การผสานรวม OpenClaw: ทีละขั้นตอน

OpenClaw เป็นเฟรมเวิร์กเอเจนต์ AI แบบโฮสต์เองที่เชื่อมต่อกับแอปส่งข้อความเช่น WhatsApp, Telegram และ Discord เมื่อคุณรวม gws เข้ากับ OpenClaw คุณจะได้รับผู้ช่วย AI ที่สามารถจัดการ Google Workspace ทั้งหมดของคุณผ่านข้อความ

Google ได้รวมคำแนะนำการตั้งค่า OpenClaw โดยตรงใน README นี่คือวิธีเริ่มต้น

ตัวเลือกที่ 1: Symlink ทักษะทั้งหมด (แนะนำสำหรับการพัฒนา)

# โคลน repo
git clone https://github.com/googleworkspace/cli.git
cd cli

# สร้าง Symlink ทักษะทั้งหมดไปยังไดเรกทอรีทักษะ OpenClaw ของคุณ
ln -s $(pwd)/skills/gws-* ~/.openclaw/skills/

วิธีนี้จะช่วยให้ทุกอย่างซิงค์กับ repo เมื่อ Google อัปเดตทักษะ คุณจะได้รับการอัปเดตโดยอัตโนมัติ

ตัวเลือกที่ 2: คัดลอกทักษะที่เฉพาะเจาะจง

# เลือกเฉพาะสิ่งที่คุณต้องการ
cp -r skills/gws-drive skills/gws-gmail ~/.openclaw/skills/

ตัวเลือกที่ 3: ใช้ Skills CLI

# ติดตั้งทักษะทั้งหมดในครั้งเดียว
npx skills add https://github.com/googleworkspace/cli

# หรือเลือกทักษะแต่ละรายการ
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-drive
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail

ทักษะ gws-shared

ทักษะ gws-shared นั้นฉลาดเป็นพิเศษ มันมีบล็อกการติดตั้งที่ติดตั้ง CLI ผ่าน npm โดยอัตโนมัติหาก gws ยังไม่ได้อยู่ใน PATH ของคุณ เอเจนต์ OpenClaw ของคุณสามารถบูทสแตรปตัวเองได้ — มันจะตรวจสอบเครื่องมือ ติดตั้งหากจำเป็น และเริ่มทำงาน ไม่จำเป็นต้องตั้งค่าด้วยตนเอง

การใช้ gws ผ่าน WhatsApp

เมื่อผสานรวมแล้ว คุณสามารถส่งข้อความเช่น:

"ตรวจสอบปฏิทินของฉันสำหรับการประชุมวันนี้"
"ค้นหาอีเมลที่ยังไม่ได้อ่านจากเจ้านายของฉัน"
"สร้างสเปรดชีตใหม่ชื่อ งบประมาณไตรมาส 2"
"อัปโหลด PDF นี้ไปยังโฟลเดอร์โครงการ"

OpenClaw จะรับข้อความของคุณ กำหนดว่าคำสั่ง gws ใดที่จะรัน ดำเนินการ และส่งผลลัพธ์กลับมา — ทั้งหมดผ่าน WhatsApp

รายละเอียดทักษะเอเจนต์กว่า 100 รายการ

repo มาพร้อมกับไฟล์ SKILL.md กว่า 100 ไฟล์ จัดเป็นสี่หมวดหมู่ หากคุณไม่คุ้นเคยกับรูปแบบ SKILL.md มันเป็นมาตรฐานที่กำลังเกิดขึ้นสำหรับการให้ความสามารถที่มีโครงสร้างและประกอบได้แก่เอเจนต์ AI ลองนึกถึงทักษะเหมือนแอปแต่สำหรับความรู้ของเอเจนต์และการเข้าถึงเครื่องมือ

ทักษะบริการ (25+)

หนึ่งทักษะต่อ Google Workspace API เหล่านี้คือส่วนประกอบพื้นฐานของคุณ:

ทักษะเพิ่มเติมครอบคลุม Cloud Identity, Alert Center, Group Settings, Licensing, Reseller และ Model Armor สำหรับการกรองความปลอดภัย

ทักษะ Persona (บทบาทเอเจนต์ที่สร้างไว้ล่วงหน้า 10 บทบาท)

Google ได้สร้างชุด Persona ที่พร้อมใช้งาน 10 ชุด ซึ่งกำหนดบทบาทเอเจนต์ที่สมบูรณ์:

แต่ละบุคลิกจะรวมทักษะบริการที่เหมาะสม คำสั่งช่วย และรูปแบบเวิร์กโฟลว์สำหรับบทบาทเฉพาะนั้นๆ คุณไม่จำเป็นต้องคิดว่าเอเจนต์ของคุณต้องการทักษะ Gmail + Calendar + Drive + Sheets แบบใดบ้าง เพียงแค่ให้บุคลิกแก่เอเจนต์ และมันก็จะรู้ว่าต้องทำอะไร

ทักษะตัวช่วย

เหล่านี้เป็นคำสั่งทางลัดสำหรับการดำเนินการที่พบบ่อยที่สุด:

• gws-drive-upload สำหรับการอัปโหลดไฟล์อย่างรวดเร็ว
• gws-gmail-send สำหรับการส่งอีเมล
• gws-modelarmor-sanitize-prompt สำหรับการล้างพร้อมต์ก่อนที่จะส่งไปยังเอเจนต์ของคุณ

ทักษะ Recipe (50 เวิร์กโฟลว์ที่คัดสรรมาแล้ว)

ลำดับงานหลายขั้นตอนที่มีคำสั่งจริงฝังอยู่ ตัวอย่างเช่น:

• ตรวจสอบไฟล์ Drive ที่แชร์ภายนอก
• ส่งอีเมลส่วนบุคคลจากข้อมูล Sheets
• สร้างวาระการประชุมจากกิจกรรมในปฏิทิน
• สร้างรายงานสถานะประจำสัปดาห์จากหลายแหล่งที่มา

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

เวิร์กโฟลว์ระบบอัตโนมัติในโลกแห่งความเป็นจริง

นี่คือตัวอย่างที่เป็นรูปธรรมของสิ่งที่คุณสามารถทำให้เป็นอัตโนมัติด้วย gws และ OpenClaw

ระบบอัตโนมัติของ Gmail

# ค้นหาอีเมลที่ยังไม่ได้อ่านจากผู้ส่งเฉพาะในกล่องจดหมายของคุณ
gws gmail users.messages list \
  --params '{"userId": "me", "q": "from:boss@company.com is:unread"}'

# อ่านอีเมลที่เฉพาะเจาะจง
gws gmail users.messages get --params '{"userId": "me", "id": "MSG_ID"}'

# ส่งอีเมล (ตัวช่วยจะจัดการการเข้ารหัสทั้งหมด)
gws gmail +send --to alice@company.com --subject 'รายงานไตรมาส 2 พร้อมแล้ว' \
  --body 'สวัสดี Alice, รายงานไตรมาส 2 พร้อมให้ตรวจสอบแล้ว'

# จัดเรียงกล่องจดหมายที่ยังไม่ได้อ่านของคุณ (สรุปที่เป็นมิตรกับเอเจนต์)
gws gmail +triage --max 5 --query 'from:boss'

การจัดการปฏิทิน

# ดูว่ามีอะไรอยู่ในปฏิทินของคุณวันนี้
gws calendar +agenda

# สร้างการประชุมพร้อมผู้เข้าร่วม
gws calendar +insert --summary 'การประชุมประจำสัปดาห์' \
  --start '2026-03-10T09:00:00-07:00' \
  --end '2026-03-10T09:30:00-07:00'

# สร้างกิจกรรมที่เกิดซ้ำพร้อมรายละเอียดทั้งหมด
gws calendar events insert \
  --params '{"calendarId": "primary"}' \
  --json '{
    "summary": "การประชุมประจำสัปดาห์",
    "start": {"dateTime": "2026-03-10T09:00:00", "timeZone": "America/Vancouver"},
    "end": {"dateTime": "2026-03-10T09:30:00", "timeZone": "America/Vancouver"},
    "recurrence": ["RRULE:FREQ=WEEKLY;BYDAY=MO"],
    "attendees": [{"email": "team@company.com"}]
  }'

# เลื่อนกิจกรรมและแจ้งผู้เข้าร่วม
gws calendar events patch \
  --params '{"calendarId": "primary", "eventId": "EVENT_ID", "sendUpdates": "all"}' \
  --json '{
    "start": {"dateTime": "2026-03-10T14:00:00", "timeZone": "America/Vancouver"},
    "end": {"dateTime": "2026-03-10T15:00:00", "timeZone": "America/Vancouver"}
  }'

การจัดการไฟล์ Drive

# แสดงไฟล์ล่าสุด 10 ไฟล์ของคุณ
gws drive files list --params '{"pageSize": 10}'

# อัปโหลดไฟล์ไปยังโฟลเดอร์ที่เฉพาะเจาะจง
gws drive +upload --file ./report.pdf --parent FOLDER_ID

# สร้างโฟลเดอร์โปรเจกต์ใหม่
gws drive files create \
  --json '{"name": "โครงการ Q2", "mimeType": "application/vnd.google-apps.folder"}'

# ดาวน์โหลดไฟล์
gws drive files get \
  --params '{"fileId": "FILE_ID", "alt": "media"}' -o report.pdf

# ส่งออก Google Doc เป็น PDF
gws drive files export \
  --params '{"fileId": "FILE_ID", "mimeType": "application/pdf"}' -o document.pdf

# แชร์โฟลเดอร์กับเพื่อนร่วมงาน
gws drive permissions create \
  --params '{"fileId": "FOLDER_ID"}' \
  --json '{"role": "writer", "type": "user", "emailAddress": "colleague@company.com"}'

การดำเนินการกับ Sheets

# อ่านข้อมูลจากช่วงที่กำหนด
gws sheets +read --spreadsheet-id SHEET_ID --range 'Contacts!A2:C'

# เพิ่มแถวข้อมูลใหม่
gws sheets +append --spreadsheet-id SHEET_ID --range 'Sheet1' \
  --values '["2026-03-05", "Marketing", "ค่าใช้จ่ายโฆษณา", "1500"]'

# สร้างสเปรดชีตใหม่เอี่ยม
gws drive files create \
  --json '{"name": "ตัวติดตามค่าใช้จ่าย 2026", "mimeType": "application/vnd.google-apps.spreadsheet"}'

Docs และการสร้างเนื้อหา

# สร้างเอกสารใหม่
gws docs documents create --json '{"title": "บันทึกการประชุม - มีนาคม 2026"}'

# เขียนเนื้อหาลงในเอกสารที่มีอยู่
gws docs +write --document-id DOC_ID \
  --text '## โครงการ: Q2 Launch\n\n### วัตถุประสงค์\nเปิดตัวคุณสมบัติใหม่ภายในสิ้นไตรมาส 2'

Chat, Meet, Forms และอื่นๆ

# ส่งการแจ้งเตือนทีมใน Google Chat
gws chat +send --space spaces/TEAM_SPACE \
  --text 'สำคัญ: โปรดตรวจสอบอีเมลของคุณสำหรับนโยบายที่อัปเดตแล้ว'

# สร้างห้อง Google Meet
gws meet spaces create --json '{"config": {"accessType": "OPEN"}}'

# สร้างแบบฟอร์มข้อเสนอแนะ
gws forms forms create \
  --json '{"info": {"title": "ข้อเสนอแนะกิจกรรม", "documentTitle": "แบบฟอร์มข้อเสนอแนะกิจกรรม"}}'

# สร้างงานนำเสนอ
gws slides presentations create --json '{"title": "การทบทวนรายไตรมาส Q2"}'

สังเกตรูปแบบ การกระทำทุกอย่างใช้เพียงบรรทัดเดียว คำสั่งช่วยเหลือที่มีเครื่องหมาย + (เช่น +send, +upload, +agenda, +triage, +read, +append, +write) จะจัดการการเข้ารหัสและการจัดรูปแบบที่ยุ่งยากทั้งหมด ซึ่งโดยปกติจะต้องใช้โค้ดตัวอย่าง 10 บรรทัด เอเจนต์ของคุณไม่จำเป็นต้องรู้เกี่ยวกับการจัดรูปแบบอีเมล RFC 2822 หรือการเข้ารหัส base64 มันแค่บอกว่าต้องการทำอะไร และ gws ก็จะจัดการส่วนที่เหลือ

ความปลอดภัยและ Model Armor

นี่คือสิ่งที่มักไม่ได้รับความสนใจเพียงพอ repo มีการผสานรวมกับ Google Cloud Model Armor สำหรับการกรองการตอบกลับเพื่อความปลอดภัย

Model Armor คืออะไร?

เมื่อเอเจนต์ของคุณอ่านข้อมูลจาก Gmail หรือ Drive ข้อมูลนั้นอาจมีการโจมตีแบบ prompt injection ใครบางคนอาจสร้างอีเมลที่ออกแบบมาโดยเฉพาะเพื่อจัดการพฤติกรรมของเอเจนต์ของคุณ Model Armor จะสแกนการตอบกลับ API ก่อนที่จะถึงเอเจนต์ของคุณ และกรองเนื้อหาที่อาจเป็นอันตรายออกไป

gws gmail users messages get --params '...' \
  --sanitize "projects/P/locations/L/templates/T"

โหมดการกรองเพื่อความปลอดภัย

ทำไมเรื่องนี้ถึงสำคัญ

ทีมรักษาความปลอดภัย AI ของ Cisco พบว่า 26% ของทักษะกว่า 31,000 รายการบน ClawHub มีช่องโหว่ SecurityScorecard รายงานว่า 63% ของอินสแตนซ์ OpenClaw ที่เปิดเผยสู่สาธารณะมีการกำหนดค่าผิดพลาด ความปลอดภัยของเอเจนต์ไม่ใช่ปัญหาทางทฤษฎี มันกำลังเกิดขึ้นจริงในขณะนี้

การมีระบบกรองความปลอดภัยที่สร้างขึ้นในระบบท่อส่งข้อมูลเป็นการเคลื่อนไหวที่ชาญฉลาดจาก Google

ตัวแปรสภาพแวดล้อมเพื่อความปลอดภัย

# เทมเพลต Model Armor เริ่มต้น
export GOOGLE_WORKSPACE_CLI_SANITIZE_TEMPLATE="projects/P/locations/L/templates/T"

# โหมดการกรองเพื่อความปลอดภัย (warn หรือ block)
export GOOGLE_WORKSPACE_CLI_SANITIZE_MODE="block"

gws เทียบกับทางเลือกอื่น

มาเปรียบเทียบ gws กับแนวทางอื่นๆ ที่คุณอาจพิจารณา

gws เทียบกับ gcloud CLI

ใช้ gcloud สำหรับการจัดการโครงสร้างพื้นฐาน ใช้ gws สำหรับระบบอัตโนมัติของ Workspace

gws เทียบกับ Google Apps Script

Apps Script เก่งในการทำให้เวิร์กโฟลว์เป็นอัตโนมัติภายใน Google Workspace gws เก่งในการให้เครื่องมือภายนอกและเอเจนต์ AI เข้าถึง Workspace

gws เทียบกับเครื่องมือของบุคคลที่สาม (Zapier, Make)

เครื่องมือของบุคคลที่สามเหมาะสำหรับผู้ใช้ที่ไม่ใช่เชิงเทคนิค gws เหมาะสำหรับนักพัฒนาและผู้ที่ตั้งค่าเอเจนต์ AI

คู่มือการเริ่มต้นใช้งาน

พร้อมที่จะลองใช้สิ่งนี้หรือยัง? นี่คือเส้นทางที่เร็วที่สุดในการตั้งค่าที่ใช้งานได้

ข้อกำหนดเบื้องต้น

• Node.js 18+ (สำหรับ npm install)
• โปรเจกต์ Google Cloud (สำหรับข้อมูลประจำตัว OAuth)
• บัญชี Google ที่เข้าถึง Google Workspace ได้
• ติดตั้ง gcloud CLI แล้ว (เป็นทางเลือกแต่แนะนำเพื่อการตั้งค่าที่เร็วที่สุด)

ขั้นตอนที่ 1: ติดตั้ง gws

npm install -g @googleworkspace/cli

แพ็กเกจ npm จะรวมไบนารีเนทีฟที่สร้างไว้ล่วงหน้าสำหรับ OS และสถาปัตยกรรมของคุณ ไม่จำเป็นต้องใช้ Rust toolchain

ขั้นตอนที่ 2: ตั้งค่าการตรวจสอบสิทธิ์

gws auth setup

ขั้นตอนนี้จะแนะนำคุณตลอดการกำหนดค่าโปรเจกต์ Google Cloud มันจะสร้างโปรเจกต์ Cloud เปิดใช้งาน API และลงชื่อเข้าใช้ให้คุณ

หากคุณไม่ได้ติดตั้ง gcloud คุณสามารถตั้งค่า OAuth ด้วยตนเองผ่าน Google Cloud Console ได้

ขั้นตอนที่ 3: เข้าสู่ระบบ

gws auth login

ขั้นตอนนี้จะเปิดเบราว์เซอร์สำหรับการเลือกขอบเขต OAuth และการเข้าสู่ระบบ

ขั้นตอนที่ 4: ทดสอบการตั้งค่าของคุณ

gws drive files list --params '{"pageSize": 5}'

คุณควรเห็นการตอบกลับ JSON ที่มีไฟล์ล่าสุดของคุณ

ขั้นตอนที่ 5: ผสานรวมกับ OpenClaw

# โคลน repo
git clone https://github.com/googleworkspace/cli.git
cd cli

# สร้าง Symlink ทักษะทั้งหมด
ln -s $(pwd)/skills/gws-* ~/.openclaw/skills/

ขั้นตอนที่ 6: เริ่มใช้งานผ่านการส่งข้อความ

ส่งข้อความผ่านแพลตฟอร์มส่งข้อความ OpenClaw ที่คุณกำหนดค่าไว้:

"แสดงรายการไฟล์ Drive ล่าสุด 5 ไฟล์ของฉัน"

OpenClaw จะดำเนินการคำสั่ง gws ที่เหมาะสมและส่งผลลัพธ์กลับมา

การแก้ไขปัญหาทั่วไป

"การเข้าถึงถูกบล็อก" หรือ 403 ระหว่างการเข้าสู่ระบบ

แอป OAuth ของคุณอยู่ในโหมดทดสอบ และบัญชีของคุณไม่ได้ถูกระบุว่าเป็นผู้ใช้ทดสอบ

วิธีแก้ไข: เปิดหน้าจอความยินยอม OAuth ในโปรเจกต์ GCP ของคุณ ไปที่ผู้ใช้ทดสอบ เพิ่มอีเมลบัญชี Google ของคุณ จากนั้นลอง gws auth login อีกครั้ง

"Google ยังไม่ได้ยืนยันแอปนี้"

คาดว่าจะเกิดขึ้นเมื่อแอปของคุณอยู่ในโหมดทดสอบ คลิกขั้นสูง จากนั้น "ไปที่ (ไม่ปลอดภัย)" เพื่อดำเนินการต่อ ซึ่งปลอดภัยสำหรับการใช้งานส่วนตัว

ข้อผิดพลาดขอบเขตมากเกินไป

แอปที่ไม่ได้รับการยืนยัน (โหมดทดสอบ) ถูกจำกัดขอบเขต OAuth ไว้ที่ประมาณ 25 ขอบเขต การตั้งค่าขอบเขตที่แนะนำมีหลายขอบเขตและจะเกินขีดจำกัดนี้

วิธีแก้ไข: เลือกเฉพาะขอบเขตที่คุณต้องการ:

gws auth login --scopes drive,gmail,calendar

API ไม่ได้เปิดใช้งาน

หาก Google API ที่จำเป็นไม่ได้เปิดใช้งานสำหรับโปรเจกต์ GCP ของคุณ คุณจะเห็นข้อผิดพลาด 403 พร้อมเหตุผล accessNotConfigured

gws จะพิมพ์คำใบ้ที่นำไปสู่การปฏิบัติพร้อมลิงก์เพื่อเปิดใช้งาน API คลิกที่ลิงก์ เปิดใช้งาน รอประมาณ 10 วินาที จากนั้นลองใหม่

บทสรุป

Google Workspace CLI แสดงถึงสิ่งสำคัญสำหรับระบบนิเวศของเอเจนต์ AI มันไม่ใช่แค่แร็ปเปอร์ CLI อีกตัวหนึ่ง มันคือโครงสร้างพื้นฐานที่ทำให้ระบบอัตโนมัติ AI เข้าถึงได้สำหรับทุกคนที่มี npm ติดตั้งอยู่

สถาปัตยกรรมมีความแข็งแกร่ง การครอบคลุมทักษะน่าประทับใจ ความจริงที่ว่า Google สร้างความเข้ากันได้กับ OpenClaw ตั้งแต่วันแรกบอกคุณได้ว่าพวกเขากำลังคิดว่าระบบนิเวศของเอเจนต์จะไปในทิศทางใด

สำหรับนักพัฒนาที่สร้างบน OpenClaw, Claude Code หรือแพลตฟอร์มเอเจนต์ใดๆ gws เป็นหนึ่งในเครื่องมือที่คุณต้องการมีในชุดเครื่องมือของคุณ มันจัดการความซับซ้อนของ Google Workspace APIs เพื่อให้เอเจนต์ของคุณสามารถมุ่งเน้นไปที่สิ่งที่สำคัญ — การทำงานให้เสร็จสิ้น

เศรษฐกิจของเอเจนต์กำลังได้รับโครงสร้างพื้นฐาน และมันกำลังเกิดขึ้นเร็วกว่าที่คนส่วนใหญ่ตระหนัก

คำถามที่พบบ่อย (FAQ)

ถาม: gws ใช้งานได้ฟรีหรือไม่?

ตอบ: ใช่ gws เป็นโอเพนซอร์สภายใต้ใบอนุญาต Apache-2.0 คุณจะจ่ายเฉพาะค่าใช้จ่ายการใช้งาน Google API หากคุณใช้เกินโควตาฟรี

ถาม: ฉันจำเป็นต้องมีบัญชี Google Workspace หรือไม่?

ตอบ: บัญชี Google มาตรฐานใช้งานได้สำหรับคุณสมบัติส่วนใหญ่ API ผู้ดูแลระบบบางอย่างต้องมีการสมัครสมาชิก Workspace

ถาม: ฉันสามารถใช้ gws โดยไม่มี OpenClaw ได้หรือไม่?

ตอบ: ได้แน่นอน gws ทำงานเป็นเครื่องมือ CLI แบบสแตนด์อโลน การผสานรวม OpenClaw เป็นทางเลือกสำหรับการเข้าถึงผ่านข้อความ

ถาม: ฉันจะอัปเดต gws ได้อย่างไร?

ตอบ: รัน npm update -g @googleworkspace/cli เพื่อรับเวอร์ชันล่าสุด CLI จะอ่าน Google's Discovery Service แบบเรียลไทม์ ดังนั้นจึงสามารถเข้าถึง API ล่าสุดได้เสมอ

ถาม: ข้อมูลของฉันปลอดภัยหรือไม่เมื่อใช้ gws?

ตอบ: gws จัดเก็บข้อมูลรับรองที่เข้ารหัสไว้ในที่เก็บข้อมูลโดยใช้ AES-256-GCM ด้วยคีย์ในพวงกุญแจ OS ของคุณ การผสานรวม Model Armor ช่วยเพิ่มความปลอดภัยสำหรับเวิร์กโฟลว์ของเอเจนต์

ถาม: ฉันสามารถใช้ gws ใน CI/CD pipelines ได้หรือไม่?

ตอบ: ได้ คุณสามารถส่งออกข้อมูลรับรองของคุณด้วย gws auth export --unmasked > credentials.json และตั้งค่า GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE ในสภาพแวดล้อม CI ของคุณ

ถาม: gws และ Google APIs Explorer แตกต่างกันอย่างไร?

ตอบ: gws เป็นเครื่องมือ CLI ที่ออกแบบมาสำหรับระบบอัตโนมัติและการผสานรวมเอเจนต์ AI ส่วน APIs Explorer เป็นเครื่องมือทดสอบบนเว็บ gws จะส่งออก JSON ที่มีโครงสร้างและรองรับการเขียนสคริปต์

ถาม: gws ใช้งานได้กับบัญชีบริการหรือไม่?

ตอบ: ได้ ตั้งค่า GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE เป็นไฟล์คีย์ JSON ของบัญชีบริการของคุณ ไม่ต้องมีการเข้าสู่ระบบแบบโต้ตอบ

ถาม: ฉันสามารถมีส่วนร่วมกับ gws ได้หรือไม่?

ตอบ: ได้ โครงการนี้เป็นโอเพนซอร์สบน GitHub โปรดทราบว่าคำขอดึง (pull requests) จากผู้ที่ไม่ได้เป็นผู้ร่วมมือถูกปิดใช้งานชั่วคราวตามที่ผู้ดูแลพื้นที่เก็บข้อมูลระบุ

ถาม: gws รองรับแพลตฟอร์มใดบ้าง?

ตอบ: gws มาพร้อมไบนารีที่สร้างไว้ล่วงหน้าสำหรับ macOS, Linux และ Windows แพ็กเกจ npm จะจัดการการติดตั้งไบนารีเนทีฟโดยอัตโนมัติ