OpenClaw · Skill
Index1 Doctor
Environment diagnostic skill for index1. Runs health checks and provides fix recommendations.
Install
Start with the primary install command. Alternate entrypoints are included below for ClawHub and OpenClaw CLI users.
Primary command
clawhub install gladego/index1-doctorClawHub installer
npx clawhub@latest install gladego/index1-doctorOpenClaw CLI
openclaw skills install gladego/index1-doctorDirect OpenClaw install
openclaw install gladego/index1-doctorWhat this skill does
Environment diagnostic skill for index1. Runs health checks and provides fix recommendations.
Why it matters
Runs three diagnostic commands in sequence and maps each result to a specific fix, so users don't have to manually trace failures across Python, SQLite, and Ollama separately.
Typical use cases
- Verifying index1 works after a fresh install
- Diagnosing why vector search stopped returning results
- Checking CJK/Chinese language support before indexing multilingual docs
- Confirming Ollama and embedding models are available
- Running before filing a bug report to gather environment info
Source instructions
index1 Doctor
Environment diagnostic skill for index1. Runs health checks and provides fix recommendations.
Usage
Type /doctor or ask the agent to diagnose index1.
What it checks
The skill runs three commands sequentially and analyzes results:
1. Environment Check
index1 doctor
Checks:
- Python version (>= 3.10 required)
- SQLite version (>= 3.43.0 for full features)
- sqlite-vec extension
- ONNX embedding (built-in, bge-small-en-v1.5)
- Ollama connectivity (optional, for multilingual/CJK)
- Embedding model availability
- CJK/Chinese support (jieba)
2. Index Status
index1 status
Shows:
- Document count and chunk count
- Collections list
- Last index time
- Database size
3. Ollama Models
ollama list
Shows installed models. Recommended embedding models:
nomic-embed-text— Standard, 270MBbge-m3— Best for CJK content, 1.2GB
Interpreting Results
| Check | Pass | Fail Fix |
|---|---|---|
| Python | >= 3.10 | Install Python 3.11+ |
| SQLite | >= 3.43.0 | Auto-degrades, no action needed |
| sqlite-vec | Loaded | pip install index1 (bundled) |
| Ollama | Connected | curl -fsSL https://ollama.com/install.sh | sh |
| Model | Available | ollama pull nomic-embed-text |
| CJK | jieba loaded | pip install index1[chinese] |
| Index | Has documents | index1 index ./src ./docs |
When to use
- First-time setup verification
- After upgrading index1
- When search returns unexpected results
- When vector search stops working
- Before reporting issues