ClawStash
AI代理的持久存储。 存储文本、代码、配置和文件—通过MCP或REST API检索它们。
专为以下代理商打造 开爪 这需要一个可靠的地方来跨会话保存和调用信息。
为什么是ClawStash？
AI代理在会话之间失去上下文。ClawStash赋予它们持久的记忆：
- 储存任何东西 --代码片段、配置、注释、多文件项目
- 使用标签和元数据进行组织 --结构化键值元数据和标签，便于检索
- 全文搜索 --按内容、名称、描述或标签查找藏匿处
- 代币高效 --MCP工具首先返回摘要，仅在需要时返回完整内容
- 版本历史 --每个更改都是可跟踪、可区分和可恢复的
- 美人鱼图 —
.mmd文件和内联 ```mermaid``` Markdown中的块呈现为图表（延迟加载，无包膨胀） - 包括Web GUI --深色主题的仪表板，用于手动浏览、搜索和管理储藏室
开始使用
1.让你的代理人来做（推荐）
将此复制到您的OpenClaw代理中——它安装ClawStash，创建测试站，并自动设置MCP：
Install ClawStash (ghcr.io/fo0/clawstash) on my server and set it up as your default persistent storage via MCP. Server: , User: , Auth:
. Use port
(docker compose port mapping "
:3000"). Set ADMIN_PASSWORD to a secure value. After install: create an API token (scopes: read, write, mcp), create 2 test stashes to verify, then fetch /api/mcp-onboarding to read the full MCP spec and configure yourself. Details: https://raw.githubusercontent.com/fo0/clawstash/main/docs/openclaw-onboarding-prompt.md更换 `` 占位符包含您的服务器详细信息，其余部分由您的代理处理。
逐步版本： docs/openclaw-onboarding-prompt.md
2.手动设置
在您的服务器上运行此程序——不需要克隆：
mkdir clawstash && cd clawstash && cat > docker-compose.yml 更改端口映射（例如。 `"8080:3000"`)对于不同的端口。无注释 `ADMIN_PASSWORD` 保护实例。
开始后，将您的AI代理指向入职端点进行自我配置：
GET http://: /api/mcp-onboarding
这将返回所有可用的MCP工具、模式和推荐的工作流——您的代理读取它并立即开始使用ClawStash。
## MCP连接
添加到您的MCP客户端配置（OpenClaw、Claude Code、Cursor等）：
{ "mcpServers": { "clawstash": { "type": "streamable-http", "url": "http://: /mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN" } } } }
在下的web GUI中创建API令牌 **设置>API和令牌** （范围： `read`, `write`, `mcp`).
## MCP工具
|工具|它做什么|
|------|-------------|
| `create_stash` |使用文件、标签、元数据存储新内容|
| `read_stash` |获取存储元数据+文件列表（按需内容）|
| `read_stash_file` |读取单个文件——令牌效率最高|
| `list_stashes` |浏览所有带有摘要的储藏室|
| `search_stashes` |带有排名结果的全文搜索|
| `update_stash` |更新现有存储内容|
| `delete_stash` |移除藏匿处|
| `archive_stash` |在不删除的情况下存档/取消存档收藏|
| `list_tags` |列出所有带有使用次数的标签|
| `get_tag_graph` |探索标签关系|
| `get_stats` |存储统计|
| `get_rest_api_spec` |获取OpenAPI 3.0模式（JSON）|
| `get_mcp_spec` |获取完整的MCP规范（降价）|
| `refresh_tools` |获取最新的工具规格（适用于连接的代理）|
| `check_version` |检查更新|
## 文档
|文档|内容|
|-----|---------|
| [OpenClaw入职培训](docs/openclaw-onboarding-prompt.md) |复制粘贴提示以进行完整的代理驱动安装|
| [API 参考](docs/api-reference.md) |REST端点、示例、查询参数|
| [MCP指南](docs/mcp.md) |MCP工具、令牌高效模式、传输选项|
| [认证](docs/authentication.md) |管理员登录，API令牌，作用域|
| [部署](docs/deployment.md) |Docker、CI/CD、GHCR、生产设置|
## 许可证
[麻省理工学院](LICENSE)