← 返回 Skills 市场
Google Calendar (via gcalcli)
作者
Nikita Shkoda
· GitHub ↗
· v3.0.0
16374
总下载
10
收藏
114
当前安装
11
版本数
在 OpenClaw 中安装
/install gcalcli-calendar
功能描述
Google Calendar via gcalcli: today-only agenda by default, bounded meaning-first lookup via agenda scans, and fast create/delete with verification--optimized for low tool calls and minimal output.
安全使用建议
Install this only if you are comfortable letting an agent use your authenticated gcalcli profile to read and change your Google Calendar. Pay particular attention to the documented policy that a clearly matched delete or edit request can run without a second confirmation; change that policy to always ask first if you prefer stricter control.
功能分析
Type: OpenClaw Skill
Name: gcalcli-calendar
Version: 3.0.0
The skill bundle is benign. It provides instructions for an AI agent to manage Google Calendar using the `gcalcli` command-line tool. All files clearly document the skill's purpose, usage, and underlying commands. The `SKILL.md` details a specific 'Actions policy' that skips confirmation for unambiguous actions, but this is explicitly stated as a deliberate UX choice with multiple safety guards (e.g., explicit user request, single unambiguous match, post-action verification, overlap checks for creates). There is no evidence of data exfiltration, malicious execution, persistence mechanisms, obfuscation, or prompt injection attempts designed to subvert the agent for harmful purposes. The `README.md` further clarifies network access (only Google Calendar API via gcalcli) and lists all used commands, reinforcing transparency.
能力评估
Purpose & Capability
The stated purpose is Google Calendar management, and the artifacts consistently describe reading, searching, creating, importing, editing by delete-and-recreate, and deleting calendar events via gcalcli. These are sensitive account actions, but they match the purpose and are disclosed.
Instruction Scope
The skill uses bounded agenda/search windows, asks for disambiguation on multiple or uncertain matches, checks overlaps before creating events, and verifies deletes. It intentionally skips an extra confirmation for explicit, unambiguous destructive requests, which is a real usability-risk tradeoff but is clearly documented and scoped.
Install Mechanism
The bundle contains only README.md and SKILL.md markdown instructions and no executable installer or scripts. It requires a separately installed gcalcli binary, with pip or brew mentioned as setup options.
Credentials
Access to Google Calendar and local gcalcli OAuth credentials is expected for this integration. The README documents the Google Calendar and OAuth endpoints used through gcalcli and states that no other network access is made.
Persistence & Privilege
The skill itself adds no background worker, persistence mechanism, or credential store. Privilege comes from the user's existing local gcalcli OAuth profile, which allows the agent to mutate calendar data when instructed.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install gcalcli-calendar - 安装完成后，直接呼叫该 Skill 的名称或使用
/gcalcli-calendar触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v3.0.0
- Added a README.md file with rationale and safety notes.
- Clarified action confirmation policy: unambiguous destructive actions (delete/edit) are run immediately, ambiguous ones always require user confirmation.
- Updated action policy section to emphasize conversational speed and personal assistant use case.
- Renamed/delete section now explicitly describes post-delete verification and the use of `--iamaexpert`.
- No behavior changes to commands, but documentation is clearer about UX intent and safeguards.
v2.1.2
- Removed internal metadata file (_meta.json) from the skill package.
- No changes to functional logic or user-facing features.
v2.1.1
Version 2.1.1
- Added _meta.json file for improved metadata management.
- No changes to existing skill logic or behavior.
v2.1.0
**Summary:** Adds explicit rules for CLI flag placement and event creation methods.
- Enforces that global CLI flags (like --nocolor, --calendar) must precede the subcommand; subcommand-specific flags come after (e.g., gcalcli --nocolor delete --iamaexpert ...).
- Provides guidance on choosing the correct event creation method: "add" for most events, "import" via stdin for recurring/free events, and avoid "quick" unless explicitly requested.
- Documents flag placement requirements for all subcommands (delete, add, import, etc.).
- Clarifies that for ICS imports, events must be piped via stdin and not via temporary files.
- Updates canonical command examples to reflect these rules.
v2.0.2
- Short summary: Event creation now checks for overlaps across all non-ignored calendars, not just the target calendar.
- Overlap checks before creating events now always scan the full agenda (without filtering by calendar), ensuring conflicts from any visible calendar are detected.
- Updated documentation to clarify that cross-calendar checking is required for create actions.
- Minor edits and clarifications to rules and canonical commands.
v2.0.1
- Updated skill description for greater clarity and brevity.
- No file or logic changes; internal policies, rules, and commands remain unchanged.
v2.0.0
Update version in ClawHub
v1.0.1
- Changed default agenda behavior: “agenda” without a period now shows only today.
- Unambiguous cancel/delete/edit actions now run immediately without confirmation; confirmation is only required if multiple candidates exist.
- Event creation only asks for confirmation if overlapping events are found; otherwise, events are created directly.
- [IMPORTANT] Deletes now use non-interactive mode with post-action verification and one retry if needed. If "confirm before delete" behavior is desired, you should adjust the corresponding skill rule.
- Responses are more concise; CLI commands are only shown when explicitly requested by the user.
- Improved handling and parsing rules for matching events, focusing on agenda scans over search for meaning-first, deterministic results.
- Overall tokens usage cuts.
v1.0.0
gcalcli-calendar 0.1.2
- Clarified scope usage: Only mention calendar scope and search window if no events are found.
- Response output is now even more concise—omit scope when events are found.
- Reorganized and simplified hard rules for brevity and clarity.
- Default agenda/search periods and response behaviors are more explicit.
- Calendar listing and scope debugging triggered only by user request or when results are unexpectedly empty.
v0.1.1
- Fix description in YAML frontmatter which prevented skill discovery
v0.1.0
gcalcli-calendar 0.1.0
- Initial release providing fast agenda (today/week/range), bounded keyword search, and safe event actions using `gcalcli`.
- Respects config-scoped `default-calendars` and `ignore-calendars` for reliable multi-calendar support.
- All searches and agendas use explicit, well-defined time windows (defaults to next ~6 months).
- Output is minimal and parse-friendly (`--nocolor`), optimized for both users and automated agents.
- All write actions (add/edit/delete) require explicit confirmation, summarizing proposed changes before execution.
- Clearly communicates scope of search/results, encouraging user-driven expansion when no matches are found.
元数据
常见问题
Google Calendar (via gcalcli) 是什么？
Google Calendar via gcalcli: today-only agenda by default, bounded meaning-first lookup via agenda scans, and fast create/delete with verification--optimized for low tool calls and minimal output. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 16374 次。
如何安装 Google Calendar (via gcalcli)？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install gcalcli-calendar」即可一键安装，无需额外配置。
Google Calendar (via gcalcli) 是免费的吗？
是的，Google Calendar (via gcalcli) 完全免费（开源免费），可自由下载、安装和使用。
Google Calendar (via gcalcli) 支持哪些平台？
Google Calendar (via gcalcli) 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Google Calendar (via gcalcli)？
由 Nikita Shkoda（@lstpsche）开发并维护，当前版本 v3.0.0。
推荐 Skills