# Send OpenClaw 插件安装常见问题排查 to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- 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.
## Suggested prompts
### New install

```text
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.
```
### Upgrade existing

```text
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.
```
## Machine-readable fields
```json
{
  "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": {
    "downloadUrl": "/downloads/common-installation-troubleshooting",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=common-installation-troubleshooting",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "common-installation-troubleshooting",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-06T12:33:06.474Z",
      "expiresAt": "2026-05-13T12:33:06.474Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=common-installation-troubleshooting",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=common-installation-troubleshooting",
        "contentDisposition": "attachment; filename=\"common-installation-troubleshooting-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "common-installation-troubleshooting"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "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."
      ]
    }
  },
  "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"
  }
}
```
## Documentation

### Skill: OpenClaw 插件安装常见问题排查

用于解决 OpenClaw 插件安装中遇到的常见问题。

### 1. Tavily Search 安装问题

问题现象：

npm error code E404
npm error 404 Not Found - GET https://registry.npmjs.org/tavily-search
npm error 404 The requested resource 'tavily-search@*' could not be found

原因：
包名错误，正确的包名是 tavily-mcp（用于 MCP 服务器）

解决方案：

# 正确的安装命令
npm install -g tavily-mcp

### 2. Find-Skills 安装问题

问题现象：

npm error code E404
npm error 404 Not Found - GET https://registry.npmjs.org/find-skills

原因：
find-skills 不是 npm registry 中的标准包名，可能使用不同的名称

解决方案：

使用 npm search find-skills 搜索是否存在
检查是否需要 GitHub 仓库克隆
验证包的实际名称

### 3. Proactive-Agent-1-2-4 安装问题

问题现象：

npm error code E404
npm error 404 Not Found - GET https://registry.npmjs.org/proactive-agent-1-2-4

原因：
proactive-agent-1-2-4 不是 npm 包名

解决方案：

确认正确的包名或获取方式
可能需要从 GitHub 仓库安装
使用 npm search 查找可用版本

### 4. Imap-Smtp-Email 安装问题

问题现象：
安装时找不到对应包

原因：
包名描述性太强，可能不是 npm 包名

解决方案：

咨询用户提供正确的包名
使用 web search 搜索具体插件（如 imap-smtp npm）
验证是否需要其他安装方式

### 5. ClawHub CLI 安装问题

问题现象：
Windows 权限错误，无法完全删除旧文件

原因：
Windows 系统文件操作限制，临时文件占用

解决方案：

# 强制覆盖安装
npm i -g clawhub --force

验证安装：
Windows 下使用 clawhub --cli-version
或直接使用帮助命令查看版本：

npm run -g clawhub -- --help

### 步骤 1：搜索包名

npm search "关键词"

### 步骤 2：检查官方网站/文档

如果是特定插件，访问其官方网站或 GitHub 查看：

README 文件
安装说明
依赖要求

### 步骤 3：使用 Web Search

使用内置的 web_search 工具搜索：

"插件名 npm" 或 "插件名 github"

### 步骤 4：检查包的权限

npm view 插件名

### 步骤 5：尝试不同安装方式

全局安装：npm install -g 插件名
本地安装：npm install 插件名
使用 --force 覆盖：npm install -g 插件名 --force

### 📝 经验总结

包名很重要：很多插件在 npm 上的名称与用户记忆的不同
使用搜索工具：遇到困惑时先搜索，不要瞎猜
查看文档：不要只依赖包名，查看官方文档的安装说明
权限问题：Windows 安装全局包时可能会遇到 EPERM 错误，使用 --force
验证安装：安装后立即验证版本和功能

### 🎯 最佳实践

安装前检查：确认插件是否在 npm 注册表有对应的包
查看 README：从官方仓库获取准确的安装命令

GitHub README 通常包含完整的安装指南
注意不同的安装方式（npm/pip/git）


使用 --save-dev / -D：开发环境使用，生产环境考虑 --save 或 -S
验证版本：安装后立即测试，确保功能正常

### 📚 相关资源

ClawHub 文档：https://docs.openclaw.ai/tools/clawhub
npm Registry: https://www.npmjs.com/
ClawHub 网站: https://clawhub.ai

Last updated: 2026-02-10
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: dawai2005
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-06T12:33:06.474Z
- Expires at: 2026-05-13T12:33:06.474Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/common-installation-troubleshooting)
- [Send to Agent page](https://openagent3.xyz/skills/common-installation-troubleshooting/agent)
- [JSON manifest](https://openagent3.xyz/skills/common-installation-troubleshooting/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/common-installation-troubleshooting/agent.md)
- [Download page](https://openagent3.xyz/downloads/common-installation-troubleshooting)