tl;dr: Biar OpenClaw bisa baca-tulis Google Drive, Docs, dan Sheets, kamu butuh 3 hal: (1) project + OAuth Client di Google Cloud Console, (2) aktifin Drive API + Sheets API + Docs API, (3) authorize sekali buat dapet refresh token yang disimpan lokal \u2014 habis itu agent bisa akses tanpa login ulang. Tutorial ini jalanin step-by-step sampai OpenClaw beneran bisa bikin dokumen & tulis sel spreadsheet sendiri. Semua pakai OAuth resmi Google, bukan hack.<\/p>\n
OpenClaw jago ngerjain tugas otomatis, tapi secara default dia gak bisa nyentuh Google Drive-mu \u2014 Google gak ngasih akses ke aplikasi manapun tanpa izin eksplisit. Kabar baiknya: nyambunginnya gak seribet yang kamu kira. Sekali setup, agent-mu bisa bikin laporan ke Google Docs, update Sheet, atau baca file di Drive tanpa kamu sentuh manual lagi.<\/p>\n
Kita pakai jalur resmi: Google Cloud OAuth2<\/strong>. Ini cara yang Google sediakan buat aplikasi pihak ketiga akses data user dengan izin. Aman, gak langgar aturan, dan token-nya bisa dipakai berkali-kali tanpa authorize ulang.<\/p>\n Gak perlu kartu kredit \u2014 Drive, Docs, dan Sheets API semuanya gratis dalam kuota wajar buat pemakaian personal\/bisnis kecil.<\/p>\n Project ini kayak “wadah” buat semua API dan kredensial yang bakal kamu pakai. Satu project cukup buat Drive + Docs + Sheets sekaligus.<\/p>\n Di menu kiri, masuk APIs & Services \u2192 Library<\/strong>. Cari dan aktifin satu per satu (klik nama \u2192 tombol Enable<\/strong>):<\/p>\n Tips: kalau kamu upload HTML dan biar Google yang convert ke format Docs, kamu cukup Drive API \u2014 konversi jenis file dihandle Drive sendiri. Docs API baru perlu kalau mau edit isi dokumen sel-per-sel secara terprogram.<\/p>\n Sebelum bikin kredensial, Google minta kamu isi “consent screen” \u2014 halaman izin yang muncul saat authorize.<\/p>\n Catatan penting soal mode testing: kalau app-mu status “Testing” (belum di-publish resmi), refresh token bisa expire kalau idle lebih dari 7 hari<\/strong>. Buat pemakaian jangka panjang, publish app-nya (atau siapin flow re-authorize kalau token mati \u2014 gampang, tinggal ulang sekali).<\/p>\n File ini isinya Ini langkah kunci: kamu authorize sekali secara manual, dapet refresh token<\/strong>, simpan lokal. Setelah itu OpenClaw bisa dapet access token baru kapan aja tanpa login ulang.<\/p>\n Alurnya:<\/p>\n Scope yang lazim dipakai buat baca-tulis penuh:<\/p>\n Kalau kamu cuma butuh baca (gak nulis), pakai versi Setelah Contoh operasi yang bisa langsung jalan setelah setup:<\/p>\n Buat OpenClaw, kamu tinggal simpen Google punya dua cara akses: OAuth (atas nama user) dan Service Account (identitas robot terpisah). Buat akses Drive\/Docs\/Sheet di akun Google pribadi<\/strong>, OAuth lebih cocok \u2014 Service Account punya storage quota sendiri yang 0 di Gmail pribadi, jadi sering gagal upload. Service Account baru masuk akal kalau kamu pakai Google Workspace dengan domain-wide delegation. Buat mayoritas kasus personal\/bisnis kecil, OAuth jalan mulus. Kalau kamu mau bangun agent yang lebih kompleks dan butuh pendampingan, konsepnya juga dibahas di panduan membuat Karyawan AI langkah demi langkah<\/a>.<\/p>\n Tidak. Google Drive API, Sheets API, dan Docs API gratis dalam kuota wajar untuk pemakaian personal dan bisnis kecil. Kamu tidak perlu kartu kredit untuk bikin project dan OAuth Client di Google Cloud Console.<\/p>\n Karena Drive\/Docs\/Sheets berisi data milik user, Google mewajibkan izin eksplisit lewat OAuth \u2014 bukan sekadar API key. Kamu authorize sekali untuk dapat refresh token, setelah itu agent bisa dapat access token baru otomatis tanpa login ulang.<\/p>\n Kalau OAuth app kamu masih status “Testing” (belum dipublish), refresh token bisa expire kalau tidak dipakai lebih dari 7 hari. Solusinya: publish app-nya untuk pemakaian jangka panjang, atau siapkan flow re-authorize singkat kalau token mati \u2014 cukup ulang proses authorize sekali.<\/p>\n OAuth mengakses data atas nama user (akun Google-mu), Service Account adalah identitas robot terpisah dengan storage sendiri. Untuk akses Drive di akun Gmail pribadi, OAuth lebih cocok karena Service Account punya quota storage 0 di Gmail pribadi sehingga sering gagal upload. Service Account cocok untuk Google Workspace dengan domain-wide delegation.<\/p>\n Aman selama kamu pakai scope seminimal mungkin, simpan file token dengan permission terbatas, tidak commit ke repo publik, dan segera revoke akses kalau token bocor. Prinsipnya least-privilege \u2014 kalau agent cuma perlu baca, jangan kasih izin tulis.<\/p>\n Disclaimer: Artikel ini bersifat edukasi dan informasi, bukan saran final. Tampilan Google Cloud Console dan detail API bisa berubah sewaktu-waktu \u2014 verifikasi langkah terkini di dokumentasi resmi Google sebelum implementasi di sistem produksi.<\/em><\/p>\n Referensi:<\/strong><\/p>\n tl;dr: Biar OpenClaw bisa baca-tulis Google Drive, Docs, dan Sheets, kamu butuh 3 hal: (1) project + OAuth Client di Google Cloud Console, (2) aktifin Drive API + Sheets API + Docs API, (3) authorize sekali buat dapet refresh token yang disimpan lokal \u2014 habis itu agent bisa akses tanpa login ulang. Tutorial ini jalanin […]<\/p>\n","protected":false},"author":1,"featured_media":699,"comment_status":"open","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[75],"tags":[],"class_list":["post-687","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-tutorial"],"_links":{"self":[{"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/posts\/687","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/comments?post=687"}],"version-history":[{"count":2,"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/posts\/687\/revisions"}],"predecessor-version":[{"id":694,"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/posts\/687\/revisions\/694"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/media\/699"}],"wp:attachment":[{"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/media?parent=687"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/categories?post=687"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/tags?post=687"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}Yang kamu butuhin sebelum mulai<\/h2>\n
\n
Langkah 1: Bikin project di Google Cloud Console<\/h2>\n
\n
Langkah 2: Aktifin 3 API yang diperlukan<\/h2>\n
\n
Langkah 3: Setup OAuth Consent Screen<\/h2>\n
\n
Langkah 4: Bikin OAuth Client ID<\/h2>\n
\n
client_secret<\/code> kamu. Simpan di folder kerja OpenClaw (misal oauth_client.json<\/code>).<\/li>\n<\/ol>\nclient_id<\/code> dan client_secret<\/code> \u2014 jangan pernah di-share atau commit ke repo publik. Anggap kayak password.<\/p>\nLangkah 5: Authorize sekali, simpan refresh token<\/h2>\n
\n
access_type=offline<\/code> dan prompt=consent<\/code> supaya refresh token keluar) + daftar scope yang diminta.<\/li>\nauthorization code<\/code>. Copas balik ke script.<\/li>\naccess_token<\/code> + refresh_token<\/code>, simpan ke token.json<\/code>.<\/li>\n<\/ol>\n\n
https:\/\/www.googleapis.com\/auth\/drive<\/code> \u2014 akses penuh Drive (baca, upload, hapus file yang dibuat app).<\/li>\nhttps:\/\/www.googleapis.com\/auth\/spreadsheets<\/code> \u2014 baca-tulis Sheets.<\/li>\nhttps:\/\/www.googleapis.com\/auth\/documents<\/code> \u2014 baca-tulis Docs (kalau pakai Docs API).<\/li>\n<\/ul>\n.readonly<\/code> biar lebih aman \u2014 misal drive.readonly<\/code>. Prinsip least-privilege: kasih izin seminimal yang diperlukan.<\/p>\nLangkah 6: Pakai token buat baca-tulis<\/h2>\n
token.json<\/code> punya refresh token, pola kerjanya begini tiap OpenClaw mau akses Google:<\/p>\n\n
refresh_token<\/code> jadi access_token<\/code> baru (access token expire tiap ~1 jam, tapi refresh token tetap valid).<\/li>\nPOST<\/code> ke Drive buat bikin dokumen, atau PUT values<\/code> ke Sheets buat tulis sel spesifik.<\/li>\n<\/ol>\n\n
Sheet1!A1:C1<\/code>) tanpa nimpa data lain \u2014 non-destruktif.<\/li>\noauth_client.json<\/code> + token.json<\/code> di folder kerja agent, dan bikin skill\/script yang manggil pola di atas. Sekali jadi, agent bisa bikin laporan otomatis ke Docs, update dashboard Sheet, atau arsip file ke Drive \u2014 semua tanpa intervensi manual. Konsep nyambungin agent ke API eksternal kayak gini kami bahas lebih dalam di panduan menghubungkan AI agent ke tools & API eksternal<\/a>.<\/p>\nKenapa OAuth, bukan Service Account?<\/h2>\n
Keamanan: hal yang gak boleh kamu lewatin<\/h2>\n
\n
oauth_client.json<\/code> & token.json<\/code> ke repo publik.<\/strong> Tambahin ke .gitignore<\/code>. Token = akses penuh ke Drive-mu.<\/li>\n.readonly<\/code>. Jangan kasih akses tulis kalau gak perlu.<\/li>\nPertanyaan yang Sering Ditanya<\/h2>\n
Apakah setup ini berbayar?<\/h3>\n
Kenapa harus authorize dulu, gak bisa langsung pakai API key?<\/h3>\n
Refresh token-nya expire gak?<\/h3>\n
Bedanya OAuth sama Service Account apa?<\/h3>\n
Apakah aman kasih akses Drive ke AI agent?<\/h3>\n
\n\n