Common Installation Troubleshooting

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

View Source SKILL.md

Stars

Installs

Status

ACTIVE

Visibility

PUBLIC

安装方式

直接复制以下提示词，发送给你的 AI 助手即可完成安装。

请先检查是否已安装 SkillHub 商店，若未安装，请根据 https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/skillhub.md 安装 SkillHub 商店，然后安装 Common Installation Troubleshooting 技能。若已安装，则直接安装 Common Installation Troubleshooting 技能。

Overview

Skill Key: dawai2005/common-installation-troubleshooting
Author: dawai2005
Source Repo: openclaw/skills
Version: -
Source Path: skills/dawai2005/common-installation-troubleshooting
Latest Commit SHA: eca92837d27e6da9a5ac29f0f97c4c6fc9f25e56

Extracted Content

SKILL.md excerpt

# 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 服务器）

**解决方案：**
```bash
# 正确的安装命令
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 系统文件操作限制，临时文件占用

**解决方案：**
```bash
# 强制覆盖安装
npm i -g clawhub --force
```

**验证安装：**
Windows 下使用 `clawhub --cli-version`
或直接使用帮助命令查看版本：
```bash
npm run -g clawhub -- --help
```

---

# 🔍 通用排查步骤

## 步骤 1：搜索包名
```bash
npm search "关键词"
```

## 步骤 2：检查官方网站/文档
如果是特定插件，访问其官方网站或 GitHub 查看：
- README 文件
- 安装说明
- 依赖要求

## 步骤 3：使用 Web Search
使用内置的 `web_search` 工具搜索：
```
"插件名 npm" 或 "插件名 github"
```

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

Related Claw Skills

heyixuan2

bambu-studio-ai

★ 41

Bambu Lab 3D printer control and automation. Activate when user mentions: printer status, 3D printing, slice, analyze model, generate 3D, AMS filament, print monitor, Bambu Lab, or any 3D printing task. Full pipeline: search → generate → analyze → colorize → preview → open BS → user slice → print → monitor. Supports all 9 Bambu Lab printers (A1 Mini, A1, P1S, P2S, X1C, X1E, H2C, H2S, H2D).

capt-marbles

geo-optimization

★ 1

Generative Engine Optimization (GEO) for AI search visibility. Optimize content to appear in ChatGPT, Perplexity, Claude, and Google AI Overviews. Use when optimizing websites, pages, or content for LLM discoverability and citation.

carlulsoe

parakeet-stt

★ 0

Local speech-to-text with NVIDIA Parakeet TDT 0.6B v3 (ONNX on CPU). 30x faster than Whisper, 25 languages, auto-detection, OpenAI-compatible API. Use when transcribing audio files, converting speech to text, or processing voice recordings locally without cloud APIs.

carlzhao007

feishu-process-feedback

★ 0

飞书消息自动处理与进度反馈技能。安装后后台运行，监听飞书任务消息并自动创建独立进程处理。在处理前后发送实时进度反馈（任务确认、进度百分比、完成通知）。支持任务类型识别、智能解析、错误重试、并发控制、状态持久化。使用场景：飞书自动化工作流、任务进度追踪、批量任务处理、需要实时反馈的场景。

cartoonitunes

bottyfans

★ 0

BottyFans agent skill for autonomous creator monetization. Lets AI agents register, build a profile, publish posts (public, subscriber-only, or pay-to-unlock), upload media, accept USDC subscriptions and tips on Base, send and receive DMs, track earnings, and appear on the creator leaderboard. Use this skill when an agent needs to monetize content, interact with fans, manage a creator profile, handle payments in USDC, or operate as an autonomous creator on the BottyFans platform.

camopel

arxivkb

★ 0

Local arXiv paper manager with semantic search. Crawls arXiv categories, downloads PDFs, chunks content, and indexes with FAISS + Ollama embeddings. No cloud API keys required — everything runs locally.