← 返回 Skills 市场

Kvstore

Name: Kvstore
Author: mirni

作者 mirni · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ✓ 安全检测通过

总下载

当前安装

版本数

在 OpenClaw 中安装

/install gh-kvstore

功能描述

In-memory key-value store with TTL for AI agents. Set, get, delete, list, flush, and stats. Supports any JSON value, optional TTL per key, and prefix-based k...

使用说明 (SKILL.md)

KVStore

Lightweight key-value store for agent state, caching, and data sharing.

Start the server

uvicorn kvstore.app:app --port 8013

Set a value

curl -s -X POST http://localhost:8013/v1/set \
  -H "Content-Type: application/json" \
  -d '{"key": "user:1", "value": {"name": "Alice", "role": "admin"}}' | jq

Set with TTL (auto-expires)

curl -s -X POST http://localhost:8013/v1/set \
  -H "Content-Type: application/json" \
  -d '{"key": "cache:token", "value": "abc123", "ttl_seconds": 3600}' | jq

Get a value

curl -s http://localhost:8013/v1/get/user:1 | jq

Returns key, value (any JSON), and ttl_remaining (seconds until expiry, or null).

List keys by prefix

curl -s "http://localhost:8013/v1/keys?prefix=user:" | jq

Delete / Flush / Stats

curl -s -X DELETE http://localhost:8013/v1/delete/user:1 | jq
curl -s -X POST http://localhost:8013/v1/flush | jq
curl -s http://localhost:8013/v1/stats | jq

Endpoints

Method	Path	Description
POST	/v1/set	Set a key-value pair (optional TTL)
GET	/v1/get/{key}	Get value by key
DELETE	/v1/delete/{key}	Delete a key
GET	/v1/keys	List keys (optional ?prefix=)
POST	/v1/flush	Delete all keys
GET	/v1/stats	Hit/miss counts and total keys

安全使用建议

This skill appears to do exactly what it says: run a local HTTP server providing an in-memory JSON key-value store with TTL. Before installing or running it, consider: (1) network exposure — the SKILL.md starts uvicorn without explicit host, so ensure you bind to localhost or place it behind a firewall/reverse proxy if you don't want external access; there is no authentication, so anyone who can reach the server can read/modify data; (2) data persistence — state is in-memory only and will be lost on restart; (3) package provenance — the install uses pip to fetch FastAPI/uvicorn/pydantic from PyPI, which is normal but subject to normal supply-chain risks; (4) code review — the codebase is small and readable (no hidden endpoints), so review it yourself if you have concerns. Overall the skill is internally consistent and not suspicious.

功能分析

Type: OpenClaw Skill Name: gh-kvstore Version: 1.0.0 The gh-kvstore skill is a standard in-memory key-value store implemented using FastAPI. The code in kvstore/app.py and kvstore/state.py follows best practices for a simple utility, including TTL support and basic input validation via Pydantic models in kvstore/models.py. There are no signs of data exfiltration, malicious execution, or prompt injection.

能力评估

✓ Purpose & Capability

Name/description (KV store with TTL) match the included Python code and HTTP endpoints. Required binary (python) and declared pip packages (fastapi, uvicorn, pydantic) are appropriate and proportional to the stated purpose.

✓ Instruction Scope

SKILL.md only instructs starting a local uvicorn server and shows curl examples for the documented endpoints (/v1/set, /v1/get, /v1/keys, /v1/delete, /v1/flush, /v1/stats). There are no instructions to read unrelated files, exfiltrate data, or call external endpoints.

ℹ Install Mechanism

Install uses pip to fetch fastapi/uvicorn/pydantic from PyPI (declared in metadata). This is expected for a FastAPI app; pip installs carry the usual supply-chain considerations but are not unusual or disproportionate here.

✓ Credentials

No environment variables, credentials, or config paths are requested. The skill does not attempt to access unrelated secrets or system config.

✓ Persistence & Privilege

always is false and the skill does not modify other skills or system-wide settings. It runs as a normal local service and maintains only in-memory state (no persistent storage).

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install gh-kvstore
安装完成后，直接呼叫该 Skill 的名称或使用 /gh-kvstore 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

Initial release of gh-kvstore — a lightweight in-memory key-value store with TTL support. - Set, get, delete, list, and flush keys via simple HTTP API. - Supports any JSON values and optional TTL per key (auto-expiry). - List keys using a prefix filter. - Provides stats on hits, misses, and total keys. - Easy to run locally using FastAPI and Uvicorn.

元数据

Slug gh-kvstore

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题

Kvstore 是什么？

In-memory key-value store with TTL for AI agents. Set, get, delete, list, flush, and stats. Supports any JSON value, optional TTL per key, and prefix-based k... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 79 次。

如何安装 Kvstore？

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

Kvstore 是免费的吗？

是的，Kvstore 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

Kvstore 支持哪些平台？

Kvstore 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Kvstore？

由 mirni（@mirni）开发并维护，当前版本 v1.0.0。