ربط واجهة سطر الأوامر Google Workspace بـ OpenClaw

ملخص

Google Workspace CLI (gws) هي أداة سطر أوامر تمنح وكلاء الذكاء الاصطناعي وصولاً مباشرًا إلى Gmail و Drive والتقويم و Sheets و Docs وكل واجهة برمجة تطبيقات لـ Google Workspace من خلال مخرجات JSON منظمة. مع دعم OpenClaw الأصلي وأكثر من 100 مهارة وكيل مسبقة البناء، يمكنك أتمتة سير عمل Google Workspace بالكامل من خلال تطبيقات المراسلة مثل WhatsApp أو Discord. يستغرق الإعداد 5 دقائق باستخدام npm install -g @googleworkspace/cli متبوعًا بـ gws auth setup.

مقدمة

ماذا لو تمكن وكيل الذكاء الاصطناعي الخاص بك من قراءة بريدك الإلكتروني في Gmail، وتحديث التقويم الخاص بك، وتنظيم Google Drive الخاص بك دون أن تحرك ساكناً؟

تتطلب معظم أدوات أتمتة Google Workspace إعدادات API معقدة، أو رمزًا مخصصًا، أو خدمات باهظة الثمن من جهات خارجية. يقضي المطورون ساعات في التعامل مع تدفقات OAuth، وحدود المعدل، والوثائق القديمة. في غضون ذلك، تظل وكلاء الذكاء الاصطناعي خاملين لأنهم يفتقرون إلى الوصول المباشر إلى الأدوات التي نستخدمها يوميًا.

أطلق مهندسو Google للتو شيئًا يغير كل شيء. لقد جمع Google Workspace CLI (gws) بالفعل أكثر من 12,400 نجمة على GitHub ويأتي مع أكثر من 100 مهارة وكيل مسبقة البناء. تم بناؤه بلغة Rust، ويقرأ خدمة اكتشاف Google (Discovery Service) في وقت التشغيل، ويخرج JSON منظمًا يمكن لأي وكيل ذكاء اصطناعي تحليله.

ما هو Google Workspace CLI؟

Google Workspace CLI (gws) هي أداة سطر أوامر واحدة تقوم بتغليف كل واجهة برمجة تطبيقات لـ Google Workspace في أوامر نظيفة وقابلة للتركيب. تغطي Gmail و Google Drive و Calendar و Sheets و Docs و Slides و Chat و Tasks و Meet و Forms و Keep و Classroom و Admin، وبشكل أساسي كل واجهة برمجة تطبيقات لـ Google Workspace موجودة.

إليك ما يميزها عن أدوات سطر الأوامر الأخرى التي استخدمتها.

تأتي معظم أدوات المطورين بقائمة ثابتة من الأوامر. عندما تضيف Google نقطة نهاية جديدة لواجهة برمجة التطبيقات، يتعين على شخص ما تحديث الأداة يدويًا، وإصدار نسخة جديدة، ويأمل أن يقوم الجميع بالترقية. إنه جهد صيانة مستمر لا ينتهي أبدًا. معظم أغلفة Google Workspace التي رأيتها تكون قديمة بالفعل بحلول الوقت الذي تقوم بتثبيتها.

يحل gws هذه المشكلة بطريقة مختلفة جوهريًا. بدلاً من ترميز الأوامر بشكل ثابت، يتحدث مباشرة إلى خدمة اكتشاف Google (Discovery Service). فكر في هذا على أنه كتالوج Google المباشر الخاص بها لكل إجراء متاح عبر جميع تطبيقات Workspace الخاصة بها. كل واجهة برمجة تطبيقات، كل طريقة، كل معلمة. تحافظ Google على هذا الكتالوج بنفسها، وهو محدث دائمًا.

عند تشغيل gws، أول ما يفعله هو سحب هذا الكتالوج المباشر وبناء هيكل الأوامر بأكمله على الفور مما تقوله Google متاحًا حاليًا. إذا شحنت Google ميزة Sheets جديدة في الساعة 2 ظهرًا اليوم، فإن واجهة سطر الأوامر الخاصة بك تدعمها بالفعل في الساعة 2:01 ظهرًا. لا يوجد تحديث. لا يوجد إصدار جديد. لا انتظار للمحافظة على التزامن.

لا يمكن للأداة أن تتخلف حرفيًا لأنها تقرأ من مصدر الحقيقة في كل مرة.

مثال سريع

# List the 10 most recent files
gws drive files list --params '{"pageSize": 10}'

# Create a spreadsheet
gws sheets spreadsheets create --json '{"properties": {"title": "Q1 Budget"}}'

# Send a Chat message
gws chat spaces messages create \
  --params '{"parent": "spaces/xyz"}' \
  --json '{"text": "Deploy complete."}'

يعود كل رد على شكل JSON منظم. ليس HTML. وليس نصًا منسقًا. بيانات نظيفة، ومتوقعة، قابلة للقراءة آليًا يمكن لوكيل الذكاء الاصطناعي أن يستدل عليها ويتصرف بناءً عليها فورًا.

لماذا يعتبر gws مهمًا لوكلاء الذكاء الاصطناعي

مجتمع وكلاء الذكاء الاصطناعي متحمس لـ gws لأسباب تقنية محددة.

إخراج JSON منظم:

يعود كل رد على شكل JSON منظم. لا يحتاج وكيلك إلى تحليل HTML أو التخمين في التنسيق. يحصل على بيانات نظيفة يمكنه العمل بها على الفور.

لا يلزم وجود أدوات مخصصة:

تتطلب معظم إعدادات وكلاء الذكاء الاصطناعي بناء أدوات مخصصة لكل واجهة برمجة تطبيقات ترغب في الوصول إليها. مع gws، تم بناء الأدوات بالفعل. يحتاج وكيلك فقط إلى معرفة كيفية تنفيذ أوامر shell.

أكثر من 100 مهارة وكيل مسبقة البناء:

يأتي المستودع مع أكثر من 100 ملف SKILL.md - واحد لكل واجهة برمجة تطبيقات مدعومة، بالإضافة إلى مساعدين على مستوى أعلى لمهام سير العمل الشائعة و 50 وصفة منسقة لـ Gmail و Drive و Docs و Calendar و Sheets.

دعم OpenClaw الأصلي:

تضمنت Google تعليمات إعداد OpenClaw مباشرة في ملف README. هذا ليس اختراقًا مجتمعيًا أو حلًا بديلاً. إنه دعم مدمج من الدرجة الأولى.

خادم MCP مدمج:

يتضمن gws خادم بروتوكول سياق النموذج (Model Context Protocol) الذي يكشف واجهات برمجة تطبيقات Google Workspace كأدوات منظمة. يمكن لأي عميل متوافق مع MCP (مثل Claude Desktop، Gemini CLI، VS Code) استدعاء هذه الأدوات مباشرة.

بنية اقتصاد الوكلاء التحتية

نحن نشهد ظهور البنية التحتية للوكلاء بشكل أسرع مما يدركه معظم الناس. تمثل أدوات مثل gws الأساس الذي سيشغل مهام سير العمل المستقلة. بدلاً من بناء تكاملات مخصصة لكل منصة SaaS، يمكن للوكلاء الاعتماد على واجهات سطر أوامر موحدة بتنسيقات إخراج متسقة.

هذا مهم لأنه يقلل من حاجز الدخول. لا تحتاج إلى فريق من المهندسين لبناء أتمتة الذكاء الاصطناعي لـ Workspace الخاص بك. كل ما تحتاجه هو npm و 5 دقائق.

كيف يعمل gws: البنية

يستخدم gws استراتيجية تحليل على مرحلتين تستحق الفهم.

المرحلة الأولى: تحديد الخدمة

عند تشغيل gws drive files list، يقرأ CLI الوسيطة الأولى (drive) لتحديد الخدمة.

المرحلة الثانية: بناء الأوامر ديناميكيًا

يقوم CLI بجلب مستند اكتشاف الخدمة (Discovery Document) من Google (مخبأ لمدة 24 ساعة). يقوم ببناء شجرة clap::Command من موارد وطرائق المستند. هذا هو المكان الذي يحدث فيه السحر - يتم إنشاء سطح الأوامر بالكامل من مواصفات API الخاصة بـ Google.

المرحلة الثالثة: تنفيذ الطلب

يقوم CLI بإعادة تحليل الوسيطات المتبقية، والمصادقة باستخدام بيانات الاعتماد التي قمت بتكوينها، وبناء طلب HTTP، وتنفيذه.

جميع المخرجات - استجابات النجاح، الأخطاء، بيانات تعريف التنزيل - تكون على شكل JSON منظم.

┌─────────────────────────────────────────────────────────┐
│  argv[1] = "drive"                                      │
│       ↓                                                 │
│  Fetch Discovery Document (cached 24h)                 │
│       ↓                                                 │
│  Build clap::Command tree from resources & methods     │
│       ↓                                                 │
│  Re-parse remaining arguments                          │
│       ↓                                                 │
│  Authenticate → Build HTTP Request → Execute           │
│       ↓                                                 │
│  Output: Structured JSON                               │
└─────────────────────────────────────────────────────────┘

تعني هذه البنية أن gws يمكنه دعم كل واجهة برمجة تطبيقات لـ Google Workspace دون ترميز أمر واحد بشكل ثابت. مستند الاكتشاف (Discovery Document) هو مصدر الحقيقة، ويقرأه gws مباشرة في كل مرة.

تكامل OpenClaw: خطوة بخطوة

OpenClaw هو إطار عمل وكيل ذكاء اصطناعي مستضاف ذاتيًا يتصل بتطبيقات المراسلة مثل WhatsApp و Telegram و Discord. عند دمج gws مع OpenClaw، تحصل على مساعد ذكاء اصطناعي يمكنه إدارة Google Workspace بالكامل من خلال الرسائل النصية.

تضمنت Google حرفياً تعليمات إعداد OpenClaw في ملف README. إليك كيفية البدء.

الخيار 1: ربط جميع المهارات (موصى به للتطوير)

# Clone the repo
git clone https://github.com/googleworkspace/cli.git
cd cli

# Symlink all skills into your OpenClaw skills directory
ln -s $(pwd)/skills/gws-* ~/.openclaw/skills/

هذا يحافظ على مزامنة كل شيء مع المستودع. عندما تقوم Google بتحديث المهارات، تحصل على التحديثات تلقائيًا.

الخيار 2: نسخ مهارات محددة

# Only grab what you need
cp -r skills/gws-drive skills/gws-gmail ~/.openclaw/skills/

الخيار 3: استخدام Skills CLI

# Install all skills at once
npx skills add https://github.com/googleworkspace/cli

# Or pick individual skills
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

بمجرد الدمج، يمكنك إرسال رسائل مثل:

"Check my calendar for today's meetings"
"Find unread emails from my boss"
"Create a new spreadsheet called Q2 Budget"
"Upload this PDF to the Projects folder"

يتلقى OpenClaw رسالتك، ويحدد أمر gws الذي يجب تشغيله، وينفذه، ويعيد النتائج - كل ذلك عبر WhatsApp.

تحليل أكثر من 100 مهارة وكيل

يأتي المستودع مع أكثر من 100 ملف SKILL.md منظمة في أربع فئات. إذا لم تكن على دراية بتنسيق SKILL.md، فهو المعيار الناشئ لمنح وكلاء الذكاء الاصطناعي قدرات منظمة وقابلة للتركيب. فكر في المهارات كالتطبيقات ولكن للمعرفة والوصول إلى الأدوات للوكيل.

مهارات الخدمة (أكثر من 25)

مهارة واحدة لكل واجهة برمجة تطبيقات لـ Google Workspace. هذه هي كتل البناء الخاصة بك:

تغطي المهارات الإضافية Cloud Identity، و Alert Center، و Group Settings، و Licensing، و Reseller، و Model Armor لتصفية الأمان.

مهارات الشخصية (10 أدوار وكيل مسبقة البناء)

أنشأت Google 10 حزم شخصيات جاهزة للاستخدام تحدد أدوار وكيل كاملة:

تجمع كل شخصية المهارات الخدمية المناسبة، وأوامر المساعدة، وأنماط سير العمل لهذا الدور المحدد. لا داعي لأن تحدد أي مجموعة من مهارات Gmail + Calendar + Drive + Sheets يحتاجها وكيلك. ما عليك سوى منحه الشخصية وسيعرف ما يجب فعله.

مهارات المساعدة

هذه هي أوامر الاختصار للعمليات الأكثر شيوعًا:

• gws-drive-upload لرفع الملفات بسرعة
• gws-gmail-send لإرسال رسائل البريد الإلكتروني
• gws-modelarmor-sanitize-prompt لتنظيف المطالبات قبل أن تصل إلى وكيلك

مهارات الوصفات (50 سير عمل منسق)

تسلسلات مهام متعددة الخطوات مع أوامر حقيقية مدمجة. تتضمن الأمثلة:

• تدقيق ملفات Drive المشتركة خارجيًا
• إرسال رسائل بريد إلكتروني مخصصة من بيانات Sheets
• إنشاء جداول أعمال الاجتماعات من أحداث التقويم
• إنشاء تقارير حالة أسبوعية من مصادر متعددة

هذه هي مهام سير العمل التي تعمل بـ "النسخ واللصق والتشغيل" والتي توفر ساعات من هندسة المطالبات.

مهام سير عمل الأتمتة الواقعية

فيما يلي أمثلة ملموسة لما يمكنك أتمتته باستخدام gws و OpenClaw.

أتمتة Gmail

# Search your inbox for unread emails from a specific sender
gws gmail users.messages list \
  --params '{"userId": "me", "q": "from:boss@company.com is:unread"}'

# Read a specific email
gws gmail users.messages get --params '{"userId": "me", "id": "MSG_ID"}'

# Send an email (the helper handles all the encoding)
gws gmail +send --to alice@company.com --subject 'Q2 Report Ready' \
  --body 'Hey Alice, the Q2 report is ready for review.'

# Triage your unread inbox (agent-friendly summary)
gws gmail +triage --max 5 --query 'from:boss'

إدارة التقويم

# See what's on your calendar today
gws calendar +agenda

# Create a meeting with attendees
gws calendar +insert --summary 'Weekly Standup' \
  --start '2026-03-10T09:00:00-07:00' \
  --end '2026-03-10T09:30:00-07:00'

# Create a recurring event with all the details
gws calendar events insert \
  --params '{"calendarId": "primary"}' \
  --json '{
    "summary": "Weekly Standup",
    "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"}]
  }'

# Reschedule an event and notify attendees
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

# List your 10 most recent files
gws drive files list --params '{"pageSize": 10}'

# Upload a file to a specific folder
gws drive +upload --file ./report.pdf --parent FOLDER_ID

# Create a new project folder
gws drive files create \
  --json '{"name": "Q2 Project", "mimeType": "application/vnd.google-apps.folder"}'

# Download a file
gws drive files get \
  --params '{"fileId": "FILE_ID", "alt": "media"}' -o report.pdf

# Export a Google Doc as PDF
gws drive files export \
  --params '{"fileId": "FILE_ID", "mimeType": "application/pdf"}' -o document.pdf

# Share a folder with a colleague
gws drive permissions create \
  --params '{"fileId": "FOLDER_ID"}' \
  --json '{"role": "writer", "type": "user", "emailAddress": "colleague@company.com"}'

عمليات جداول البيانات (Sheets)

# Read data from a specific range
gws sheets +read --spreadsheet-id SHEET_ID --range 'Contacts!A2:C'

# Append a new row of data
gws sheets +append --spreadsheet-id SHEET_ID --range 'Sheet1' \
  --values '["2026-03-05", "Marketing", "Ad spend", "1500"]'

# Create a brand new spreadsheet
gws drive files create \
  --json '{"name": "Expense Tracker 2026", "mimeType": "application/vnd.google-apps.spreadsheet"}'

إنشاء المستندات والمحتوى

# Create a new document
gws docs documents create --json '{"title": "Meeting Notes - March 2026"}'

# Write content to an existing doc
gws docs +write --document-id DOC_ID \
  --text '## Project: Q2 Launch\n\n### Objective\nLaunch the new feature by end of Q2.'

الدردشة، الاجتماعات، النماذج، والمزيد

# Send a team notification in Google Chat
gws chat +send --space spaces/TEAM_SPACE \
  --text 'Important: Please check your email for the updated policy.'

# Create a Google Meet room
gws meet spaces create --json '{"config": {"accessType": "OPEN"}}'

# Create a feedback form
gws forms forms create \
  --json '{"info": {"title": "Event Feedback", "documentTitle": "Event Feedback Form"}}'

# Create a presentation
gws slides presentations create --json '{"title": "Quarterly Review Q2"}'

لاحظ النمط. كل إجراء هو سطر واحد. تتعامل أوامر المساعدة + (مثل +send، +upload، +agenda، +triage، +read، +append، +write) مع جميع عمليات الترميز والتنسيق الفوضوية التي تستغرق عادةً 10 أسطر من التعليمات النمطية. لا يحتاج وكيلك إلى معرفة تنسيق البريد الإلكتروني RFC 2822 أو ترميز base64. إنه يخبر فقط بما يريد القيام به ويتولى gws الباقي.

الأمان و Model Armor

إليك شيء لا يحظى باهتمام كافٍ. يتضمن المستودع تكاملاً مع 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"

أوضاع التنقية

لماذا هذا مهم

وجد فريق أمان الذكاء الاصطناعي في Cisco أن 26% من أكثر من 31,000 مهارة على ClawHub تحتوي على ثغرات أمنية. ذكرت SecurityScorecard أن 63% من مثيلات OpenClaw المكشوفة تم تكوينها بشكل خاطئ. أمان الوكيل ليس مشكلة نظرية. إنه يحدث الآن.

إن وجود تصفية أمان مدمجة في مسار البيانات هو خطوة ذكية من Google.

متغيرات البيئة للأمان

# Default Model Armor template
export GOOGLE_WORKSPACE_CLI_SANITIZE_TEMPLATE="projects/P/locations/L/templates/T"

# Sanitization mode (warn or 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 في منح الأدوات الخارجية ووكلاء الذكاء الاصطناعي إمكانية الوصول إلى Workspace.

gws مقابل أدوات الطرف الثالث (Zapier, Make)

أدوات الطرف الثالث منطقية للمستخدمين غير التقنيين. gws منطقي للمطورين وإعدادات وكلاء الذكاء الاصطناعي.

دليل البدء

هل أنت مستعد لتجربة هذا؟ إليك أسرع طريق لإعداد عملي.

المتطلبات الأساسية

• Node.js 18+ (لتثبيت npm)
• مشروع Google Cloud (لبيانات اعتماد OAuth)
• حساب Google مع وصول إلى Google Workspace
• تثبيت gcloud CLI (اختياري ولكنه موصى به لأسرع إعداد)

الخطوة 1: تثبيت gws

npm install -g @googleworkspace/cli

تتضمن حزمة npm ملفات ثنائية أصلية مسبقة البناء لنظام التشغيل والبنية الخاصة بك. لا يلزم وجود سلسلة أدوات Rust.

الخطوة 2: إعداد المصادقة

gws auth setup

يرشدك هذا عبر تكوين مشروع Google Cloud. يقوم بإنشاء مشروع سحابي، وتمكين واجهات برمجة التطبيقات، وتسجيل دخولك.

إذا لم يكن لديك gcloud مثبتًا، يمكنك إعداد OAuth يدويًا من خلال Google Cloud Console.

الخطوة 3: تسجيل الدخول

gws auth login

يفتح هذا متصفحًا لاختيار نطاق OAuth وتسجيل الدخول.

الخطوة 4: اختبار الإعداد الخاص بك

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

يجب أن ترى استجابة JSON تحتوي على ملفاتك الأخيرة.

الخطوة 5: التكامل مع OpenClaw

# Clone the repo
git clone https://github.com/googleworkspace/cli.git
cd cli

# Symlink all skills
ln -s $(pwd)/skills/gws-* ~/.openclaw/skills/

الخطوة 6: البدء في الاستخدام عبر المراسلة

أرسل رسالة عبر منصة مراسلة OpenClaw التي قمت بتكوينها:

"List my 5 most recent Drive files"

سيقوم OpenClaw بتنفيذ أمر gws المناسب وإرسال النتائج.

استكشاف المشكلات الشائعة وإصلاحها

"تم حظر الوصول" أو 403 أثناء تسجيل الدخول

تطبيق OAuth الخاص بك في وضع الاختبار وحسابك غير مدرج كمستخدم اختبار.

الإصلاح: افتح شاشة موافقة OAuth في مشروع GCP الخاص بك، وانتقل إلى "مستخدمي الاختبار"، وأضف عنوان بريدك الإلكتروني لحساب Google، ثم أعد محاولة gws auth login.

"لم يتحقق Google من هذا التطبيق"

متوقع عندما يكون تطبيقك في وضع الاختبار. انقر على "متقدم"، ثم "انتقال إلى (غير آمن)" للمتابعة. هذا آمن للاستخدام الشخصي.

خطأ عدد كبير جدًا من النطاقات

التطبيقات غير الموثقة (في وضع الاختبار) محدودة بحوالي 25 نطاق OAuth. تتضمن الإعدادات المسبقة للنطاقات الموصى بها العديد من النطاقات وستتجاوز هذا الحد.

الإصلاح: اختر النطاقات التي تحتاجها فقط:

gws auth login --scopes drive,gmail,calendar

واجهة برمجة التطبيقات غير ممكّنة

إذا لم تكن واجهة برمجة تطبيقات Google المطلوبة ممكّنة لمشروع GCP الخاص بك، فسترى خطأ 403 مع سبب accessNotConfigured.

يطبع gws تلميحًا قابلاً للتنفيذ مع رابط لتمكين واجهة برمجة التطبيقات. انقر فوق الرابط، وقم بتمكينه، وانتظر حوالي 10 ثوانٍ، ثم أعد المحاولة.

الخاتمة

يمثل Google Workspace CLI شيئًا مهمًا لنظام وكلاء الذكاء الاصطناعي البيئي. إنه ليس مجرد غلاف CLI آخر. إنه بنية تحتية تجعل أتمتة الذكاء الاصطناعي متاحة لأي شخص قام بتثبيت npm.

البنية صلبة. تغطية المهارات رائعة. حقيقة أن Google بنت توافق OpenClaw من اليوم الأول تخبرك إلى أين يتجه نظام وكلاء الذكاء الاصطناعي.

بالنسبة للمطورين الذين يبنون على OpenClaw أو Claude Code أو أي منصة وكيل، فإن gws هي إحدى الأدوات التي سترغب في امتلاكها في مجموعة أدواتك. إنها تتعامل مع تعقيدات واجهات برمجة تطبيقات Google Workspace حتى يتمكن وكيلك من التركيز على ما يهم - إنجاز العمل.

اقتصاد الوكلاء يحصل على بنيته التحتية. ويحدث ذلك أسرع مما يدركه معظم الناس.

الأسئلة الشائعة

س: هل gws مجاني للاستخدام؟

ج: نعم، gws هو مفتوح المصدر بموجب ترخيص Apache-2.0. تدفع فقط مقابل استخدام Google API إذا تجاوزت الحصص المجانية.

س: هل أحتاج إلى حساب Google Workspace؟

ج: يعمل حساب Google القياسي لمعظم الميزات. تتطلب بعض واجهات برمجة تطبيقات المشرف (Admin APIs) اشتراكًا في Workspace.

س: هل يمكنني استخدام gws بدون OpenClaw؟

ج: بالتأكيد. يعمل gws كأداة CLI مستقلة. تكامل OpenClaw اختياري للوصول المستند إلى المراسلة.

س: كيف أقوم بتحديث gws؟

ج: قم بتشغيل npm update -g @googleworkspace/cli للحصول على أحدث إصدار. يقرأ CLI خدمة اكتشاف Google (Discovery Service) في وقت التشغيل، لذلك لديه دائمًا وصول إلى أحدث واجهات برمجة التطبيقات.

س: هل بياناتي آمنة مع gws؟

ج: يقوم gws بتخزين بيانات الاعتماد مشفرة في وضع السكون باستخدام AES-256-GCM مع مفاتيح في سلسلة مفاتيح نظام التشغيل الخاص بك. يوفر تكامل Model Armor أمانًا إضافيًا لمهام سير عمل الوكيل.

س: هل يمكنني استخدام gws في مسارات CI/CD؟

ج: نعم. قم بتصدير بيانات الاعتماد الخاصة بك باستخدام gws auth export --unmasked > credentials.json واضبط GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE في بيئة CI الخاصة بك.

س: ما الفرق بين gws و Google APIs Explorer؟

ج: gws هي أداة CLI مصممة للأتمتة وتكامل وكلاء الذكاء الاصطناعي. APIs Explorer هي أداة اختبار قائمة على الويب. يخرج gws JSON منظمًا ويدعم البرمجة النصية.

س: هل يعمل gws مع حسابات الخدمة؟

ج: نعم. قم بتعيين GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE لملف مفتاح JSON الخاص بحساب الخدمة الخاص بك. لا يلزم تسجيل دخول تفاعلي.

س: هل يمكنني المساهمة في gws؟

ج: نعم، المشروع مفتوح المصدر على GitHub. لاحظ أن طلبات السحب من غير المتعاونين معطلة مؤقتًا وفقًا لمشرفي المستودع.

س: ما هي المنصات التي يدعمها gws؟

ج: يشحن gws ملفات ثنائية مسبقة البناء لأنظمة macOS و Linux و Windows. تتعامل حزمة npm مع تثبيت الملف الثنائي الأصلي تلقائيًا.