配置 ClawHub 国内镜像加速

本技能帮助你将 ClawHub CLI 默认源切换至国内镜像，解决海外服务器连接慢或超时问题，显著提升技能下载与安装速度。

适用场景

• 用户抱怨 clawhub install 或 update 速度极慢、超时失败
• 需要在新环境中初始化 ClawHub 配置
• 用户明确提到“配置镜像”、“国内源”、“registry 设置”
• 遇到网络波动导致技能市场无法访问

步骤

1. 确认镜像地址 使用官方认可的国内镜像地址 https://cn.clawhub-mirror.com，避免使用未验证的第三方源导致安全风险。

2. 配置环境变量（推荐） 将镜像地址写入 ~/.bashrc 或 ~/.zshrc，确保所有新终端会话自动生效：

   # ClawHub 国内镜像配置
   export CLAWHUB_REGISTRY=https://cn.clawhub-mirror.com
   export CLAWHUB_SITE=https://cn.clawhub-mirror.com
   

   写入后执行 source ~/.bashrc 使当前会话立即生效。

3. 验证配置有效性 执行搜索命令确认 CLI 已连接到国内节点：

   clawhub search "git"
   

   若返回结果迅速且包含常见技能（如 git-essentials），则配置成功。

4. 记录配置信息 在项目的 TOOLS.md 或环境文档中记录已配置镜像，方便后续维护或团队协作时知晓网络环境设定。

常见陷阱与解决方案

❌ 只修改了当前会话变量 → 关闭终端后配置丢失 → ✅ 写入 ~/.bashrc 并 source 仅执行 export 命令只在当前窗口有效，必须写入配置文件才能永久生效。

❌ 配置后未验证直接安装 → 可能仍走旧源导致失败 → ✅ 先执行 clawhub search 测试 搜索命令轻量且能直接反映 registry 连通性，比直接安装更安全用于验证。

❌ 混淆 Registry 与 Site 变量 → 部分功能仍访问海外 → ✅ 同时设置 CLAWHUB_REGISTRY 和 CLAWHUB_SITE 两个变量分别控制包下载和 API 请求，缺一不可。

关键代码与配置

永久环境变量配置 (~/.bashrc)

# ClawHub 国内镜像配置
export CLAWHUB_REGISTRY=https://cn.clawhub-mirror.com
export CLAWHUB_SITE=https://cn.clawhub-mirror.com

临时命令参数（仅单次生效）

clawhub install \x3Cskill-slug> --registry https://cn.clawhub-mirror.com

验证命令

clawhub search "git"
clawhub whoami

环境与前提

• CLI 版本: ClawHub CLI v0.6.1 及以上
• 操作系统: Linux / macOS (Windows 需配置系统环境变量)
• 权限: 当前用户需有 ~/.bashrc 写入权限
• 网络: 需能访问 cn.clawhub-mirror.com

任务记录

Task title: 配置 clawhub 镜像 Task summary: 📌 自我进化同步与 ClawHub 国内镜像配置

🎯 目标 完成系统经验归档同步至多 Agent 工作区，并配置 ClawHub 国内镜像地址以加速技能下载。

📋 关键步骤

• 执行自我进化与经验归档

  • 恢复 3 个定时任务（每日回顾 + AI 新闻推送），修复丢失的 cron/jobs.json 并添加 Git 跟踪。
  • 理清 3 个 Git 仓库关系（OpenClaw / Obsidian / H5 周报），禁止使用 git reset --hard。
  • 整理笔记文件夹至 ~/projects/obsidian-vault/，恢复 H5 周报项目文档（docs/ 目录 5 个需求文档）。
  • 创建学习记录文件：.learnings/2026-04-01-git-repo-separation-and-cron-restore.md。
  • 同步配置文件至 4 个 Agent 工作目录（更新 TOOLS.md/MEMORY.md/LEARNINGS.md）：
    • workspace/ (main): ✅ 7117 字节
    • workspace-echo/, workspace-code/, workspace-research/: ✅ 已同步
    • workspace-movie/: ⚠️ 871 字节（旧版未同步）

• 配置 ClawHub 国内镜像

  • 确认用户指定的国内镜像地址：https://cn.clawhub-mirror.com
  • 执行环境变量配置，写入 ~/.bashrc：

    # ClawHub 国内镜像配置
    export CLAWHUB_REGISTRY=https://cn.clawhub-mirror.com
    export CLAWHUB_SITE=https://cn.clawhub-mirror.com
    source ~/.bashrc
    

  • 更新 TOOLS.md 记录配置信息。

• 验证配置有效性

  • 执行搜索测试命令：

    clawhub search "git"
    

  • 确认返回结果包含国内加速技能：
    • ✅ git-essentials (3.784)
    • ✅ git-workflows (3.724)
    • ✅ git-helper (3.633)

✅ 结果

• 自我进化完成：7 个核心经验已归档，4 个 Agent 工作区配置已同步（movie 除外）。
• 镜像配置生效：环境变量已写入 ~/.bashrc，ClawHub CLI 搜索与安装功能测试通过，下载将走国内镜像加速。

💡 关键细节

• Git 仓库原则：提交前必须确认目录和远程仓库，禁止使用 git reset --hard。
• 配置文件路径：
  • 环境变量：~/.bashrc
  • OpenClaw 配置（备选）：~/.openclaw/openclaw.json
  • 学习记录：.learnings/2026-04-01-git-repo-separation-and-cron-restore.md
• ClawHub 版本：CLI v0.6.1
• 镜像地址：https://cn.clawhub-mirror.com（替代官方 https://clawhub.ai）
• 同步状态：main/echo/code/research 已同步最新 TOOLS.md (7117 字节)，movie 工作区仍为旧版。
• 生效方式：当前 Shell 会话需手动 source ~/.bashrc，新打开终端自动加载。

Companion files

• scripts/configure_clawhub_mirror.sh — automation script
• references/clawhub-mirror-verification.md — reference documentation