Claw — 面向AI代理的Google Workspace工具

通过您的@clawemail.com账户，使用claw操作Gmail、Drive、Docs、Sheets、Slides、Calendar和Forms。

设置

1. 1. 将您的ClawEmail凭证JSON保存到~/.config/clawemail/credentials.json
2. 设置环境变量：export CLAWEMAIL_CREDENTIALS=~/.config/clawemail/credentials.json

在https://clawemail.com获取凭证——注册后，访问/connect/YOUR_PREFIX授权OAuth。

获取访问令牌

所有API调用都需要Bearer令牌。使用辅助脚本刷新并缓存令牌：

bash
TOKEN=$(~/.openclaw/skills/clawemail/scripts/token.sh)

该脚本会缓存令牌50分钟。在进行API调用前，务必将其赋值给TOKEN。

Gmail

搜索邮件

bash
TOKEN=$(~/.openclaw/skills/clawemail/scripts/token.sh)
curl -s -H Authorization: Bearer $TOKEN \
https://gmail.googleapis.com/gmail/v1/users/me/messages?q=newer_than:7d&maxResults=10 | python3 -m json.tool

常用查询运算符：from:、to:、subject:、newerthan:、olderthan:、is:unread、has:attachment、label:、in:inbox。

阅读邮件

bash
curl -s -H Authorization: Bearer $TOKEN \
https://gmail.googleapis.com/gmail/v1/users/me/messages/MESSAGE_ID?format=full | python3 -m json.tool

若仅需纯文本正文，使用format=minimal并解码payload。如需可读输出：

bash
curl -s -H Authorization: Bearer $TOKEN \
https://gmail.googleapis.com/gmail/v1/users/me/messages/MESSAGE_ID?format=full \
| python3 -c
import json,sys,base64
m=json.load(sys.stdin)
hdrs={h[name]:h[value] for h in m[payload][headers]}
print(f\From: {hdrs.get(From,)}\nTo: {hdrs.get(To,)}\nSubject: {hdrs.get(Subject,)}\nDate: {hdrs.get(Date,)}\n\)
def get_body(part):
if part.get(body,{}).get(data):
return base64.urlsafe_b64decode(part[body][data]).decode(utf-8,replace)
for p in part.get(parts,[]):
if p[mimeType]==text/plain: return get_body(p)
for p in part.get(parts,[]):
b=get_body(p)
if b: return b
return
print(get_body(m[payload]))

发送邮件

bash
TOKEN=$(~/.openclaw/skills/clawemail/scripts/token.sh)
python3 -c
import base64,json
raw = base64.urlsafe_b64encode(
bTo: recipient@example.com\r\nSubject: Hello\r\nContent-Type: text/plain; charset=utf-8\r\n\r\nMessage body here
).decode()
print(json.dumps({raw: raw}))
| curl -s -X POST \
-H Authorization: Bearer $TOKEN \
-H Content-Type: application/json \
-d @- \
https://gmail.googleapis.com/gmail/v1/users/me/messages/send

对于HTML邮件，将Content-Type: text/plain替换为Content-Type: text/html，并在正文中使用HTML。

回复邮件

与发送相同，但需添加原始邮件的In-Reply-To:和References:头，并在JSON正文中包含threadId：

bash
python3 -c
import base64,json
raw = base64.urlsafe_b64encode(
bTo: recipient@example.com\r\nSubject: Re: Original Subject\r\nIn-Reply-To: \r\nReferences: \r\nContent-Type: text/plain; charset=utf-8\r\n\r\nReply body
).decode()
print(json.dumps({raw: raw, threadId: THREAD_ID}))
| curl -s -X POST \
-H Authorization: Bearer $TOKEN \
-H Content-Type: application/json \
-d @- \
https://gmail.googleapis.com/gmail/v1/users/me/messages/send

列出标签

bash
curl -s -H Authorization: Bearer $TOKEN \
https://gmail.googleapis.com/gmail/v1/users/me/labels | python3 -m json.tool

添加/移除标签

bash
curl -s -X POST -H Authorization: Bearer $TOKEN \
-H Content-Type: application/json \
-d {addLabelIds:[LABEL_ID],removeLabelIds:[INBOX]} \
https://gmail.googleapis.com/gmail/v1/users/me/messages/MESSAGE_ID/modify

Google Drive

列出文件

bash
TOKEN=$(~/.openclaw/skills/clawemail/scripts/token.sh)
curl -s -H Authorization: Bearer $TOKEN \
https://www.googleapis.com/drive/v3/files?pageSize=20&fields=files(id,name,mimeType,modifiedTime,size)&orderBy=modifiedTime desc | python3 -m json.tool

搜索文件

bash
curl -s -H Authorization: Bearer $TOKEN \
https://www.googleapis.com/drive/v3/files?q=name+contains+report&fields=files(id,name,mimeType,modifiedTime) | python3 -m json.tool

查询运算符：name contains term、mimeType=application/vnd.google-apps.document、FOLDER_ID in parents、trashed=false、modifiedTime > 2025-01-01。

常见MIME类型：

• - 文档：application/vnd.google-apps.document
• 电子表格：application/vnd.google-apps.spreadsheet
• 演示文稿：application/vnd.google-apps.presentation
• 文件夹：application/vnd.google-apps.folder
• 表单：application/vnd.google-apps.form

创建文件夹

bash
curl -s -X POST -H Authorization: Bearer $TOKEN \
-H Content-Type: application/json \
-d {name:My Folder,mimeType:application/vnd.google-apps.folder} \
https://www.googleapis.com/drive/v3/files?fields=id,name | python3 -m json.tool

上传文件

bash
curl -s -X POST -H Authorization: Bearer $TOKEN \
-F metadata={\name\:\report.pdf\};type=application/json \
-F file=@/path/to/report.pdf;type=application/pdf \
https://www.googleapis.com/upload/drive/v3/files?uploadType=multipart&fields=id,name | python3 -m json.tool

下载文件

对于Google Docs/Sheets/Slides（导出）：

bash
curl -s -H Authorization: Bearer $TOKEN \
https://www.googleapis.com/drive/v3/files/FILE_ID/export?mimeType=application/pdf -o output.pdf

导出格式：text/plain、text/html、application/pdf、application/vnd.openxmlformats-officedocument.wordprocessingml.document（docx）、text/csv（sheets）。

对于二进制文件（下载）：

bash
curl -s -H Authorization: Bearer $TOKEN \
https://www.googleapis.com/drive/v3/files/FILE_ID?alt=media -o output.file

共享文件

bash
curl -s -X POST -H Authorization: Bearer $TOKEN \
-H Content-Type: application/json \
-d {role:writer,type:user,emailAddress:user@example.com} \
https://www.googleapis.com/drive/v3/files/FILE_ID/permissions

角色：reader、commenter、writer、owner。类型：user、group、domain、anyone。

删除文件

bash
curl -s -X DELETE -H Authorization: Bearer $TOKEN \
https://www.googleapis