Clawhub Mirror

ClawHub镜像源管理技能。智能选择最佳镜像源，优先国内镜像，需要时使用VPN访问国外源。解决国内访问速度慢的问题。

Security Scan

The skill largely matches its stated purpose (choosing and saving fast mirrors) but the instructions and packaging contain mismatches and sloppy references (missing .ps1 files, incorrect example commands) that reduce trustworthiness.

Purpose & Capability

The included Python scripts implement mirror probing, latency checks, saving config to ~/.clawhub, and creating shell/batch load scripts — which is coherent with a mirror-management skill. However SKILL.md references additional mirror URLs (e.g., cn.clawhub-mirror.com) that are not present in the Python MIRRORS list, and the README expects a setup-mirror.ps1 which is not included. These discrepancies suggest packaging/maintenance issues.

Instruction Scope

SKILL.md tells users to run PowerShell scripts (setup-mirror.ps1) and even shows commands like 'python .../setup-mirror.ps1' (invoking python on a .ps1 file) but the package only contains Python scripts (configure_mirror.py and simple_configure.py). That mismatch is a concrete inconsistency. Otherwise the instructions are limited to network checks, saving configs under the user home directory, and suggesting VPN usage — the scripts do the same and do not access unrelated system secrets. The mismatch could cause users/agents to run incorrect or non-existent files.

Install Mechanism

There is no install spec and no remote downloads. The skill is instruction- and script-based and only writes files under the user's home (~/.clawhub). No external code fetch or archive extraction is performed by the skill itself.

Credentials

The skill declares no required env vars or credentials and the code does not attempt to read unrelated secrets. It writes/reads config in ~/.clawhub and suggests setting CLAWHUB_SITE/CLAWHUB_REGISTRY environment variables — these are proportional to its purpose.

Persistence & Privilege

The skill creates files in the user's home (~/.clawhub) and generates load scripts (shell and batch). SKILL.md also recommends adding a line to the PowerShell profile to auto-load configuration. These are reasonable for a mirror helper but represent persistent changes to the user's environment; they require explicit user consent. always is false and the skill does not modify other skills or system-wide agent settings.

Scan Findings in Context

[network_request_urllib] expected: The scripts use urllib to HEAD probe mirror URLs to determine availability and latency — this is expected for mirror selection.

[subprocess_run_clawhub] expected: The scripts run a test command 'clawhub list' via subprocess to verify configuration. This is reasonable but will fail if the 'clawhub' CLI isn't installed.

[write_user_home_config] expected: The scripts write mirror-config.json, load-mirror.sh and load-mirror.bat to ~/.clawhub. Creating per-user config and load scripts is expected for this skill.

[packaging_inconsistency_ps1_missing] unexpected: SKILL.md instructs running setup-mirror.ps1 and references PowerShell .ps1 files that are not included; this is not expected and indicates a packaging/instruction mismatch.

[incorrect_command_invoking_python_on_ps1] unexpected: Examples like 'python .../setup-mirror.ps1' are incorrect (python does not execute .ps1) and point to sloppy documentation that could mislead users or agents.

What to consider before installing

This skill's code implements mirror detection and saving config, which matches the stated purpose, but the documentation contains concrete mismatches (it tells you to run setup-mirror.ps1 which is not included, and shows 'python <.ps1>' commands). Before installing or running anything: 1) don't run the PS1 commands shown in the README — they don't exist in the bundle; 2) inspect the two Python scripts yourself (they are small and readable) and confirm you are comfortable with them creating ~/.clawhub and modifying your shell/profile; 3) if you want to use it, run the included Python scripts directly (e.g., python scripts/configure_mirror.py) in a sandboxed environment first; 4) back up your shell/PowerShell profile before adding auto-load lines; 5) if the author intended PowerShell helpers, ask for the missing .ps1 files or corrected SKILL.md. These inconsistencies look like sloppy packaging rather than clear malicious intent, but treat the package cautiously.

ClawHub 镜像源管理技能

使用场景

当用户需要：

• 提高ClawHub技能安装/更新速度
• 解决国内访问国外源慢的问题
• 自动选择最佳镜像源
• 需要VPN访问时自动提示

核心功能

1. 智能镜像选择

• 自动测试多个镜像源可用性
• 优先选择国内镜像（速度快）
• 国内不可用时自动切换到国外源
• 根据网络延迟选择最佳源

2. VPN支持

• 检测是否需要VPN访问
• 提供VPN使用提示
• 支持VPN连接后自动重试

3. 配置管理

• 自动保存最佳镜像配置
• 支持会话级和持久化配置
• 提供快速加载脚本

使用方法

基本使用

# 运行智能配置
python skills/clawhub-mirror/scripts/setup-mirror.ps1

# 或直接运行PowerShell脚本
powershell -File skills/clawhub-mirror/scripts/setup-mirror.ps1

带参数使用

# 仅测试不配置
python skills/clawhub-mirror/scripts/setup-mirror.ps1 -TestOnly

# 强制使用官方源（需要VPN）
python skills/clawhub-mirror/scripts/setup-mirror.ps1 -ForceOfficial

# 标记使用VPN
python skills/clawhub-mirror/scripts/setup-mirror.ps1 -UseVPN

快速加载配置

# 加载已保存的最佳配置
. $env:USERPROFILE\.clawhub\load-mirror.ps1

镜像源策略

优先级顺序

1. 中国区官方镜像 (https://cn.clawhub-mirror.com/) - OpenClaw中国区官方镜像站，最高优先级
2. 国内镜像1 (mirror.clawhub.cn) - 备用国内源
3. 国内镜像2 (clawhub.gitee.io) - 备用国内源
4. 官方源 (clawhub.ai) - 国外官方源
5. 备用源 (clawhub.net) - 国外备用源

选择逻辑

1. 测试所有镜像源的可用性
2. 测量网络延迟（如果可能）
3. 优先选择可用的国内镜像
4. 国内不可用时选择延迟最低的国外源
5. 保存选择结果供后续使用

配置文件

位置

%USERPROFILE%\.clawhub\
├── mirror-config.json      # 镜像配置
└── load-mirror.ps1        # 快速加载脚本

配置示例

{
  "SelectedMirror": {
    "Name": "中国区官方镜像",
    "Site": "https://cn.clawhub-mirror.com",
    "Registry": "https://cn.clawhub-mirror.com",
    "Type": "china_mirror",
    "Priority": 1,
    "Description": "ClawHub 中国区镜像，持续收录和镜像加速高质量 Skill",
    "SelectedAt": "2026-04-02 21:08:00"
  },
  "AvailableMirrors": [
    {
      "Name": "中国区官方镜像",
      "Site": "https://cn.clawhub-mirror.com",
      "Registry": "https://cn.clawhub-mirror.com",
      "Type": "china_mirror",
      "Priority": 1,
      "Description": "ClawHub 中国区镜像，持续收录和镜像加速高质量 Skill",
      "Latency": 35,
      "Available": true
    }
  ]
}

VPN使用指南

何时需要VPN

1. 所有国内镜像都不可用时
2. 需要访问官方最新技能时
3. 遇到网络限制或防火墙时

VPN配置提示

当脚本检测到需要VPN时，会显示：

⚠️  需要VPN访问国外源
建议：
1. 连接您的VPN
2. 重新运行脚本：setup-mirror.ps1 -UseVPN
3. 或手动设置环境变量：
   CLAWHUB_SITE=https://clawhub.ai
   CLAWHUB_REGISTRY=https://api.clawhub.ai

无线VPN访问

如果用户可以通过无线方式访问VPN，脚本会适应这种配置。

集成到PowerShell Profile

自动加载配置

将以下内容添加到 $PROFILE 文件中：

# ClawHub 镜像源自动加载
if (Test-Path "$env:USERPROFILE\.clawhub\load-mirror.ps1") {
    . "$env:USERPROFILE\.clawhub\load-mirror.ps1"
}

创建Profile文件（如果不存在）

if (-not (Test-Path $PROFILE)) {
    New-Item -ItemType File -Path $PROFILE -Force
}
notepad $PROFILE

故障排除

常见问题

1. 所有镜像都不可用

# 检查网络连接
Test-NetConnection -ComputerName clawhub.ai -Port 443

# 尝试使用VPN后重试
setup-mirror.ps1 -UseVPN

2. 国内镜像访问慢

# 强制使用官方源（需要VPN）
setup-mirror.ps1 -ForceOfficial

3. 环境变量不生效

# 手动设置环境变量
$env:CLAWHUB_SITE = "https://clawhub.ai"
$env:CLAWHUB_REGISTRY = "https://api.clawhub.ai"

# 验证设置
echo $env:CLAWHUB_SITE
echo $env:CLAWHUB_REGISTRY

手动配置

如果自动配置失败，可以手动设置：

# 中国区官方镜像（最高优先级）
$env:CLAWHUB_SITE = "https://cn.clawhub-mirror.com"
$env:CLAWHUB_REGISTRY = "https://cn.clawhub-mirror.com"

# 国内网络（备用）
$env:CLAWHUB_SITE = "https://mirror.clawhub.cn"
$env:CLAWHUB_REGISTRY = "https://api.mirror.clawhub.cn"

# 或使用官方源（需要VPN）
$env:CLAWHUB_SITE = "https://clawhub.ai"
$env:CLAWHUB_REGISTRY = "https://api.clawhub.ai"

使用示例

示例1：首次配置

# 运行智能配置
python skills/clawhub-mirror/scripts/setup-mirror.ps1

# 输出示例：
# ✅ 选择最佳镜像源：国内镜像1 (延迟: 45ms)
# ✅ 配置完成！现在可以使用 clawhub 命令了

示例2：VPN环境配置

# 连接VPN后运行
python skills/clawhub-mirror/scripts/setup-mirror.ps1 -UseVPN

# 或强制使用官方源
python skills/clawhub-mirror/scripts/setup-mirror.ps1 -ForceOfficial

示例3：日常使用

# 新PowerShell会话中快速加载
. $env:USERPROFILE\.clawhub\load-mirror.ps1

# 安装技能（使用最佳镜像）
clawhub install data-analysis-litiao

注意事项

1. 镜像可用性：国内镜像可能不稳定，脚本会自动处理
2. VPN要求：访问国外源可能需要VPN，脚本会明确提示
3. 网络环境：不同网络环境可能需要不同配置
4. 定期更新：建议定期运行脚本更新最佳镜像选择

性能优势

• 国内镜像：延迟通常 <100ms，下载速度快
• 智能选择：自动避开不可用或慢的镜像
• 持久化配置：一次配置，多次使用
• VPN友好：明确提示VPN需求，避免混淆

通过使用此技能，您可以显著提高ClawHub技能安装和更新的速度，特别是在国内网络环境下。