- name
- configure-clawhub-domestic-mirror
- description
- 用于配置 ClawHub 国内镜像地址以加速技能下载。当用户提到下载慢、配置镜像、设置 registry、加速安装或遇到网络超时时使用。若描述“包下载失败”、“连接海外慢”或“配置国内源”也应触发。涵盖环境变量永久配置、临时参数指定及验证方法，确保 CLI 稳定连接国内节点，解决访问延迟。
- metadata
- { "openclaw": { "emoji": "🦞" } }
配置 ClawHub 国内镜像加速
本技能帮助你将 ClawHub CLI 默认源切换至国内镜像，解决海外服务器连接慢或超时问题，显著提升技能下载与安装速度。
适用场景
- 用户抱怨
clawhub install或update速度极慢、超时失败 - 需要在新环境中初始化 ClawHub 配置
- 用户明确提到“配置镜像”、“国内源”、“registry 设置”
- 遇到网络波动导致技能市场无法访问
步骤
- 确认镜像地址
使用官方认可的国内镜像地址 https://cn.clawhub-mirror.com，避免使用未验证的第三方源导致安全风险。
- 配置环境变量（推荐）
将镜像地址写入 ~/.bashrc 或 ~/.zshrc，确保所有新终端会话自动生效：
# ClawHub 国内镜像配置
export CLAWHUB_REGISTRY=https://cn.clawhub-mirror.com
export CLAWHUB_SITE=https://cn.clawhub-mirror.com写入后执行 source ~/.bashrc 使当前会话立即生效。
- 验证配置有效性
执行搜索命令确认 CLI 已连接到国内节点：
clawhub search "git"若返回结果迅速且包含常见技能（如 git-essentials），则配置成功。
- 记录配置信息
在项目的 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 scriptreferences/clawhub-mirror-verification.md— reference documentation