Cal.com：自动化日程安排与预订 - Openclaw Skills-脚本在线

AI智能体脚本智能办公脚本自动化游戏脚本浏览器自动化脚本服务器脚本

Cal.com：自动化日程安排与预订 - Openclaw Skills

作者：互联网

2026-03-28

AI教程

什么是 Cal.com 日程安排与预订？

此技能提供了通往 Cal.com v2 API 的强大桥梁，允许 AI 代理处理复杂的调度任务。通过专用网关利用托管 OAuth，它简化了身份验证过程，使用户能够创建和管理事件类型、处理预订并配置空闲时间，而无需手动管理令牌。它是 Openclaw Skills 生态系统的重要组成部分，适用于希望通过代理自动化来自动化专业日历工作流并提高生产力的任何人。

下载入口:https://github.com/openclaw/skills/tree/main/skills/byungkyu/cal-com

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install cal-com

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 cal-com。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。

Cal.com 日程安排与预订应用场景

为特定团队成员自动创建新的会议事件类型。
实时检查特定时间段的空闲情况，以避免日程冲突。
通过 AI 代理自动预订预约并发送确认电子邮件。
管理和更新不同时区内的现有日程和工作时间。
设置 Webhook，以便在创建、改期或取消预订时触发外部操作。

Cal.com 日程安排与预订工作原理

用户使用 Maton API 密钥进行身份验证以访问安全网关。
通过专用控制面板与 Cal.com 建立托管 OAuth 连接。
请求发送到网关，网关直接将其代理到 Cal.com API。
网关自动在每个请求头中注入必要的 OAuth 令牌。
Openclaw Skills 界面处理响应，实现无缝的预订和日程管理，无需手动管理机密信息。

Cal.com 日程安排与预订配置指南

首先，从 Maton 设置仪表板获取您的 API 密钥。在终端中设置环境变量：

export MATON_API_KEY="YOUR_API_KEY"

通过向控制端点发送 POST 请求来创建 OAuth 连接，并按照返回的 URL 授权您的 Cal.com 帐户。授权后，您可以使用此命令验证您的个人资料：

curl -H "Authorization: Bearer $MATON_API_KEY" https://gateway.maton.ai/cal-com/v2/me

确保您拥有有效的活动连接，以使用全套 Openclaw Skills 功能。

Cal.com 日程安排与预订数据架构与分类体系

该技能利用标准的 RESTful 架构，所有资源均采用 JSON 响应。数据被组织成以下主要结构：

对象	关键字段	描述
用户资料	`id`, `email`, `timeZone`	基本账户信息和地区设置
事件类型	`title`, `slug`, `length`	不同会议格式和时长的定义
预订	`uid`, `startTime`, `status`	单个预订实例及其当前状态
日程	`workingHours`, `days`	从午夜开始以分钟定义的空闲窗口
空位	`time`	可供预订的单个时间戳

name: calcom
description: |
  Cal.com API integration with managed OAuth. Create and manage event types, bookings, schedules, and availability.
  Use this skill when users want to manage scheduling, create bookings, configure event types, or check availability.
  For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
  Requires network access and valid Maton API key.
metadata:
  author: maton
  version: "1.0"
  clawdbot:
    emoji: ??
    homepage: "https://maton.ai"
    requires:
      env:
        - MATON_API_KEY

Cal.com

Access the Cal.com API with managed OAuth authentication. Create and manage event types, bookings, schedules, calendars, and webhooks.

Quick Start

# Get your profile
python3 <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/cal-com/v2/me')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Base URL

https://gateway.maton.ai/cal-com/v2/{resource}

Replace {resource} with the Cal.com API endpoint path. The gateway proxies requests to api.cal.com and automatically injects your OAuth token.

Authentication

All requests require the Maton API key in the Authorization header:

Authorization: Bearer $MATON_API_KEY

Environment Variable: Set your API key as MATON_API_KEY:

export MATON_API_KEY="YOUR_API_KEY"

Getting Your API Key

Sign in or create an account at maton.ai
Go to maton.ai/settings
Copy your API key

Connection Management

Manage your Cal.com OAuth connections at https://ctrl.maton.ai.

List Connections

python3 <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections?app=cal-com&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Create Connection

python3 <<'EOF'
import urllib.request, os, json
data = json.dumps({'app': 'cal-com'}).encode()
req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Get Connection

python3 <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Response:

{
  "connection": {
    "connection_id": "4481afaa-03e4-4b2d-a1c6-7daaf4bff512",
    "status": "ACTIVE",
    "creation_time": "2026-02-12T22:52:17.140998Z",
    "last_updated_time": "2026-02-12T22:55:20.376189Z",
    "url": "https://connect.maton.ai/?session_token=...",
    "app": "cal-com",
    "metadata": {}
  }
}

Open the returned url in a browser to complete OAuth authorization.

Delete Connection

python3 <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}', method='DELETE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Specifying Connection

If you have multiple Cal.com connections, specify which one to use with the Maton-Connection header:

python3 <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/cal-com/v2/me')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Maton-Connection', '4481afaa-03e4-4b2d-a1c6-7daaf4bff512')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

If omitted, the gateway uses the default (oldest) active connection.

API Reference

User Profile

Get Profile

GET /cal-com/v2/me

Response:

{
  "status": "success",
  "data": {
    "id": 2152180,
    "email": "user@example.com",
    "name": "User Name",
    "avatarUrl": "https://...",
    "bio": "",
    "timeFormat": 12,
    "defaultScheduleId": null,
    "weekStart": "Sunday",
    "timeZone": "America/New_York"
  }
}

Update Profile

PATCH /cal-com/v2/me
Content-Type: application/json

{
  "bio": "Updated bio",
  "name": "New Name"
}

Event Types

List Event Types

GET /cal-com/v2/event-types

With username filter:

GET /cal-com/v2/event-types?username={username}

Response:

{
  "status": "success",
  "data": {
    "eventTypeGroups": [
      {
        "teamId": null,
        "bookerUrl": "https://cal.com",
        "profile": {
          "slug": "username",
          "name": "User Name"
        },
        "eventTypes": [
          {
            "id": 4716831,
            "title": "30 min meeting",
            "slug": "30min",
            "length": 30,
            "hidden": false
          }
        ]
      }
    ]
  }
}

Get Event Type

GET /cal-com/v2/event-types/{eventTypeId}

Create Event Type

POST /cal-com/v2/event-types
Content-Type: application/json

{
  "title": "Meeting",
  "slug": "meeting",
  "length": 30
}

Required fields:

title - Event type name
slug - URL slug (must be unique)
length - Duration in minutes

Response:

{
  "status": "success",
  "data": {
    "id": 4745911,
    "title": "Meeting",
    "slug": "meeting",
    "length": 30,
    "locations": [{"type": "integrations:daily"}],
    "hidden": false,
    "userId": 2152180
  }
}

Update Event Type

PATCH /cal-com/v2/event-types/{eventTypeId}
Content-Type: application/json

{
  "title": "Updated Meeting Title",
  "description": "Updated description"
}

Delete Event Type

DELETE /cal-com/v2/event-types/{eventTypeId}

Event Type Webhooks

List Webhooks

GET /cal-com/v2/event-types/{eventTypeId}/webhooks

Create Webhook

POST /cal-com/v2/event-types/{eventTypeId}/webhooks
Content-Type: application/json

{
  "subscriberUrl": "https://example.com/webhook",
  "triggers": ["BOOKING_CREATED"],
  "active": true
}

Available triggers: BOOKING_CREATED, BOOKING_RESCHEDULED, BOOKING_CANCELLED, BOOKING_CONFIRMED, BOOKING_REJECTED, BOOKING_REQUESTED, BOOKING_PAYMENT_INITIATED, BOOKING_NO_SHOW_UPDATED, MEETING_ENDED, MEETING_STARTED, RECORDING_READY, INSTANT_MEETING, RECORDING_TRANSCRIPTION_GENERATED

Get Webhook

GET /cal-com/v2/event-types/{eventTypeId}/webhooks/{webhookId}

Update Webhook

PATCH /cal-com/v2/event-types/{eventTypeId}/webhooks/{webhookId}
Content-Type: application/json

{
  "active": false
}

Delete Webhook

DELETE /cal-com/v2/event-types/{eventTypeId}/webhooks/{webhookId}

Bookings

List Bookings

GET /cal-com/v2/bookings

With filters:

GET /cal-com/v2/bookings?status=upcoming
GET /cal-com/v2/bookings?status=past
GET /cal-com/v2/bookings?status=cancelled
GET /cal-com/v2/bookings?status=accepted
GET /cal-com/v2/bookings?take=10

Response:

{
  "status": "success",
  "data": {
    "bookings": [
      {
        "id": 15893969,
        "uid": "gZJNR7FQG2qLsBqnFdxAPE",
        "title": "30 min meeting between User and Guest",
        "startTime": "2026-02-13T17:00:00.000Z",
        "endTime": "2026-02-13T17:30:00.000Z",
        "status": "ACCEPTED"
      }
    ],
    "totalCount": 1,
    "nextCursor": null
  }
}

Get Booking

GET /cal-com/v2/bookings/{bookingUid}

Create Booking

POST /cal-com/v2/bookings
Content-Type: application/json

{
  "eventTypeId": 4716831,
  "start": "2026-02-13T17:00:00Z",
  "timeZone": "America/New_York",
  "language": "en",
  "responses": {
    "name": "Guest Name",
    "email": "guest@example.com"
  },
  "metadata": {}
}

Required fields:

eventTypeId - ID of the event type
start - Start time in ISO 8601 format (must be an available slot)
timeZone - Valid IANA timezone
language - Language code (e.g., "en")
responses.name - Attendee name
responses.email - Attendee email

Response:

{
  "status": "success",
  "data": {
    "id": 15893969,
    "uid": "gZJNR7FQG2qLsBqnFdxAPE",
    "title": "30 min meeting between User and Guest Name",
    "startTime": "2026-02-13T17:00:00.000Z",
    "endTime": "2026-02-13T17:30:00.000Z",
    "status": "ACCEPTED",
    "location": "integrations:daily"
  }
}

Cancel Booking

POST /cal-com/v2/bookings/{bookingUid}/cancel
Content-Type: application/json

{
  "cancellationReason": "Reason for cancellation"
}

Schedules

Get Default Schedule

GET /cal-com/v2/schedules/default

Get Schedule

GET /cal-com/v2/schedules/{scheduleId}

Create Schedule

POST /cal-com/v2/schedules
Content-Type: application/json

{
  "name": "Work Hours",
  "timeZone": "America/New_York",
  "isDefault": false
}

Response:

{
  "status": "success",
  "data": {
    "id": 1243030,
    "name": "Work Hours",
    "isManaged": false,
    "workingHours": [
      {
        "days": [1, 2, 3, 4, 5],
        "startTime": 540,
        "endTime": 1020
      }
    ]
  }
}

Update Schedule

PATCH /cal-com/v2/schedules/{scheduleId}
Content-Type: application/json

{
  "name": "Updated Schedule Name"
}

Delete Schedule

DELETE /cal-com/v2/schedules/{scheduleId}

Availability Slots

Get Available Slots

GET /cal-com/v2/slots/available?eventTypeId={eventTypeId}&startTime={startTime}&endTime={endTime}

Parameters:

eventTypeId - Required. The event type ID
startTime - Required. Start of range (ISO 8601)
endTime - Required. End of range (ISO 8601)

Response:

{
  "status": "success",
  "data": {
    "slots": {
      "2026-02-13": [
        {"time": "2026-02-13T17:00:00.000Z"},
        {"time": "2026-02-13T17:30:00.000Z"},
        {"time": "2026-02-13T18:00:00.000Z"}
      ],
      "2026-02-14": [
        {"time": "2026-02-14T14:00:00.000Z"}
      ]
    }
  }
}

Reserve Slot

POST /cal-com/v2/slots/reserve
Content-Type: application/json

{
  "eventTypeId": 4716831,
  "slotUtcStartDate": "2026-02-20T14:00:00Z",
  "slotUtcEndDate": "2026-02-20T14:30:00Z"
}

Response:

{
  "status": "success",
  "data": "968ed924-83fb-4da7-969e-eaa621643535"
}

Calendars

List Connected Calendars

GET /cal-com/v2/calendars

Response:

{
  "status": "success",
  "data": {
    "connectedCalendars": [
      {
        "integration": {
          "name": "Google Calendar",
          "type": "google_calendar"
        },
        "calendars": [...]
      }
    ]
  }
}

Conferencing

List Conferencing Apps

GET /cal-com/v2/conferencing

Response:

{
  "status": "success",
  "data": [
    {
      "id": 1769268,
      "type": "google_video",
      "appId": "google-meet"
    }
  ]
}

Get Default Conferencing App

GET /cal-com/v2/conferencing/default

Webhooks (User-level)

List Webhooks

GET /cal-com/v2/webhooks

Create Webhook

POST /cal-com/v2/webhooks
Content-Type: application/json

{
  "subscriberUrl": "https://example.com/webhook",
  "triggers": ["BOOKING_CREATED"],
  "active": true
}

Get Webhook

GET /cal-com/v2/webhooks/{webhookId}

Update Webhook

PATCH /cal-com/v2/webhooks/{webhookId}
Content-Type: application/json

{
  "active": false
}

Delete Webhook

DELETE /cal-com/v2/webhooks/{webhookId}

Teams

List Teams

GET /cal-com/v2/teams

Verified Resources

List Verified Emails

GET /cal-com/v2/verified-resources/emails

Pagination

Bookings use cursor-based pagination with take and nextCursor:

GET /cal-com/v2/bookings?take=10

Response includes pagination info:

{
  "data": {
    "bookings": [...],
    "totalCount": 25,
    "nextCursor": "abc123"
  }
}

For next page:

GET /cal-com/v2/bookings?take=10&cursor=abc123

Code Examples

JavaScript

const response = await fetch(
  'https://gateway.maton.ai/cal-com/v2/event-types',
  {
    headers: {
      'Authorization': `Bearer ${process.env.MATON_API_KEY}`
    }
  }
);
const data = await response.json();

Python

import os
import requests

response = requests.get(
    'https://gateway.maton.ai/cal-com/v2/event-types',
    headers={'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}'}
)
data = response.json()

Notes

All times are in UTC unless a timezone is specified
length field in event types is in minutes
Booking creation requires an available slot - check /v2/slots/available first
Schedule working hours use minutes from midnight (540 = 9:00 AM, 1020 = 5:00 PM)
Days in schedules: 0 = Sunday, 1 = Monday, ... 6 = Saturday
The GET /v2/schedules endpoint may return 500 errors; use GET /v2/schedules/{id} instead
IMPORTANT: When using curl commands, use curl -g when URLs contain brackets to disable glob parsing
IMPORTANT: When piping curl output to jq or other commands, environment variables like $MATON_API_KEY may not expand correctly in some shell environments

Error Handling

Status	Meaning
400	Missing Cal.com connection or invalid request
401	Invalid or missing Maton API key
404	Resource not found
409	Conflict (duplicate resource)
429	Rate limited
500	Cal.com API error

Troubleshooting: API Key Issues

Check that the MATON_API_KEY environment variable is set:

echo $MATON_API_KEY

Verify the API key is valid by listing connections:

python3 <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Troubleshooting: Invalid App Name

Ensure your URL path starts with cal-com. For example:

Correct: https://gateway.maton.ai/cal-com/v2/me
Incorrect: https://gateway.maton.ai/v2/me

Troubleshooting: Booking Creation Fails

Check available slots before creating a booking:

GET /cal-com/v2/slots/available?eventTypeId={id}&startTime=...&endTime=...

Ensure all required fields are provided:
- eventTypeId
- start (must match an available slot)
- timeZone
- language
- responses.name
- responses.email

Resources

Cal.com API Documentation
Cal.com API Reference
Maton Community
Maton Support

上一篇：AI 智能体的时间管理与时序推理 - Openclaw Skills 下一篇：招聘计分卡：客观的候选人评估 - Openclaw Skills

Cal.com：自动化日程安排与预订 - Openclaw Skills

什么是 Cal.com 日程安排与预订？

安装与下载

1. ClawHub CLI

2. 手动安装

3. 提示词安装

Cal.com 日程安排与预订 应用场景

Cal.com 日程安排与预订 配置指南

Cal.com 日程安排与预订 数据架构与分类体系

Cal.com

Quick Start

Base URL

Authentication

Getting Your API Key

Connection Management

List Connections

Create Connection

Get Connection

Delete Connection

Specifying Connection

API Reference

User Profile

Get Profile

Update Profile

Event Types

List Event Types

Get Event Type

Create Event Type

Update Event Type

Delete Event Type

Event Type Webhooks

List Webhooks

Create Webhook

Get Webhook

Update Webhook

Delete Webhook

Bookings

List Bookings

Get Booking

Create Booking

Cancel Booking

Schedules

Get Default Schedule

Get Schedule

Create Schedule

Update Schedule

Delete Schedule

Availability Slots

Get Available Slots

Reserve Slot

Calendars

List Connected Calendars

Conferencing

List Conferencing Apps

Get Default Conferencing App

Webhooks (User-level)

List Webhooks

Create Webhook

Get Webhook

Update Webhook

Delete Webhook

Teams

List Teams

Verified Resources

List Verified Emails

Pagination

Code Examples

JavaScript

Python

Notes

Error Handling

Troubleshooting: API Key Issues

Troubleshooting: Invalid App Name

Troubleshooting: Booking Creation Fails

Resources

Cal.com 日程安排与预订应用场景

Cal.com 日程安排与预订配置指南

Cal.com 日程安排与预订数据架构与分类体系