Agent Skill 一日工作坊 · 實戰銜接 · gog 萬能鑰匙
授權一次,讓 AI 成為你的 Google Workspace 工作夥伴
22 頁一把金鑰 · 全 Google 打通gog 寫回 Sheet
這段你要做到的事
用 OAuth 授權自己的 Google 帳號,讓 skill 拿到寫入 Sheet 的權限。流程走過一次,之後可複製到任何專案。
一個能把整理好的結果自動寫進 Sheet 的 skill。同事開試算表就看得到,不必你口頭轉述。
里程碑感:今天第一次「AI 直接寫進我的雲端」。skill 產的東西不再只留在對話視窗,而是進了你的工作系統。
先搞懂一個詞 · CLI
為什麼今天一直用 CLI
AI 是一顆很會處理文字的大腦。它不會拿滑鼠、不會用眼睛在畫面上找按鈕,讀文字、寫文字才是它擅長的事。讓它打一行指令,遠比讓它模擬人類點滑鼠簡單又可靠。
好判斷對錯,不必猜按鈕在畫面哪裡。
省資源、跑得快,不必先看懂整個畫面。
像寫劇本把步驟排好,一次跑完。
文件、教學、原始碼裡滿滿是指令,它特別熟。
所以:越來越多公司把自己的軟體與服務包成 CLI,就是為了讓 AI 更順、更省成本地直接操作它們。
這不是抽象知識
今天出現的工具,都是這種黑底打字的東西。先認得它們的名字,等一下畫面跳出來就不會慌。
| 工具 | 幫你操作什麼 | 哪一章 |
|---|---|---|
| gog | 整個 Google:Sheet (寫試算表)、Google Chat (發通知)、Drive (傳檔案)、Gmail (讀信) | 這一章 |
| ntn | Notion:讀寫你們的頁面與資料庫 | 裝 Notion CLI |
| yt-dlp | 從網站把影片與字幕抓下來 | 下載影片與字幕 |
你不用背指令,跟 AI 說一句話,它去敲。你要會的是看得懂它在敲什麼。
今天的主角工具 · gog
一個專門操作 Google 的命令行工具。授權一次,之後 AI 就用 gog 幫你動 Google,你一行指令都不用記。同一個 gog,能動你整個 Google。
| 服務 | 能做的事 |
|---|---|
| Google Sheets | 讀寫試算表儲存格、自動追加待辦與分類總帳 |
| Google Docs | 建立與讀寫文件、把會議紀錄或報告自動產出成文件 |
| Google Chat | 把訊息與檔案發進指定頻道,跑完自己來報告 |
| Google Drive | 上傳、下載、自動整理你的雲端硬碟檔案 |
| Gmail | 搜信、讀一整串往來、自動整理成摘要清單 |
| Google Calendar | 查行程、自動建立行事曆會議 |
先懂你等下會點的那個「允許」
授權畫面跳出來,你用自己的 Google 帳號點一次「允許」,把你勾選的權限借給 gog。
授權完,token 就存在你電腦裡。之後不必再點,gog 直接能用,不會每次都跳授權。
用你自己的帳號授權,寫進去的就是你自己的 Sheet、你自己的 Drive。權限只給你勾的那幾項。
記住一句話:OAuth 就是「你授權自己的帳號給工具用」。點一次允許、token 記住、之後動的都是你自己的東西。用公司帳號登入就能做,不必另外開帳號。
一圖看懂全流程 · 5 分鐘通關
登入 Google Cloud Console,點選左上角建立全新專案。
公司選「內部」免審查;個人 Gmail 選「外部」+加測試名單。
類型選「電腦版應用程式」,下載 secret.json。
在 API 庫搜尋並啟用 Sheets、Docs、Chat、Drive 等。
執行 gog auth 綁定,Token 加密存入系統鑰匙圈。
5 步走完,一輩子只要做一次。接下來我們跟著畫面一步一步做。
跟著畫面做 · 第一步

已經有現成專案的人可跳過。建一個新的最乾淨,名字下一頁填。
跟著畫面做 · 建專案


一個專案 = 一個獨立設定空間。公司帳號「位置」請選公司機構;個人 Gmail 帳號保留「無機構」即可。
跟著畫面做 · 設定同意畫面


第一步「應用程式資訊」照填即可。使用者支援與開發者 Email 填目前登入的信箱(公司或個人皆可)。
跟著畫面做 · 同意畫面 · 關鍵選擇

通關提醒:個人 Gmail 授權時若跳出「Google 尚未驗證」,點擊「進階 ➔ 前往 gogcli(不安全)」即可順利登入。
跟著畫面做 · 建立金鑰


一定選「電腦版應用程式」(Desktop app),不要選網頁應用程式。繁中介面叫「電腦版」,別找「桌面」。
跟著畫面做 · 建立金鑰 · 只有一次機會

.gitignore。金鑰 = 你的 Google 密碼等級。這個 JSON 檔等一下就是交給 gog 的憑證,交出去後由 gog 保管。
跟著畫面做 · 啟用 API
| 常用 6 大 API | 用途 |
|---|---|
| Google Sheets API | 寫 Sheet 試算表 |
| Google Docs API | 產出與讀寫 Google 文件 |
| Google Chat API | 發團隊頻道通知 |
| Google Drive API | 上傳、下載雲端檔案 |
| Gmail API | 讀信、整理摘要清單 |
| Google Calendar API | 查行程與建立會議 |


每個 API 搜一次、按一次「啟用」。上面六個是 gog 最常動到的 Google 服務;其中 Google Chat API 沒開,下一章會卡住,而且 Chat 按了「啟用」還要在下一章設定應用程式,到時候帶你做。
免記指令 · 讓 AI 幫你做安全審查與一鍵安裝
# 複製貼給 AI,讓它幫你把關並安裝:
這是一個操作 Google 的開源 CLI 工具:收到!我已為您審查 openclaw/gogcli 專案安全性:
brew install openclaw/tap/gogcli ➔ v1.2.0 已就緒
不用自己打指令!學會「讓 AI 先審查安全性再安裝」,既安全又省下查手冊與排錯的時間。
跟著畫面做 · 交給 gog 授權


把金鑰交給 gog 並跑授權,就會跳出這兩關。不用怕,鑰匙圈按 Always Allow,瀏覽器按繼續即可。
跟著畫面做 · 交給 gog 授權 · 完成


這整套設定,一次就好。之後就是後面講的:直接叫 AI「用 gog 幫我…」,它在背後跑,你看結果。
你對 AI 說這句話 · 最小驗收測試
# 複製貼給 AI,替換成你自己的 Sheet 網址:
我已經用 gog 授權好我的 Google 帳號了。| A | B | C | |
|---|---|---|---|
| 1 | A | ||
| 2 | B | ||
| 3 | C | ||
| 4 |
預期結果:Sheet 第一欄出現 A、B、C。這是今天最重要的里程碑。第一次 AI 寫進了你的雲端。
把上一節的成果接上來 · 兩大 Skill 首次串聯
# 叫 AI 調用 gog 寫入:
用 gog 把剛才那份會議紀錄裡的「行動 TODO 表」,整理成試算表,gog ➔ 寫入試算表
| 待辦事項 | 負責人 | 期限 | 狀態 |
|---|---|---|---|
| 補齊教學 | 魁哥 | 8/18 | 進行中 |
| 測試 API | John | 今日 | 已完成 |
| 寄送通知 | 小美 | 8/19 | 未開始 |
預期產出:一張雲端待辦表,傳連結給同事就馬上看得到。這是今天第一次把兩件事串起來:上一節做的 skill 產出東西,這一節把它送進雲端。
同一招 · 換掉資料就換一個用途
拍照辨識發票與收據,將金額、統編與日期整理後,一句話寫進報帳 Sheet,月底核銷不用再找檔案。
分好類的三百多則評論,依標籤自動寫入不同分頁,產品改善痛點一眼看完。
Gmail 或 LINE 訊息中「誰欠誰什麼、哪件尚未回覆」,自動整理成清單寫入追蹤台帳。
差別只有資料不一樣。鑰匙、gog、那句話的結構全都一樣。今天花的這半小時,換來上面每一個都不用再申請一次。
達標線在哪
寫進去了,代表金鑰申請對、授權也通了,整條路是活的。這就是這一節的門檻。
把上一節那份會議紀錄的行動 TODO 表寫進 Sheet。價值不在難度,在於你會親眼看到兩支東西被接起來。
不要硬卡,現場舉手一起弄通。多半是登入帳號不對,或公司政策鎖住建金鑰。當下弄不通,先把「AI 能寫進我的雲端」帶走,課後再補。
這段的核心是「AI 可以寫進我的雲端」。