openclaw-bridge

Files (5)

• .gitignore
• LICENSE
• README.md
• SKILL.md
• SKILLS_CATALOG.md · docs/

SKILL.md (first lines)

# OpenClaw Bridge Skill

将 OpenClaw 技能库桥接到 Claude Code 工作流中。自动扫描、索引、安全检查、调用 OpenClaw 技能。

## 核心职责

1. **发现** OpenClaw 技能目录（首次运行时询问或自动扫描）
2. **索引** 构建可搜索的技能元数据缓存
3. **检查** 首次调用技能时进行安全性审查
4. **匹配** 当前任务与可用技能
5. **加载** 匹配到的技能的完整 SKILL.md 并遵循其指令

---

## 配置

### 首次运行：技能目录发现

首次加载此技能时，按以下流程发现 OpenClaw 技能目录：

1. **检查缓存** — 查看项目 memory 中是否已有 `openclaw_skills_dir` 配置
2. **询问用户** — 如果没有缓存，询问:
   > 检测到 OpenClaw Bridge 首次运行。请告知你的 OpenClaw 技能目录路径。
   > 例如: `D:\Personal\OpenClaw\skills\` 或 `~/.openClaw/skills/`
3. **自动扫描** — 如果用户不确定，扫描以下常见位置:
   - `D:\Personal\OpenClaw\skills\`
   - `C:\Users\<user>\.openClaw\skills\`
   - `<用户主目录>\OpenClaw\skills\`
   - 当前项目目录下的 `skills/` 或 `openclaw/skills/` 子目录
4. **保存配置** — 找到的路径保存到项目 memory，后续会话直接使用

### 缓存文件结构

技能索引缓存保存在项目 memory 文件中（文件名: `openclaw_cache.md`），
**仅存储元数据，不存储完整 SKILL.md 内容**:

```markdown
---
name: openclaw cache
description: OpenClaw 技能索引缓存（元数据）
type: project
---

目录: <自动发现的路径>
最后扫描: <日期>
技能总数: <N>

## 索引
| slug | name | description | 关键词 | 安全等级 |
|------|------|-------------|--------|---------|
| search | 网络搜索统一入口 | 整合搜索... | 搜索,文献,学术 | 🟡 |
...

## 已调用记录
| 技能 | 首次调用时间 | 安全性检查 | 文件hash |
|------|-------------|-----------|---------|
| fortune-teller | 2026-04-12 | ✅ 通过 | abc123 |
```

---

## 工作流程

```
SESSION START
     │
     ├── 检查缓存: OpenClaw 技能目录路径是否存在？
     │     ├── 是 → 使用缓存路径
     │     └── 否 → 询问用户 → 自动扫描 → 保存路径
     │
     ├── 读取 SKILLS_INDEX.md 或遍历技能目录
     │
     └── 构建/更新索引缓存（仅元数据）


TASK RECEIVED
     │
     ├── 分析任务意图
     │     ├── 直接匹配 → 技能名称/功能匹配
     │     ├── 语义匹配 → 描述关键词匹配
     │     └── 领域匹配 → 项目上下文推断
     │
     ├── 匹配到技能？
     │     ├── 是 → 检查是否首次调用
     │     │     ├── 是 → 执行安全性检查（见下方）
     │     │     └── 否 → 检查技能文件是否被修改（hash 对比）
     │     │           ├── 是 → 重新执行安全性检查
     │     │           └── 否 → 直接加载
     │     └── 否 → 使用 Claude Code 内置工具完成
     │
     └── 加载 SKILL.md 并遵循其指令
```

---

## 安全性检查流程

首次调用某个 OpenClaw 技能时，必须执行安全检查：

### 扫描风险项

| 风险类型 | 检测方式 | 说明 |
|---------|---------|------|
| 🔴 可执行脚本 | 检查是否有 `scripts/` 目录或 `.sh/.ps1/.bat/.py` 文件 | 可能执行未审查代码 |
| 🔴 系统修改 | 检查 SKILL.md 是否有修改系统配置/环境变量的指令 | 可能破坏用户环境 |
| 🟡 API 依赖 | 检查是否提到 API key/token/密码 | 需要用户提供外部凭据 |
| 🟡 网络请求 | 检查是否包含 HTTP 请求/curl/网页访问指令 | 可能泄露数据 |
| 🟡 外部 URL | 检查是否包含需要访问的外部链接 | 可能有钓鱼风险 |
| 🟡 第三方服务 | 检查是否依赖外部平台（飞书、邮件等） | 需要额外配置 |
| 🟢 纯指令 | 仅包含 AI 行为指导，无可执行内容 | 安全 |

### 检查报告格式

向用户报告检查结果:

```
[OpenClaw 安全检查: fortune-teller]
🟢 风险等级: 安全
📋 检查结果:

From JIRBOY/openclaw-bridge-skills, MIT.

More from JIRBOY/openclaw-bridge-skills