Remote Skill Installer

远程安装、管理和更新技能到指定Agent，支持批量导入、网络异常重试及安全校验防护。

SKILL.md - 远程技能安装助手

身份定位

你是一位远程技能安装专家，擅长：

• 从 URL 安装 Skills 到指定 Agent 工作区
• 管理远程 Skills（查看、更新、移除）
• 从官方 Skills Hub 批量导入
• 处理网络异常（重试、代理切换）

---

核心命令

1. 安装远程 Skill

bash

python3 remote_skill_installer.py add \\
  --agent <agent_id> \\
  --name <skill_name> \\
  --source <url>

示例：

bash

# 从 GitHub 安装 code_review skill
python3 remote_skill_installer.py add \\
  --agent bingbu \\
  --name code_review \\
  --source https://raw.githubusercontent.com/org/skills/main/code_review/SKILL.md

# 从自定义 URL 安装
python3 remote_skill_installer.py add \\
  --agent menxia \\
  --name my_skill \\
  --source https://example.com/skills/my_skill/SKILL.md

参数说明：

参数	必填	说明
--agent	✅	目标 Agent ID（如 bingbu, menxia, shangshu）
--name	✅	Skill 内部名称（字母/数字/下划线/中文）
--source	✅	SKILL.md 的远程 URL
--desc	❌	Skill 描述信息

---

2. 查看已安装的远程 Skills

bash

python3 remote_skill_installer.py list

示例输出：

text

📋 共 3 个远程 skills：

Agent      | Skill 名称          | 描述                           | 添加时间
----------------------------------------------------------------------------------------------------
bingbu     | code_review         | 代码审查技能                    | 2026-03-24
menxia     | api_design         | API 设计指南                    | 2026-03-24
hubu       | data_analysis      | 数据分析工具                    | 2026-03-23

---

3. 更新远程 Skill

bash

python3 remote_skill_installer.py update \\
  --agent <agent_id> \\
  --name <skill_name>

示例：

bash

# 更新 code_review skill 到最新版本
python3 remote_skill_installer.py update \\
  --agent bingbu \\
  --name code_review

---

4. 移除远程 Skill

bash

python3 remote_skill_installer.py remove \\
  --agent <agent_id> \\
  --name <skill_name>

---

5. 批量导入官方 Skills

bash

python3 remote_skill_installer.py import \\
  --agents <agent1>,<agent2>

示例：

bash

# 导入所有官方 skills 到指定 agents
python3 remote_skill_installer.py import \\
  --agents bingbu,menxia,shangshu

# 自动选择推荐的 agents
python3 remote_skill_installer.py import

---

网络问题排查

问题：下载失败 "Connection timeout"

解决方案：

bash

# 方法1：设置代理
export https_proxy=http://your-proxy:port

# 方法2：使用镜像
export OPENCLAW_SKILLS_HUB_BASE=https://ghproxy.com/https://raw.githubusercontent.com/openclaw-ai/skills-hub/main

# 方法3：自定义 Hub 地址
echo "https://your-mirror/skills" > ~/.openclaw/skills-hub-url

问题：下载失败 "HTTP 404"

原因： Skill 尚未发布或 URL 不正确

解决方案：

bash

# 检查 URL 是否正确
curl -I https://raw.githubusercontent.com/org/skills/main/SKILL.md

# 使用官方 Skills Hub
python3 remote_skill_installer.py import --agents menxia

---

工作原理

目录结构

text

~/.openclaw/
└── workspace-<agent_id>/
    └── skills/
        └── <skill_name>/
            ├── SKILL.md          # 技能文件
            └── .source.json      # 源信息（URL、校验和等）

安全特性

• 字符校验：safe_name() 检查 agent_id 和 skill 名称只含安全字符
• SSRF 防护：validate_url() 禁止内网地址（127.x, 10.x, 192.168.x）
• 下载限制：单文件最多 10MB
• 校验和：SHA256 校验确保文件完整性
• XXE 防护：RSS 解析时禁用外部实体

自动重试

• 网络超时：3s → 6s 指数退避
• HTTP 4xx：错误立即终止（不再重试）
• 自动切换镜像：主 URL 失败后尝试 GitHub 镜像

---

官方 Skills Hub

Skill	说明
code_review	代码审查：自动扫描常见漏洞、代码规范问题
api_design	API 设计：RESTful 规范、接口文档、版本管理
security_audit	安全审计：SQL注入、XSS、CSRF 等常见威胁检测
data_analysis	数据分析：数据清洗、统计建模、可视化报表
doc_generation	文档生成：自动生成技术文档、API 文档、README
test_framework	测试框架：单元测试、集成测试、自动化测试用例

💡 使用 import 命令可一键安装所有官方 Skills

---

更新日志

• v1.0.0（2026-03-24）：首发版本，支持远程安装/更新/移除/批量导入