← Back to Skills Marketplace
Pinecone
by
aiwithabidi
· GitHub ↗
· v1.0.0
454
Downloads
0
Stars
7
Active Installs
1
Versions
Install in OpenClaw
/install pinecone
Description
Pinecone vector database — manage indexes, upsert vectors, query similarity search, manage namespaces, and track collections via the Pinecone API. Build sema...
Usage Guidance
This skill's purpose (Pinecone CLI) is reasonable and the single required secret (PINECONE_API_KEY) matches the purpose — but the script reads a local .env file at WORKSPACE or ~/.openclaw/workspace/.env to find that key if the environment variable is missing. That local-file access is not documented in SKILL.md. Actionable steps before installing or using: 1) Inspect or run the script in an isolated environment (container/VM). 2) If you store secrets in ~/.openclaw/workspace/.env, be aware the skill will read it; consider rotating the Pinecone key or removing it from that file. 3) Ask the publisher to declare the .env fallback in SKILL.md (or remove the fallback) and to fix the HTTP method/path bugs — the current implementation appears buggy and may fail or behave unexpectedly. 4) If you don't trust the author, avoid installing; else test with a limited-scoped Pinecone key and monitor network requests. If you want, I can point out the exact lines to change to remove the .env fallback and to correct the API calls.
Capability Analysis
Type: OpenClaw Skill
Name: pinecone
Version: 1.0.0
The skill bundle is classified as suspicious due to a complete mismatch between the documented functionality in SKILL.md and the actual implementation in scripts/pinecone.py. The Python script contains non-functional code that uses incorrect HTTP methods (e.g., GET for upsert and query operations) and invalid API paths that do not match the official Pinecone API. Furthermore, the command functions ignore the input arguments provided by the user, rendering the skill non-functional for its stated purpose. While the script targets the legitimate api.pinecone.io domain and lacks explicit exfiltration logic, the collection of the PINECONE_API_KEY from the environment or .env files by a non-functional script is highly irregular.
Capability Assessment
Purpose & Capability
Name, description, and declared PINECONE_API_KEY requirement align with a Pinecone CLI. However, the implementation contains many incorrect HTTP methods/paths (e.g., upsert/query using GET, unusual /index vs /indexes usage) suggesting the code is buggy or not the official Pinecone API shape. These are coherence/quality issues but do not by themselves imply malicious intent.
Instruction Scope
SKILL.md states requests go directly to Pinecone and that nothing is stored locally, but the script will try to read a local .env file at WORKSPACE or ~/.openclaw/workspace/.env to extract PINECONE_API_KEY if the environment variable is absent. That local-file access is not declared in the metadata and is a scope mismatch (it reads user files to obtain credentials).
Install Mechanism
No install spec is provided (instruction-only with an included script). This is low-risk from an installation perspective because nothing arbitrary is downloaded or written by an installer.
Credentials
The only declared credential is PINECONE_API_KEY, which is appropriate. However, the script also reads WORKSPACE (to locate a .env file) and will parse that file for PINECONE_API_KEY if the env var is missing; those additional environment/config accesses are not declared in requires.env and may expose or depend on local files containing secrets.
Persistence & Privilege
The skill does not request always:true, does not modify other skills, and does not attempt to persist or enable itself. It runs as a normal, user-invoked CLI script.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install pinecone - After installation, invoke the skill by name or use
/pinecone - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of pinecone vector database skill.
- Manage Pinecone indexes: create, configure, list, and delete.
- Upsert, fetch, query, and delete vectors with support for metadata and batch operations.
- Organize and manage vectors by namespaces and collections (snapshots).
- Perform similarity search and hybrid sparse-dense search.
- Requires only Python 3.10+ stdlib (no dependencies), using the Pinecone API.
- All commands are CLI-based and output JSON by default; add --human for readable output.
Metadata
Frequently Asked Questions
What is Pinecone?
Pinecone vector database — manage indexes, upsert vectors, query similarity search, manage namespaces, and track collections via the Pinecone API. Build sema... It is an AI Agent Skill for Claude Code / OpenClaw, with 454 downloads so far.
How do I install Pinecone?
Run "/install pinecone" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Pinecone free?
Yes, Pinecone is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Pinecone support?
Pinecone is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Pinecone?
It is built and maintained by aiwithabidi (@aiwithabidi); the current version is v1.0.0.
More Skills