Back to Details

cal-com

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Cal.com Skill

Cal.com Skill

Open-source scheduling infrastructure for everyone.
面向所有人的开源日程安排基础设施。

Quick Install

快速安装

bash
curl -sSL https://canifi.com/skills/cal-com/install.sh | bash
Or manually:
bash
cp -r skills/cal-com ~/.canifi/skills/
bash
curl -sSL https://canifi.com/skills/cal-com/install.sh | bash
或者手动安装：
bash
cp -r skills/cal-com ~/.canifi/skills/

Setup

设置

Configure via canifi-env:
bash
undefined
通过canifi-env进行配置：
bash
undefined

First, ensure canifi-env is installed:

首先，确保canifi-env已安装：

curl -sSL https://canifi.com/install.sh | bash

curl -sSL https://canifi.com/install.sh | bash

canifi-env set CALCOM_API_KEY "your_api_key"
undefined
canifi-env set CALCOM_API_KEY "your_api_key"
undefined

Privacy & Authentication

隐私与认证

Your credentials, your choice. Canifi LifeOS respects your privacy.
你的凭据，由你掌控。 Canifi LifeOS尊重你的隐私。

Option 1: Manual Browser Login (Recommended)

选项1：手动浏览器登录（推荐）

If you prefer not to share credentials with Claude Code:
  1. Complete the Browser Automation Setup using CDP mode
  2. Login to the service manually in the Playwright-controlled Chrome window
  3. Claude will use your authenticated session without ever seeing your password
如果你不想与Claude Code共享凭据：
  1. 使用CDP模式完成浏览器自动化设置
  2. 在Playwright控制的Chrome窗口中手动登录该服务
  3. Claude将使用你的已认证会话，且永远不会看到你的密码

Option 2: Environment Variables

选项2：环境变量

If you're comfortable sharing credentials, you can store them locally:
bash
canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"
Note: Credentials stored in canifi-env are only accessible locally on your machine and are never transmitted.
如果你愿意共享凭据，可以将其存储在本地：
bash
canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"
注意：存储在canifi-env中的凭据仅能在你的本地机器上访问，绝不会被传输。

Capabilities

功能特性

  1. Event Types: Create and manage meeting types
  2. Bookings: View and manage scheduled events
  3. Availability: Set working hours
  4. Team Scheduling: Round robin and collective
  5. Workflows: Automate booking actions
  1. 活动类型：创建和管理会议类型
  2. 预订管理：查看和管理已安排的活动
  3. 可用性设置：设置工作时间
  4. 团队日程安排：轮值和集体安排
  5. 工作流：自动化预订操作

Usage Examples

使用示例

Get Bookings

获取预订记录

User: "Show my Cal.com bookings"
Assistant: Returns scheduled meetings
用户："显示我的Cal.com预订记录"
助手：返回已安排的会议

Create Event Type

创建活动类型

User: "Create a 45-minute consultation event"
Assistant: Sets up event type
用户："创建一个45分钟的咨询活动"
助手：设置活动类型

Update Availability

更新可用性

User: "Set my availability to weekdays only"
Assistant: Updates schedule
用户："将我的可用时间设置为仅工作日"
助手：更新日程安排

Cancel Booking

取消预订

User: "Cancel tomorrow's meeting"
Assistant: Cancels and notifies
用户："取消明天的会议"
助手：取消并发送通知

Authentication Flow

认证流程

  1. API key authentication
  2. OAuth available
  3. Self-hosting option
  4. Webhook support
  1. API密钥认证
  2. 支持OAuth
  3. 自托管选项
  4. Webhook支持

Error Handling

错误处理

ErrorCauseSolution
Auth FailedInvalid keyCheck API key
Not FoundResource missingVerify ID
Validation ErrorBad inputCheck parameters
ConflictTime takenChoose new slot
错误原因解决方案
认证失败密钥无效检查API密钥
未找到资源缺失验证ID
验证错误输入错误检查参数
冲突时段已被占用选择新时段

Notes

注意事项

  • Open source
  • Self-hostable
  • Full API
  • Workflows
  • Team features
  • White-label option
  • 开源
  • 可自托管
  • 完整API
  • 工作流功能
  • 团队协作特性
  • 白标选项