OpenClaw Google Docs
Use gog for Google Docs operations. Read ../gog/SKILL.md first for shared auth,
output, safety, and live-write rules.
Safe start
gog auth list --check --json --no-input
gog schema docs --json
gog --readonly --account user@example.com docs cat DOCUMENT_ID --json --wrap-untrusted
- Select the account explicitly with
--account. - Use
--json --wrap-untrustedfor agent-readable Google content. - Use
--readonlywhen the task must not mutate Google data. - Use
--no-inputin automation and--dry-runbefore supported writes. - Confirm the exact account, object, and mutation before any write or delete.
Commands
| Command | Purpose |
|---|---|
add-tab |
Add a tab to a Google Doc |
cat |
Print a Google Doc as plain text |
cell-style |
Apply table cell, border, padding, alignment, and text styling |
cell-update |
Replace or append content inside a specific table cell |
clear |
Clear all content from a Google Doc |
comments |
Manage comments on files |
copy |
Copy a Google Doc |
create |
Create a Google Doc |
delete |
Delete text range from document |
delete-tab |
Delete a tab from a Google Doc |
edit |
Find and replace text in a Google Doc |
export |
Export a Google Doc (pdf|docx|txt|md|html) |
find-range |
Find text and print Docs API UTF-16 index ranges |
find-replace |
Find and replace text. Supports plain text or markdown with images; use --first for a single occurrence. |
footer |
List, create, or delete document footers |
format |
Apply text or paragraph formatting to a Google Doc |
header |
List, create, or delete document headers |
headings |
List document headings |
images |
List document images |
info |
Get Google Doc metadata |
insert |
Insert text at a specific position |
insert-date-chip |
Insert a native date smart chip |
insert-file-chip |
Insert a native Drive file smart chip |
insert-footnote |
Insert and populate a footnote |
insert-horizontal-rule |
Insert a paragraph-border horizontal rule |
insert-image |
Insert a public image URL or upload a local image into a Google Doc |
insert-page-break |
Insert a page break at a specific position (or end-of-doc with --at-end) |
insert-person |
Insert a native person smart chip |
insert-section-break |
Insert a continuous or next-page section break |
insert-table |
Insert a native table at a specific position (or end-of-doc with --at-end), optionally populated via --values-json |
list-tabs |
List all tabs in a Google Doc |
named-range |
Manage named ranges |
page-layout |
Set page layout (pageless|pages) on an existing Google Doc |
paragraphs |
List document paragraphs |
raw |
Dump raw Google Docs API response as JSON (Documents.Get; lossless; for scripting and LLM consumption) |
rename-tab |
Rename a tab in a Google Doc |
replace-image |
Replace an existing image without changing its position or bounds |
section-columns |
Set the column count for a document section |
sed |
Regex find/replace (sed-style: s/pattern/replacement/g) |
structure |
Show document structure with numbered paragraphs |
suggestions |
List pending text suggestions |
table-column |
Insert or delete native table columns |
table-column-width |
Set or reset native table column widths |
table-merge |
Merge a native table cell range |
table-row |
Insert, delete, style, or pin native table rows |
table-unmerge |
Unmerge the region containing a native table cell |
tables |
List native tables |
tabs |
Manage Google Doc tabs |
update |
Insert or replace text at a specific index or range in a Google Doc |
write |
Write content to a Google Doc |
Run gog docs <command> --help for flags and gog schema docs <command> --json
for the machine-readable contract. Do not guess command syntax.