14.17 技能集成

macOS伴侣应用macOS伴侣应用

OpenClaw macOS 应用的技能系统通过网关实现,数据来自 skills.status,通过 skills.install 安装,密钥配置存储在 ~/.openclaw/openclaw.json。

技能概述

技能(Skills)是 OpenClaw 的扩展功能模块,允许代理执行特定任务和集成外部服务。技能通过网关进行管理和调用。

技能管理

查看已安装技能

# 查看技能状态
openclaw skills status

# 查看详细技能信息
openclaw skills list --verbose

安装技能

# 安装指定技能
openclaw skills install <skill-name>

# 从 URL 安装技能
openclaw skills install <skill-url>

技能配置

技能的配置和 API 密钥存储在配置文件中:

  • 配置文件位置:~/.openclaw/openclaw.json
  • 存储内容:API 密钥、认证令牌、技能参数
  • 访问权限:仅当前用户可读写

配置示例

{
  "skills": {
    "weather": {
      "apiKey": "your-api-key",
      "defaultLocation": "Beijing"
    },
    "calendar": {
      "enabled": true,
      "syncInterval": 300
    }
  }
}

macOS 集成

macOS 应用通过以下方式与技能系统交互:

  • 网关通信:通过 WebSocket 与网关通信,调用技能方法
  • 状态同步:从 skills.status 获取技能状态
  • 安装管理:通过 skills.install 安装新技能
  • 配置管理:读写技能配置文件

常用技能

OpenClaw 社区提供了多种实用技能:

  • 系统控制:屏幕截图、应用启动、系统命令
  • 日历管理:事件创建、提醒设置
  • 通讯集成:邮件发送、消息转发
  • 智能家居:HomeKit 设备控制
  • 开发工具:代码执行、Git 操作

自定义技能

开发者可以创建自定义技能扩展 OpenClaw 功能:

  1. 遵循技能 API 规范
  2. 实现必需的接口方法
  3. 提供技能清单(manifest)
  4. 测试技能功能
  5. 打包和分发技能
技能市场
访问 awesome-openclaw-skills 查看社区贡献的技能集合。

权限要求

某些技能需要特定的 macOS 权限:

  • 辅助功能:UI 自动化、键盘控制
  • 屏幕录制:截图、屏幕共享
  • 文件访问:读写文档、下载文件
  • 通知:发送系统通知

故障排除

  • 技能无法加载:检查网关连接状态
  • API 密钥错误:验证配置文件中的凭证
  • 权限被拒:在系统设置中授予必要权限
  • 技能冲突:检查是否有多个技能使用相同的触发词