← 返回 Skills 市场
11505
总下载
21
收藏
0
当前安装
12
版本数
在 OpenClaw 中安装
/install google-calendar-api
功能描述
Google Calendar API integration with managed OAuth. Create events, list calendars, check availability, and manage schedules. Use this skill when users want to interact with Google Calendar. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI with OAuth login, or over raw HTTP with a Maton API key where the CLI cannot be installed. The endpoints documented here are the intended surface, not a technical limit — the `maton api` passthrough can reach others the connection permits. Default to read and list calls, and confirm every write or new connection with the user.
安全使用建议
Install only if you trust Maton to broker Google Calendar access. Prefer OAuth, choose the narrowest Google scopes available, confirm the exact calendar/account before writes, and treat the raw API fallback/API key path as higher risk because it handles a long-lived credential.
能力评估
Credentials
Network access, Bash, and a Maton/Google Calendar account are proportionate for this integration, though calendar contents and scheduling actions can expose personal or business data.
Install Mechanism
Installation is limited to standard Maton CLI package-manager commands, with optional SDK installs; no bundled executable scripts or hidden install behavior were present.
Instruction Scope
The raw `maton api` passthrough is broader than the listed examples, but the artifact discloses that breadth and repeatedly requires read-first behavior plus explicit confirmation for writes and new connections.
Persistence & Privilege
OAuth profiles, stored credentials, and Google Calendar connections persist via the Maton/OS credential store, but this is disclosed with instructions not to inspect secrets and to revoke unused connections.
Purpose & Capability
The documented capabilities are coherent with the stated Google Calendar purpose: list calendars/events, check free/busy, and create, update, or delete events through Maton.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install google-calendar-api - 安装完成后，直接呼叫该 Skill 的名称或使用
/google-calendar-api触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.2.1
Address security-audit findings: disclose the api passthrough in the access-scope and description text, warn on irreversible connection deletion, add response data-minimization guidance, and correct app-specific auth and request-body notes
v1.2.0
CLI-first rewrite with the Maton SDK examples; clarify that the CLI and SDKs keep separate credential stores, and reword webhook egress warnings
v1.1.0
CLI-first rewrite: the maton CLI with OAuth login is the documented path, every example is a maton command, SDK examples added, and the raw HTTP fallback feeds the key on stdin instead of reading it from the environment
v1.0.8
- Removed the skill-card.md file from the project.
- No changes to functionality or APIs.
- Documentation and usage remain the same.
v1.0.7
- Added CLI command examples throughout for key workflows, including listing events and managing connections.
- Added installation instructions for NPM and Homebrew.
- Updated authentication and connection management sections with CLI usage alongside API examples.
- Expanded quick start section with practical 'agenda' command examples.
- Added CLI equivalents to API reference endpoints for easier usage.
- Improved clarity and structure of setup and operational instructions.
v1.0.6
- Updated all endpoint URLs from gateway.maton.ai and ctrl.maton.ai to api.maton.ai.
- Clarified connection management instructions and updated related endpoint examples.
- Added a section on security and permissions, emphasizing user approval for write operations.
- Removed the LICENSE.txt file from the repository.
v1.0.5
- Added a new `clawdbot` metadata section with an emoji and required `MATON_API_KEY` environment variable.
- No changes to code, endpoints, or functionality.
v1.0.4
No changes detected in this version.
v1.0.3
- Replaced most curl command examples with Python command-line scripts using `urllib.request` for easier cross-platform usage.
- Updated "Quick Start" and connection management sections to use Python snippets instead of curl.
- Documentation now emphasizes Python as the main method for interacting with the API from the command line.
- No changes to the API or endpoints; all updates are in documentation and examples only.
v1.0.2
- Added a note in the description directing users to use the api-gateway skill for other third party apps.
- Improved curl and environment variable usage instructions, including new notes on using curl -g with bracketed parameters and caveats about environment variable expansion when piping to other commands.
v1.0.1
- Updated the base URL syntax to use `{native-api-path}` for clarity.
- Expanded information and examples for specifying the Google Calendar connection with the `Maton-Connection` header.
- Added new fields to connection response examples, such as `creation_time`, `last_updated_time`, and `metadata`.
- Clarified instructions for obtaining an API key and managing multiple Google Calendar connections.
v1.0.0
Major update: Migrated implementation from local Python scripts to a managed cloud API with OAuth integration.
- Replaced all Python scripts and local environment setup with Maton-hosted endpoints and OAuth flow.
- Added detailed instructions for using the Maton API gateway and managing OAuth connections.
- Updated authentication to use the Maton API key in request headers.
- Provided comprehensive API reference and example code for JS and Python.
- Included error handling guidelines and links to official Google Calendar API resources.
元数据
常见问题
Google Calendar 是什么？
Google Calendar API integration with managed OAuth. Create events, list calendars, check availability, and manage schedules. Use this skill when users want to interact with Google Calendar. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI with OAuth login, or over raw HTTP with a Maton API key where the CLI cannot be installed. The endpoints documented here are the intended surface, not a technical limit — the `maton api` passthrough can reach others the connection permits. Default to read and list calls, and confirm every write or new connection with the user. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 11505 次。
如何安装 Google Calendar？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install google-calendar-api」即可一键安装，无需额外配置。
Google Calendar 是免费的吗？
是的，Google Calendar 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Google Calendar 支持哪些平台？
Google Calendar 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Google Calendar？
由 byungkyu（@byungkyu）开发并维护，当前版本 v1.2.1。
推荐 Skills