← 返回 Skills 市场
Gws Docs
作者
googleworkspace-bot
· GitHub ↗
· v1.0.12
· MIT-0
892
总下载
0
收藏
20
当前安装
13
版本数
在 OpenClaw 中安装
/install gws-docs
功能描述
Read and write Google Docs.
使用说明 (SKILL.md)
docs (v1)
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
gws docs \x3Cresource> \x3Cmethod> [flags]
Helper Commands
| Command | Description |
|---|---|
+write |
Append text to a document |
API Resources
documents
batchUpdate— Applies one or more updates to the document. Each request is validated before being applied. If any request is not valid, then the entire request will fail and nothing will be applied. Some requests have replies to give you some information about how they are applied. Other requests do not need to return information; these each return an empty reply. The order of replies matches that of the requests.create— Creates a blank document using the title given in the request. Other fields in the request, including any provided content, are ignored. Returns the created document.get— Gets the latest version of the specified document.
Discovering Commands
Before calling any API method, inspect it:
# Browse resources and methods
gws docs --help
# Inspect a method's required params, types, and defaults
gws schema docs.\x3Cresource>.\x3Cmethod>
Use gws schema output to build your --params and --json flags.
安全使用建议
This skill appears to be a thin wrapper around a local 'gws' CLI for Google Docs, which is reasonable — but the SKILL.md defers authentication to ../gws-shared/SKILL.md and declares no required credentials. Before installing: 1) Inspect the referenced ../gws-shared/SKILL.md to see exactly how auth tokens are obtained, stored, and protected (env vars vs files). 2) Verify the provenance and integrity of the 'gws' binary you will run (source, version, checksums). 3) Run gws docs --help and gws schema locally in a sandbox to confirm what data is sent/received and whether any files or tokens are created. 4) Ask the skill author to declare required credentials and explain what gws generate-skills does and where it writes files. If you cannot review the shared auth SKILL.md and the gws binary, treat this skill as higher risk and avoid granting access to production credentials.
功能分析
Type: OpenClaw Skill
Name: gws-docs
Version: 1.0.12
The skill bundle for 'gws-docs' is a standard documentation wrapper for interacting with Google Docs via the 'gws' CLI tool. It defines basic API resources (documents) and methods (get, create, batchUpdate) without any evidence of malicious intent, data exfiltration, or harmful prompt injection.
能力评估
Purpose & Capability
Name/description match a gws-based Google Docs helper and the declared required binary (gws) is appropriate. However, the skill does not declare any auth/credentials even though the SKILL.md explicitly says to read ../gws-shared/SKILL.md for auth and security rules. Not declaring where credentials come from (env vars or config paths) is inconsistent with the stated capability.
Instruction Scope
Runtime instructions are minimal and rely entirely on the external gws CLI, which is fine. But the SKILL.md directs the agent to read a sibling file (../gws-shared/SKILL.md) for authentication and security rules and to run gws generate-skills if missing. That creates cross-skill dependencies and potentially causes the agent to read or create files outside this skill's directory — behavior not explained or declared.
Install Mechanism
Instruction-only skill with no install spec and no code files; lowest install risk. It simply requires the gws binary to be present on PATH.
Credentials
No env vars or credentials are declared, yet the SKILL.md implicitly requires authentication to Google via a shared SKILL.md. This mismatch (no declared primaryEnv but an explicit auth prerequisite) is disproportionate and unclear. It's unknown where tokens will be read from or stored.
Persistence & Privilege
always is false and the skill is user-invocable; the skill does not request elevated or persistent platform privileges. Note: the SKILL.md's instructions to read/write sibling files could cause on-disk changes depending on gws behavior, but the skill itself does not force always-on or modify other skills' configurations according to the manifest.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install gws-docs - 安装完成后，直接呼叫该 Skill 的名称或使用
/gws-docs触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.12
- Bumped skill metadata version to 0.22.5.
v1.0.11
- Updated metadata version from 0.22.3 to 0.22.4 in SKILL.md.
v1.0.10
- Updated skill metadata version from 0.22.2 to 0.22.3 in SKILL.md.
v1.0.9
- Updated metadata version from 0.22.1 to 0.22.2 in SKILL.md.
- No changes to functionality or documentation content.
v1.0.8
- Updated metadata version from 0.22.0 to 0.22.1 in SKILL.md.
v1.0.7
- Bumped metadata version from 0.21.2 to 0.22.0 in SKILL.md.
- No functional or content changes to documentation or commands.
v1.0.6
- Updated version metadata from 0.21.1 to 0.21.2 in SKILL.md.
v1.0.5
- Bumped version to 0.21.1 in metadata.
- No other functional or documentation changes.
v1.0.4
- Updated version number from 0.20.0 to 0.20.1 in skill metadata.
v1.0.3
- Version updated to 0.20.0 in metadata.
- No changes to features, commands, or usage documented.
v1.0.2
- Updated metadata version format and moved version under metadata.
- Removed the top-level version field from SKILL.md.
- No changes to commands or functionality.
v1.0.1
- Updated formatting of the metadata section in SKILL.md for consistency.
- No functional or user-facing changes.
v1.0.0
Initial release – Adds support for reading and writing Google Docs via CLI.
- Introduces core commands to create, get, and batch update Google Docs.
- Includes helper documentation for appending text to documents.
- Provides instructions for exploring available resources and their schemas.
- Categorized under "productivity" and requires the "gws" binary.
元数据
常见问题
Gws Docs 是什么？
Read and write Google Docs. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 892 次。
如何安装 Gws Docs？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install gws-docs」即可一键安装，无需额外配置。
Gws Docs 是免费的吗？
是的，Gws Docs 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Gws Docs 支持哪些平台？
Gws Docs 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Gws Docs？
由 googleworkspace-bot（@googleworkspace-bot）开发并维护，当前版本 v1.0.12。
推荐 Skills