ClawHub

Configure Clawhub Domestic Mirror

Other

用于配置 ClawHub 国内镜像地址以加速技能下载。当用户提到下载慢、配置镜像、设置 registry、加速安装或遇到网络超时时使用。若描述“包下载失败”、“连接海外慢”或“配置国内源”也应触发。涵盖环境变量永久配置、临时参数指定及验证方法，确保 CLI 稳定连接国内节点，解决访问延迟。

Install

openclaw skills install configure-clawhub-domestic-mirror

配置 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 <skill-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