← 返回 Skills 市场
mrlynn

Voyage AI CLI

作者 Michael Lynn · GitHub ↗ · v1.4.0
cross-platform ⚠ suspicious
1856
总下载
0
收藏
1
当前安装
1
版本数
在 OpenClaw 中安装
/install voyageai-skill
功能描述
Voyage AI embedding and reranking CLI integrated with MongoDB Atlas Vector Search. Use for: generating text embeddings, reranking search results, storing embeddings in Atlas, performing vector similarity search, creating vector search indexes, listing available models, comparing text similarity, bulk ingestion, interactive demos, and learning about AI concepts. Triggers: embed text, generate embeddings, vector search, rerank documents, voyage ai, semantic search, similarity search, store embeddings, atlas vector search, embedding models, cosine similarity, bulk ingest, explain embeddings.
安全使用建议
This skill is a coherent CLI wrapper for Voyage AI + MongoDB Atlas Vector Search, but check a few things before installing: 1) The package installs globally via npm — verify the 'voyageai-cli' package and its maintainer (npm listing and GitHub repo) so you trust what code will be run on your machine. 2) You must provide VOYAGE_API_KEY; the SKILL.md also references MONGODB_URI for DB operations but that env var is not declared — only set MONGODB_URI when you intend to allow the CLI to connect to your Atlas cluster. 3) The CLI can persist an API key via 'vai config', which writes to your home directory; prefer least-privilege API keys and consider using ephemeral or scoped credentials. 4) The README instructs adding shell completion to ~/.bashrc or zsh completion directories — these modify your shell config. 5) If you need higher assurance, inspect the npm package code (postinstall scripts, config storage location) or run the CLI in an isolated environment (container or separate account) before giving it production credentials.
功能分析
Type: OpenClaw Skill Name: voyageai-skill Version: 1.4.0 The skill is classified as suspicious due to its installation method and system modifications. It requires a global npm package installation (`npm install -g voyageai-cli`) and includes instructions to modify the user's shell configuration (`~/.bashrc`) for shell completions, both found in `SKILL.md`. While these actions are common for CLI tools and are for a stated, legitimate purpose, they involve high-privilege operations that could be leveraged for unintended system changes or persistence if the underlying package were compromised or the agent were prompted maliciously.
能力评估
Purpose & Capability
The name/description, required binary ('vai'), and VOYAGE_API_KEY align with a CLI that calls Voyage AI and Atlas APIs. Minor mismatch: the SKILL.md documents use of MONGODB_URI (for storing/searching) but that env var is not declared in the skill's requires.env; otherwise required pieces make sense for the stated purpose.
Instruction Scope
SKILL.md is an instruction-only wrapper that tells the agent to run the 'vai' CLI with commands for embedding, indexing, search, reranking, config management, completions, and ingestion. These steps stay within the stated domain. The instructions do include writing shell completion files (~/.bashrc, ~/.zsh/completions) and using 'vai config' to persist an API key in the user's config — expected for a CLI but worth noting. No instructions attempt to access unrelated files or external endpoints beyond the Voyage/MongoDB services documented.
Install Mechanism
Install uses npm (package: voyageai-cli, global installation). npm is an expected distribution channel for a Node.js CLI. This is moderate-risk relative to a curated package store but is proportionate and consistent with the skill's purpose; there are no ad-hoc download URLs or archive extractions in the spec.
Credentials
The skill declares VOYAGE_API_KEY as required (appropriate). However, SKILL.md refers to MONGODB_URI for store/search/index operations but MONGODB_URI is not listed in requires.env. The absence of an explicit primaryEnv (VOYAGE_API_KEY could reasonably be primary) and the undocumented optional env variable is a documentation/integration inconsistency the user should be aware of before installing.
Persistence & Privilege
always:false (default) and disable-model-invocation:false — normal. The CLI supports persistent config (vai config set api-key) which will store the API key locally in the user's config; that is expected behavior for a CLI but users should be aware it persists credentials to disk. The skill does not request system-wide or other skills' settings.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install voyageai-skill
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /voyageai-skill 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.4.0
- Added comprehensive SKILL.md documentation detailing all features, setup instructions, environment variables, and command references. - Included usage examples for embeddings, reranking, vector search, model management, batch ingestion, and more. - Documented common workflows for typical vector search and retrieval use cases. - Listed global flags and linked reference guides for models and vector search patterns.
元数据
Slug voyageai-skill
版本 1.4.0
许可证
累计安装 1
当前安装数 1
历史版本数 1
常见问题

Voyage AI CLI 是什么?

Voyage AI embedding and reranking CLI integrated with MongoDB Atlas Vector Search. Use for: generating text embeddings, reranking search results, storing embeddings in Atlas, performing vector similarity search, creating vector search indexes, listing available models, comparing text similarity, bulk ingestion, interactive demos, and learning about AI concepts. Triggers: embed text, generate embeddings, vector search, rerank documents, voyage ai, semantic search, similarity search, store embeddings, atlas vector search, embedding models, cosine similarity, bulk ingest, explain embeddings. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 1856 次。

如何安装 Voyage AI CLI?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install voyageai-skill」即可一键安装,无需额外配置。

Voyage AI CLI 是免费的吗?

是的,Voyage AI CLI 完全免费(开源免费),可自由下载、安装和使用。

Voyage AI CLI 支持哪些平台?

Voyage AI CLI 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Voyage AI CLI?

由 Michael Lynn(@mrlynn)开发并维护,当前版本 v1.4.0。

💬 留言讨论