ClawHub

OpenClaw 插件安装常见问题排查

v1.0.0

解决OpenClaw插件安装中常见npm包名错误、权限问题和安装验证的排查方法及最佳实践。

⭐ 0· 821·1 current·1 all-time
by@dawai2005
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Benign
high confidence
✓
Purpose & Capability
The SKILL.md is a troubleshooting guide for OpenClaw plugin installation and the commands and checks it recommends (npm search/install/view, checking docs, web search) are consistent with that purpose. Nothing requested by the skill is disproportionate or unrelated.
ℹ
Instruction Scope
Instructions stay within installation/troubleshooting scope (npm commands, searches, documentation checks). Minor issues: one example uses an invalid npm invocation ('npm run -g clawhub -- --help'), and advice to use --force can be destructive if used blindly. These are correctness/usability concerns rather than indicators of malicious intent.
✓
Install Mechanism
There is no install spec and no code files — the skill is instruction-only, which minimizes installation risk (nothing is downloaded or written to disk by the skill itself).
✓
Credentials
The skill declares no required environment variables, credentials, or config paths. The runtime instructions do not ask for secrets or unrelated credentials.
✓
Persistence & Privilege
The skill is not forced-always, is user-invocable, and does not request persistent elevated privileges or modify other skills/configuration. Autonomous invocation is allowed by platform default but is not combined with other concerning behaviors here.
Assessment
This skill appears safe and coherent: it's a text guide describing npm troubleshooting steps and web-search checks. Before following commands: (1) verify package names and source (prefer official GitHub/npm pages), (2) do not run --force or global installs as admin without understanding consequences—these can overwrite or break other packages, (3) note that one example command ('npm run -g ...') is incorrect; use 'clawhub --help' or check the project's README for the correct invocation, and (4) when in doubt, test installs in an isolated environment (container/VM) rather than your main system.

Like a lobster shell, security has layers — review code before you run it.

beginnervk972e8pek40eaykwn4e1910tgd80xjs7installationvk972e8pek40eaykwn4e1910tgd80xjs7latestvk972e8pek40eaykwn4e1910tgd80xjs7openclawvk972e8pek40eaykwn4e1910tgd80xjs7troubleshootingvk972e8pek40eaykwn4e1910tgd80xjs7
821downloads
0stars
1versions
Updated 1mo ago
v1.0.0
MIT-0
@dawai2005
beginnerinstallationlatestopenclawtroubleshooting
Download

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

📝 经验总结

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

🎯 最佳实践

  • 安装前检查：确认插件是否在 npm 注册表有对应的包
  • 查看 README：从官方仓库获取准确的安装命令
    • GitHub README 通常包含完整的安装指南
    • 注意不同的安装方式（npm/pip/git）
  • 使用 --save-dev / -D：开发环境使用，生产环境考虑 --save 或 -S
  • 验证版本：安装后立即测试，确保功能正常

📚 相关资源

Last updated: 2026-02-10

Comments

Loading comments...