{
  "schemaVersion": "1.0",
  "item": {
    "slug": "common-installation-troubleshooting",
    "name": "OpenClaw 插件安装常见问题排查",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/dawai2005/common-installation-troubleshooting",
    "canonicalUrl": "https://clawhub.ai/dawai2005/common-installation-troubleshooting",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/common-installation-troubleshooting",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=common-installation-troubleshooting",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/common-installation-troubleshooting"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/common-installation-troubleshooting",
    "agentPageUrl": "https://openagent3.xyz/skills/common-installation-troubleshooting/agent",
    "manifestUrl": "https://openagent3.xyz/skills/common-installation-troubleshooting/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/common-installation-troubleshooting/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Skill: OpenClaw 插件安装常见问题排查",
        "body": "用于解决 OpenClaw 插件安装中遇到的常见问题。"
      },
      {
        "title": "1. Tavily Search 安装问题",
        "body": "问题现象：\n\nnpm error code E404\nnpm error 404 Not Found - GET https://registry.npmjs.org/tavily-search\nnpm error 404 The requested resource 'tavily-search@*' could not be found\n\n原因：\n包名错误，正确的包名是 tavily-mcp（用于 MCP 服务器）\n\n解决方案：\n\n# 正确的安装命令\nnpm install -g tavily-mcp"
      },
      {
        "title": "2. Find-Skills 安装问题",
        "body": "问题现象：\n\nnpm error code E404\nnpm error 404 Not Found - GET https://registry.npmjs.org/find-skills\n\n原因：\nfind-skills 不是 npm registry 中的标准包名，可能使用不同的名称\n\n解决方案：\n\n使用 npm search find-skills 搜索是否存在\n检查是否需要 GitHub 仓库克隆\n验证包的实际名称"
      },
      {
        "title": "3. Proactive-Agent-1-2-4 安装问题",
        "body": "问题现象：\n\nnpm error code E404\nnpm error 404 Not Found - GET https://registry.npmjs.org/proactive-agent-1-2-4\n\n原因：\nproactive-agent-1-2-4 不是 npm 包名\n\n解决方案：\n\n确认正确的包名或获取方式\n可能需要从 GitHub 仓库安装\n使用 npm search 查找可用版本"
      },
      {
        "title": "4. Imap-Smtp-Email 安装问题",
        "body": "问题现象：\n安装时找不到对应包\n\n原因：\n包名描述性太强，可能不是 npm 包名\n\n解决方案：\n\n咨询用户提供正确的包名\n使用 web search 搜索具体插件（如 imap-smtp npm）\n验证是否需要其他安装方式"
      },
      {
        "title": "5. ClawHub CLI 安装问题",
        "body": "问题现象：\nWindows 权限错误，无法完全删除旧文件\n\n原因：\nWindows 系统文件操作限制，临时文件占用\n\n解决方案：\n\n# 强制覆盖安装\nnpm i -g clawhub --force\n\n验证安装：\nWindows 下使用 clawhub --cli-version\n或直接使用帮助命令查看版本：\n\nnpm run -g clawhub -- --help"
      },
      {
        "title": "步骤 1：搜索包名",
        "body": "npm search \"关键词\""
      },
      {
        "title": "步骤 2：检查官方网站/文档",
        "body": "如果是特定插件，访问其官方网站或 GitHub 查看：\n\nREADME 文件\n安装说明\n依赖要求"
      },
      {
        "title": "步骤 3：使用 Web Search",
        "body": "使用内置的 web_search 工具搜索：\n\n\"插件名 npm\" 或 \"插件名 github\""
      },
      {
        "title": "步骤 4：检查包的权限",
        "body": "npm view 插件名"
      },
      {
        "title": "步骤 5：尝试不同安装方式",
        "body": "全局安装：npm install -g 插件名\n本地安装：npm install 插件名\n使用 --force 覆盖：npm install -g 插件名 --force"
      },
      {
        "title": "📝 经验总结",
        "body": "包名很重要：很多插件在 npm 上的名称与用户记忆的不同\n使用搜索工具：遇到困惑时先搜索，不要瞎猜\n查看文档：不要只依赖包名，查看官方文档的安装说明\n权限问题：Windows 安装全局包时可能会遇到 EPERM 错误，使用 --force\n验证安装：安装后立即验证版本和功能"
      },
      {
        "title": "🎯 最佳实践",
        "body": "安装前检查：确认插件是否在 npm 注册表有对应的包\n查看 README：从官方仓库获取准确的安装命令\n\nGitHub README 通常包含完整的安装指南\n注意不同的安装方式（npm/pip/git）\n\n\n使用 --save-dev / -D：开发环境使用，生产环境考虑 --save 或 -S\n验证版本：安装后立即测试，确保功能正常"
      },
      {
        "title": "📚 相关资源",
        "body": "ClawHub 文档：https://docs.openclaw.ai/tools/clawhub\nnpm Registry: https://www.npmjs.com/\nClawHub 网站: https://clawhub.ai\n\nLast updated: 2026-02-10"
      }
    ],
    "body": "Skill: OpenClaw 插件安装常见问题排查\n\n用于解决 OpenClaw 插件安装中遇到的常见问题。\n\n问题分类\n1. Tavily Search 安装问题\n\n问题现象：\n\nnpm error code E404\nnpm error 404 Not Found - GET https://registry.npmjs.org/tavily-search\nnpm error 404 The requested resource 'tavily-search@*' could not be found\n\n\n原因： 包名错误，正确的包名是 tavily-mcp（用于 MCP 服务器）\n\n解决方案：\n\n# 正确的安装命令\nnpm install -g tavily-mcp\n\n2. Find-Skills 安装问题\n\n问题现象：\n\nnpm error code E404\nnpm error 404 Not Found - GET https://registry.npmjs.org/find-skills\n\n\n原因： find-skills 不是 npm registry 中的标准包名，可能使用不同的名称\n\n解决方案：\n\n使用 npm search find-skills 搜索是否存在\n检查是否需要 GitHub 仓库克隆\n验证包的实际名称\n3. Proactive-Agent-1-2-4 安装问题\n\n问题现象：\n\nnpm error code E404\nnpm error 404 Not Found - GET https://registry.npmjs.org/proactive-agent-1-2-4\n\n\n原因： proactive-agent-1-2-4 不是 npm 包名\n\n解决方案：\n\n确认正确的包名或获取方式\n可能需要从 GitHub 仓库安装\n使用 npm search 查找可用版本\n4. Imap-Smtp-Email 安装问题\n\n问题现象： 安装时找不到对应包\n\n原因： 包名描述性太强，可能不是 npm 包名\n\n解决方案：\n\n咨询用户提供正确的包名\n使用 web search 搜索具体插件（如 imap-smtp npm）\n验证是否需要其他安装方式\n5. ClawHub CLI 安装问题\n\n问题现象： Windows 权限错误，无法完全删除旧文件\n\n原因： Windows 系统文件操作限制，临时文件占用\n\n解决方案：\n\n# 强制覆盖安装\nnpm i -g clawhub --force\n\n\n验证安装： Windows 下使用 clawhub --cli-version 或直接使用帮助命令查看版本：\n\nnpm run -g clawhub -- --help\n\n🔍 通用排查步骤\n步骤 1：搜索包名\nnpm search \"关键词\"\n\n步骤 2：检查官方网站/文档\n\n如果是特定插件，访问其官方网站或 GitHub 查看：\n\nREADME 文件\n安装说明\n依赖要求\n步骤 3：使用 Web Search\n\n使用内置的 web_search 工具搜索：\n\n\"插件名 npm\" 或 \"插件名 github\"\n\n步骤 4：检查包的权限\nnpm view 插件名\n\n步骤 5：尝试不同安装方式\n全局安装：npm install -g 插件名\n本地安装：npm install 插件名\n使用 --force 覆盖：npm install -g 插件名 --force\n📝 经验总结\n包名很重要：很多插件在 npm 上的名称与用户记忆的不同\n使用搜索工具：遇到困惑时先搜索，不要瞎猜\n查看文档：不要只依赖包名，查看官方文档的安装说明\n权限问题：Windows 安装全局包时可能会遇到 EPERM 错误，使用 --force\n验证安装：安装后立即验证版本和功能\n🎯 最佳实践\n安装前检查：确认插件是否在 npm 注册表有对应的包\n查看 README：从官方仓库获取准确的安装命令\nGitHub README 通常包含完整的安装指南\n注意不同的安装方式（npm/pip/git）\n使用 --save-dev / -D：开发环境使用，生产环境考虑 --save 或 -S\n验证版本：安装后立即测试，确保功能正常\n📚 相关资源\nClawHub 文档：https://docs.openclaw.ai/tools/clawhub\nnpm Registry: https://www.npmjs.com/\nClawHub 网站: https://clawhub.ai\n\nLast updated: 2026-02-10"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/dawai2005/common-installation-troubleshooting",
    "publisherUrl": "https://clawhub.ai/dawai2005/common-installation-troubleshooting",
    "owner": "dawai2005",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/common-installation-troubleshooting",
    "downloadUrl": "https://openagent3.xyz/downloads/common-installation-troubleshooting",
    "agentUrl": "https://openagent3.xyz/skills/common-installation-troubleshooting/agent",
    "manifestUrl": "https://openagent3.xyz/skills/common-installation-troubleshooting/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/common-installation-troubleshooting/agent.md"
  }
}