Install
openclaw skills install @thcjp/assistantopenclaw skills install @thcjp/assistant核心功能: 本技能提供、习惯养成、化工作流与智能决策辅助等能力。
| 能力 | 免费版 | 付费版 |
|---|---|---|
| 基础功能 | 支持 | 支持 |
| Assistant主动有序管理 | 不支持 | 支持 |
| 复杂工作流可视化编排 | 不支持 | 支持 |
| 条件分支与异常重试 | 不支持 | 支持 |
| 定时触发与事件驱动 | 不支持 | 支持 |
| 执行日志与审计追踪 | 不支持 | 支持 |
详细的输入输出格式请参考下方章节说明。
| 场景 | 输入 | 输出 |
|---|---|---|
| 任务管理 | 任务描述和截止日期 | 结构化任务清单和优先级排序 |
| 日程安排 | 会议或事件信息 | 日历事件和时间冲突检测 |
| 沟通协调 | 消息内容和收件人 | 草拟消息和发送确认 |
不适用于:需要专业领域知识的深度分析和决策场景
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| task_filter | string | 否 | 任务过滤条件, 可选: today/week/all, 默认: all |
| priority | string | 否 | 优先级排序方式, 可选: high/medium/low, 默认: medium |
{
"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应妥善保管,避免泄露到版本控制系统.
A: 请参考使用流程和依赖说明章节,确保运行环境满足要求后调用本技能。
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| LLM响应超时或无响应 | 网络延迟或模型负载过高 | 请求重试;确认Agent平台LLM服务正常 |
| 输入内容格式不正确 | 用户输入不符合skill预期格式 | 检查输入是否符合skill使用说明中的格式要求,参考示例章节 |
| 执行结果与预期不符 | 指令描述不够明确或上下文不足 | 提供更详细的指令描述,补充必要的上下文信息 |
| 命令执行失败 | 运行环境不满足要求或权限不足 | 确认运行环境符合依赖说明中的要求;检查命令权限设置 |
| 操作步骤 | 手动耗时 | 自动化耗时 | 时间节约 | 准确率提升 |
|---|---|---|---|---|
| 任务创建 | 10分钟 | 1分钟 | 9分钟 | 5% |
| 日程安排 | 15分钟 | 3分钟 | 12分钟 | 10% |
| 消息发送 | 5分钟 | 1分钟 | 4分钟 | 3% |
| 文件管理 | 20分钟 | 5分钟 | 15分钟 | 7% |
| 数据分析 | 1小时 | 10分钟 | 50分钟 | 20% |
| 对比维度 | 本技能 | 手动操作 | Python脚本 | 专业软件 |
|---|---|---|---|---|
| 易用性 | 高 | 低 | 中 | 高 |
| 功能丰富度 | 高 | 低 | 中 | 高 |
| 成本 | 低 | 高 | 中 | 高 |
| 学习曲线 | 低 | 高 | 中 | 高 |
| 扩展性 | 高 | 低 | 中 | 高 |
| 痛点 | 描述 | 影响范围 | 解决方案 | 量化效果 |
|---|---|---|---|---|
| 任务遗漏 | 容易忘记重要任务 | 影响工作效率和目标达成 | 自动提醒和任务管理功能 | 任务完成率提升10% |
| 时间管理 | 难以合理分配时间 | 影响工作和生活平衡 | 日程安排和优先级排序功能 | 时间利用率提升15% |
| 沟通协调 | 沟通效率低 | 影响团队协作和项目进度 | 消息发送和事件提醒功能 | 沟通效率提升20% |
A: 在任务管理模块中,您可以设置任务的提醒时间,系统会在指定时间前提醒您。
A: 在日程安排模块中,您可以查看所有已添加的事件和会议,包括时间冲突的检测。
A: 在沟通协调模块中,您可以输入消息内容和收件人信息,系统会自动草拟并发送消息。
A: 在助手设置中,您可以导入您的联系人信息,以便在发送消息时快速选择收件人。
A: 在助手设置中,您可以查看助手的使用记录,包括操作日志和执行结果。
| 错误现象 | 可能原因 | 诊断步骤 | 解决方案 |
|---|---|---|---|
| 无法登录 | 用户名或密码错误 | 检查用户名和密码是否正确 | 重新输入正确的用户名和密码 |
| 任务无法创建 | 权限不足 | 检查用户权限 | 联系管理员获取相应权限 |
| 消息发送失败 | 网络连接问题 | 检查网络连接 | 重启网络连接或联系网络服务提供商 |
| 日程冲突 | 重复添加事件 | 检查日程安排 | 删除重复事件或调整时间 |
| 执行结果异常 | 输入参数错误 | 检查输入参数 | 重新输入正确的参数 |
| 风险项 | 等级 | 防护措施 | 验证方法 |
|---|---|---|---|
| API密钥泄露 | 高 | 通过环境变量配置,禁止硬编码 | 定期检查代码和配置文件 |
| 命令执行风险 | 高 | 仅执行白名单命令,避免拼接用户输入 | 使用沙箱环境测试 |
| 网络通信安全 | 中 | 使用HTTPS协议,验证SSL证书 | 定期检查证书有效期 |
| 敏感数据暴露 | 高 | 输出结果中不包含密钥、令牌等敏感信息 | 日志脱敏审查 |
| 未授权访问 | 中 | 限制访问权限,实施认证机制 | 定期审计访问日志 |
针对助手使用中可能遇到的常见问题,提供以下排查方案:
| 错误类型 | 原因分析 | 解决方案 |
|---|---|---|
| API认证失败(401) | API密钥错误或过期 | 检查密钥配置,重新生成token |
| 接口限流(429) | 请求频率超出限制 | 降低调用频率,启用重试退避策略 |
| 响应超时(504) | 网络延迟或服务端负载过高 | 增加超时阈值,检查网络连接 |
| 文件不存在 | 路径错误或文件未创建 | 检查路径拼写,确认文件已生成 |
| 文件格式不支持 | 扩展名不在支持列表中 | 转换为支持的格式后重试 |
| 权限不足 | 当前用户无读写权限 | 检查文件权限,以管理员身份运行 |
| 命令执行失败 | 参数错误或环境依赖缺失 | 检查命令语法,确认依赖已安装 |
| 进程超时 | 命令执行时间过长 | 增加超时设置,优化命令参数 |
| 网络连接失败 | DNS解析失败或防火墙拦截 | 检查网络配置,确认代理设置 |