Install
openclaw skills install @thcjp/calendaropenclaw skills install @thcjp/calendar核心功能: 本技能提供中文交互等能力。
核心功能: 本技能提供化工作流场景等能力。
| 能力 | 免费版 | 付费版 |
|---|---|---|
| 基础功能 | 支持 | 支持 |
| Calendar日历管理 | 不支持 | 支持 |
| 跨平台任务同步 | 不支持 | 支持 |
| 智能优先级排序 | 不支持 | 支持 |
| 团队协作与权限管理 | 不支持 | 支持 |
| 自动化提醒与跟进 | 不支持 | 支持 |
详细的输入输出格式请参考下方章节说明。
| 场景 | 输入 | 输出 |
|---|---|---|
| 事件创建 | 事件标题、时间和参与者 | 日历事件和邀请通知 |
| 日程同步 | 多平台日历账户 | 同步后的统一日程视图 |
| 会议管理 | 会议时间和议程 | 会议安排和冲突检测 |
不适用于:需要复杂排班算法的企业级考勤管理
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| event_name | string | 是 | 日历事件名称 |
| calendar_provider | string | 否 | 日历平台, 可选: google/outlook/exchange, 默认: google |
{
"success": true,
"data": {
"overall_grade": "A",
"total_score": 92,
"max_score": 100,
"summary": "处理完成",
"details": [
{
"item": "代码风格",
"status": "pass",
"score": 95,
"comment": "符合规范"
},
{
"item": "安全合规",
"status": "warn",
"score": 80,
"comment": "符合规范"
}
],
"improvements": [
{
"priority": "high",
"suggestion": "建议优化",
"expected_gain": "+5分"
},
{
"priority": "medium",
"suggestion": "建议优化",
"expected_gain": "+3分"
}
]
},
"error": null
}
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| LLM API | API | 必需 | 由Agent内置LLM提供 |
API Key配置方式:
export API_KEY="${API_KEY:?请设置环境变量}"
配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.
"Schedule meeting tomorrow at 2pm"
"Show my calendar for this week"
"Find free time for a 1-hour meeting"
A: 请参考使用流程和依赖说明章节,确保运行环境满足要求后调用本技能。
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| LLM响应超时或无响应 | 网络延迟或模型负载过高 | 请求重试;确认Agent平台LLM服务正常 |
| 输入内容格式不正确 | 用户输入不符合skill预期格式 | 检查输入是否符合skill使用说明中的格式要求,参考示例章节 |
| 执行结果与预期不符 | 指令描述不够明确或上下文不足 | 提供更详细的指令描述,补充必要的上下文信息 |
| 命令执行失败 | 运行环境不满足要求或权限不足 | 确认运行环境符合依赖说明中的要求;检查命令权限设置 |
| 操作步骤 | 手动耗时 | 自动化耗时 | 时间节约 | 准确率提升 |
|---|---|---|---|---|
| 日程创建 | 15分钟 | 3分钟 | 12分钟 | 20% |
| 重复事件设置 | 10分钟 | 2分钟 | 8分钟 | 15% |
| 事件提醒设置 | 8分钟 | 1分钟 | 7分钟 | 25% |
| 事件搜索 | 20分钟 | 5分钟 | 15分钟 | 30% |
| 日历同步 | 30分钟 | 10分钟 | 20分钟 | 40% |
| 对比维度 | 本技能 | 手动操作 | Python脚本 | 专业软件 |
|---|---|---|---|---|
| 用户界面 | 直观易用,个性化定制 | 操作复杂,界面不友好 | 界面简洁,功能单一 | 界面复杂,学习曲线陡峭 |
| 功能丰富度 | 日程管理、提醒、同步 | 功能单一,易出错 | 功能丰富,但需编程基础 | 功能全面,但操作复杂 |
| 系统兼容性 | 全面兼容 | 兼容性差 | 兼容性较好,但需额外配置 | 兼容性佳,但需额外费用 |
| 成本 | 免费使用 | 无额外成本 | 需编写脚本,有一定成本 | 购买软件,成本较高 |
| 学习成本 | 低 | 高 | 中等 | 高 |
| 痛点 | 描述 | 影响范围 | 解决方案 | 量化效果 |
|---|---|---|---|---|
| 手动操作繁琐 | 每次创建或修改日程需要手动操作,效率低下 | 影响个人或团队的工作效率 | 自动化操作,简化流程 | 时间节约20% |
| 事件提醒不及时 | 难以记住所有事件,导致错过重要日期 | 影响工作和生活安排 | 自动提醒功能,提高提醒准确率 | 准确率提升25% |
| 日历同步困难 | 不同设备间日历同步困难,数据不一致 | 影响工作和生活安排 | 自动同步功能,确保数据一致性 | 数据一致性提高40% |
| 边界场景 | 触发条件 | 处理方式 | 预期结果 |
|---|---|---|---|
| 用户未输入日期 | 用户未提供日期信息 | 提示用户输入日期 | 用户输入有效日期后继续操作 |
| 日期格式错误 | 用户输入的日期格式不符合规范 | 提示用户正确的日期格式 | 用户重新输入正确格式的日期 |
| 日期范围超出范围 | 用户输入的日期超出系统支持的范围 | 提示用户日期范围 | 用户输入系统支持的日期范围 |
| 单日重复查询 | 用户连续查询同一天的信息 | 忽略重复查询 | 系统返回最后一次查询结果 |
| 空日历数据 | 用户请求的日期没有数据 | 返回空数据提示 | 用户了解该日期无数据 |
| 错误码 | 原因 | 处理方式 | 恢复策略 |
|---|---|---|---|
| 1001 | 网络连接失败 | 尝试重新连接网络 | 如果失败,提示用户检查网络连接并稍后重试 |
| 1002 | 数据库连接失败 | 尝试重新连接数据库 | 如果失败,提示用户系统错误,请联系管理员 |
| 1003 | 日期查询错误 | 检查日期输入是否正确 | 提示用户输入正确的日期,并重新查询 |
| 1004 | 权限不足 | 检查用户权限 | 如果权限不足,提示用户无权限访问,并引导至权限设置 |
| 1005 | 系统异常 | 记录错误日志 | 提示用户系统异常,稍后重试,并记录错误信息以便后续分析 |
| 错误现象 | 可能原因 | 诊断步骤 | 解决方案 |
|---|---|---|---|
| 日历无法打开 | 系统权限设置不正确 | 1. 检查设备权限设置,确保日历应用有足够的权限。 2. 重启设备,尝试重新打开日历应用。 | 1. 重新设置权限,确保日历应用可以访问设备资源。 2. 如果问题依旧,尝试卸载并重新安装日历应用。 |
| 日历事件无法添加 | 日历账户未同步 | 1. 检查日历账户是否已成功添加到应用中。 2. 检查网络连接是否稳定,尝试重新同步账户。 | 1. 确保账户信息正确无误,重新添加账户。 2. 如果网络问题,确保网络连接正常后,尝试再次同步。 |
| 日历事件提醒未到时间已推送 | 系统时间设置错误 | 1. 检查设备系统时间是否正确设置。 2. 确认日历事件的时间设置是否与系统时间一致。 | 1. 调整系统时间至正确的时间。 2. 如果事件时间设置正确,检查日历应用是否正确设置了提醒时间。 |
| 日历应用卡顿或崩溃 | 应用缓存过多 | 1. 清除日历应用的缓存数据。 2. 检查设备存储空间是否充足。 | 1. 进入应用设置,清除缓存,然后重启应用。 2. 如果存储空间不足,清理设备中的其他文件,释放存储空间。 |
| 日历同步失败 | 日历服务不可用 | 1. 检查日历服务提供商的服务状态。 2. 确认日历账户信息无误。 | 1. 查看服务提供商的官方网站或客服信息,了解服务状态。 2. 如果账户信息有误,修改账户信息后重新尝试同步。 |
| 风险项 | 等级 | 防护措施 | 验证方法 |
|---|---|---|---|
| 个人信息泄露 | 高 | 对存储在日历中的个人信息进行加密处理,限制访问权限 | 定期检查信息加密状态,确保加密设置有效 |
| 设备被非法访问 | 中 | 开启设备安全锁,设置复杂的解锁密码 | 通过设备安全锁验证功能是否正常 |
| 数据同步风险 | 中 | 使用加密传输协议进行数据同步 | 检查数据同步过程中的加密验证日志 |
| 恶意软件入侵 | 高 | 定期更新操作系统和应用,安装杀毒软件 | 通过杀毒软件扫描结果和系统更新日志进行验证 |
| 权限不当使用 | 中 | 定期审查应用权限,撤销不必要的权限 | 通过应用权限设置界面检查权限使用情况 |
A: 创建新事件时,您需要提供事件名称、时间以及可选的参与者信息。通过调用技能并输入这些参数,系统将为您在指定的日历中创建一个新事件。
A: 您可以通过选择相应的日历平台(如Google、Outlook或Exchange)并输入相应的账户信息,实现跨平台日历的同步。付费版用户将享受更便捷的同步功能。
A: 在创建或编辑事件时,您可以设置事件的优先级。智能优先级排序功能将帮助您更好地管理事件,确保重要事件得到优先处理。
A: 当您尝试创建或修改一个可能与其他事件冲突的会议时,系统将自动检测并提示您冲突情况,帮助您调整会议时间。
A: 您可以通过调用技能并指定查看的时间范围(如本周、本月等),系统将为您展示相应的日程安排,包括所有事件和会议。
例如,您可以输入“创建事件:会议名称,时间:2023-12-01 14:00,参与者:张三、李四”。
A: 您可以通过输入“查看我的日程”或指定日期范围,如“查看2023年12月的日程”,来查看您的日程安排。
A: 您需要选择要同步的日历平台(如Google、Outlook等),并确保已配置相应的账户信息。然后,输入“同步日历:平台名称”即可。
A: 当您尝试创建或修改会议时,系统会自动检测时间冲突。如果存在冲突,系统会提示您选择不同的时间或调整会议安排。
A: 在创建或修改事件时,您可以设置提醒时间。例如,输入“创建事件:会议名称,时间:2023-12-01 14:00,提醒:30分钟前”,系统将在会议开始前30分钟发送提醒。
针对日历使用中可能遇到的常见问题,提供以下排查方案:
| 错误类型 | 原因分析 | 解决方案 |
|---|---|---|
| API认证失败(401) | API密钥错误或过期 | 检查密钥配置,重新生成token |
| 接口限流(429) | 请求频率超出限制 | 降低调用频率,启用重试退避策略 |
| 响应超时(504) | 网络延迟或服务端负载过高 | 增加超时阈值,检查网络连接 |
| 文件不存在 | 路径错误或文件未创建 | 检查路径拼写,确认文件已生成 |
| 文件格式不支持 | 扩展名不在支持列表中 | 转换为支持的格式后重试 |
| 权限不足 | 当前用户无读写权限 | 检查文件权限,以管理员身份运行 |
| 命令执行失败 | 参数错误或环境依赖缺失 | 检查命令语法,确认依赖已安装 |
| 进程超时 | 命令执行时间过长 | 增加超时设置,优化命令参数 |
| 网络连接失败 | DNS解析失败或防火墙拦截 | 检查网络配置,确认代理设置 |
针对日历使用中可能遇到的常见问题,提供以下排查方案:
| 错误类型 | 原因分析 | 解决方案 |
|---|---|---|
| API认证失败(401) | API密钥错误或过期 | 检查密钥配置,重新生成token |
| 接口限流(429) | 请求频率超出限制 | 降低调用频率,启用重试退避策略 |
| 响应超时(504) | 网络延迟或服务端负载过高 | 增加超时阈值,检查网络连接 |
| 文件不存在 | 路径错误或文件未创建 | 检查路径拼写,确认文件已生成 |
| 文件格式不支持 | 扩展名不在支持列表中 | 转换为支持的格式后重试 |
| 权限不足 | 当前用户无读写权限 | 检查文件权限,以管理员身份运行 |
| 命令执行失败 | 参数错误或环境依赖缺失 | 检查命令语法,确认依赖已安装 |
| 进程超时 | 命令执行时间过长 | 增加超时设置,优化命令参数 |
| 网络连接失败 | DNS解析失败或防火墙拦截 | 检查网络配置,确认代理设置 |