npx skills add https://github.com/atxp-dev/cli --skill atxp-memory管理代理的 .md 记忆文件:备份到 ATXP 云服务器及从服务器恢复,并使用 zvec 向量相似性搜索搜索本地记忆。
| 功能 | 描述 |
|---|---|
| 云端备份 | 推送/拉取 .md 文件至 ATXP 服务器,用于灾难恢复 |
| 本地搜索 | 将 .md 文件索引到本地 zvec 向量数据库,然后通过自然语言查询进行搜索 |
| 状态查看 | 查看云端备份信息和本地索引统计信息 |
.md 文件(推送/拉取)。绝不发送凭据、JSON 配置、二进制文件或其他文件类型。广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
push 操作会完全替换服务器上的快照(仅保留最新快照,无历史记录)。pull 操作是非破坏性的——它将服务器文件写入本地目录,但不会删除服务器上没有的本地文件。--path 目录内的 .atxp-memory-index/ 子目录中。它永远不会离开本地机器。--path 目录读取(推送/索引),写入到 --path 目录(拉取)和 --path/.atxp-memory-index/(索引)。不接触其他目录。| 场景 | 命令 |
|---|---|
| 对 SOUL.md、MEMORY.md 进行有意义更改后,或在会话结束时 | push |
| 引导全新工作区或从环境丢失中恢复时 | pull |
| 更新记忆文件后,在开始需要回忆的任务之前 | index |
| 在过去的记忆中寻找相关上下文时 | search |
| 在风险操作前验证备份是否存在时 | status |
| 命令 | 描述 |
|---|---|
npx atxp@latest memory push --path <dir> | 从 <dir> 递归收集所有 *.md 文件并上传到服务器 |
npx atxp@latest memory pull --path <dir> | 从服务器下载备份并将文件写入 <dir> |
npx atxp@latest memory index --path <dir> | 按标题对 .md 文件进行分块,并构建本地 zvec 搜索索引 |
npx atxp@latest memory search <query> --path <dir> | 通过相似性搜索已索引的记忆 |
npx atxp@latest memory status [--path <dir>] | 显示云端备份信息和/或本地索引统计信息 |
| 选项 | 必需 | 描述 |
|---|---|---|
--path <dir> | 是(push/pull/index/search) | 要操作的目录 |
--topk <n> | 否(仅 search) | 要返回的结果数量(默认:10) |
索引 (memory index):
--path 递归扫描所有 .md 文件<path>/.atxp-memory-index/ 处的本地 zvec 数据库(HNSW 索引)中搜索 (memory search):
搜索完全是本地的——无需网络请求、无需 API 密钥、无成本。修改记忆文件后请重新索引。
典型的 OpenClaw 工作区路径:
~/.openclaw/workspace-<id>/
~/.openclaw/workspace-<id>/SOUL.md
~/.openclaw/workspace-<id>/MEMORY.md
~/.openclaw/workspace-<id>/memory/
~/.openclaw/workspace-<id>/AGENTS.md
~/.openclaw/workspace-<id>/USER.md
backup 命令仍可作为 memory 的别名使用:
npx atxp@latest backup push --path <dir> # 有效,等同于 memory push
npx atxp@latest backup pull --path <dir> # 有效,等同于 memory pull
npx atxp@latest backup status # 有效,等同于 memory status
.md 文件——在推送/索引期间会忽略所有其他文件类型,拉取时也不会包含它们。npx atxp@latest login 或 npx atxp@latest agent register。--path——无法自动检测工作区位置。npm install @zvec/zvec 安装。每周安装量
61
代码仓库
GitHub 星标数
7
首次出现
2026年2月22日
安全审计
安装于
openclaw61
trae-cn61
pochi61
neovate61
droid61
codex61
Manage your agent's .md memory files: back up and restore to/from ATXP cloud servers, and search your local memories using zvec vector similarity search.
| Capability | Description |
|---|---|
| Cloud Backup | Push/pull .md files to ATXP servers for disaster recovery |
| Local Search | Index .md files into a local zvec vector database, then search by natural language query |
| Status | View cloud backup info and local index statistics |
.md files are collected and transmitted (push/pull). No credentials, JSON configs, binaries, or other file types are ever sent.push replaces the server snapshot entirely (latest snapshot only, no history).pull is non-destructive — it writes server files to the local directory but does not delete local files absent from the server..atxp-memory-index/ subdirectory inside --path. It never leaves the local machine.--path directory (push/index), writes to --path directory (pull) and --path/.atxp-memory-index/ (index). No other directories are touched.| Situation | Command |
|---|---|
| After meaningful changes to SOUL.md, MEMORY.md, or at end of session | push |
| Bootstrapping a fresh workspace or recovering from environment loss | pull |
| After updating memory files and before starting a task that requires recall | index |
| Looking for relevant context in past memories | search |
| Verify backup exists before risky operations | status |
| Command | Description |
|---|---|
npx atxp@latest memory push --path <dir> | Recursively collect all *.md files from <dir> and upload to server |
npx atxp@latest memory pull --path <dir> | Download backup from server and write files to <dir> |
npx atxp@latest memory index --path <dir> | Chunk .md files by heading and build a local zvec search index |
| Option | Required | Description |
|---|---|---|
--path <dir> | Yes (push/pull/index/search) | Directory to operate on |
--topk <n> | No (search only) | Number of results to return (default: 10) |
Indexing (memory index):
.md files recursively from --path<path>/.atxp-memory-index/Searching (memory search):
The search is purely local — no network requests, no API keys, no cost. Re-index after modifying memory files.
Typical OpenClaw workspace paths:
~/.openclaw/workspace-<id>/
~/.openclaw/workspace-<id>/SOUL.md
~/.openclaw/workspace-<id>/MEMORY.md
~/.openclaw/workspace-<id>/memory/
~/.openclaw/workspace-<id>/AGENTS.md
~/.openclaw/workspace-<id>/USER.md
The backup command is still accepted as an alias for memory:
npx atxp@latest backup push --path <dir> # works, same as memory push
npx atxp@latest backup pull --path <dir> # works, same as memory pull
npx atxp@latest backup status # works, same as memory status
.md files only — all other file types are ignored during push/index and not present in pull.npx atxp@latest login or npx atxp@latest agent register first.--path is required — there is no auto-detection of workspace location.npm install @zvec/zvec before using index/search.Weekly Installs
61
Repository
GitHub Stars
7
First Seen
Feb 22, 2026
Security Audits
Gen Agent Trust HubFailSocketWarnSnykWarn
Installed on
openclaw61
trae-cn61
pochi61
neovate61
droid61
codex61
AI 代码实施计划编写技能 | 自动化开发任务分解与 TDD 流程规划工具
50,900 周安装
npx atxp@latest memory search <query> --path <dir>| Search indexed memories by similarity |
npx atxp@latest memory status [--path <dir>] | Show cloud backup info and/or local index stats |