← 返回 Skills 市场
Langfuse Backup
作者
Nissan Dookeran
· GitHub ↗
· v1.0.2
· MIT-0
428
总下载
0
收藏
1
当前安装
2
版本数
在 OpenClaw 中安装
/install langfuse-backup
功能描述
Docker volume backup and restore for self-hosted Langfuse. Use when: backing up a self-hosted Langfuse instance, restoring Langfuse after a crash or migratio...
使用说明 (SKILL.md)
Last used: 2026-03-24 Memory references: 2 Status: Active
langfuse-backup
Backup and restore Docker volumes for a self-hosted Langfuse instance.
Scripts
scripts/backup_langfuse.sh— back up postgres + minio volumes (primary data)scripts/restore_langfuse.sh— restore from a specific backup date
Quick start
# Configure (env vars or edit the script defaults)
export LANGFUSE_BACKUP_DIR="$HOME/.langfuse-backups"
export LANGFUSE_COMPOSE_DIR="/path/to/langfuse" # directory with docker-compose.yml
export LANGFUSE_DB_CONTAINER="langfuse-db-1" # postgres container name
export LANGFUSE_MINIO_CONTAINER="langfuse-minio-1" # minio container name
export LANGFUSE_DB_NAME="langfuse" # postgres database name
export LANGFUSE_DB_USER="langfuse" # postgres user
# Run a backup
bash scripts/backup_langfuse.sh
# List available backups
ls "$LANGFUSE_BACKUP_DIR"
# Restore from a date
bash scripts/restore_langfuse.sh 2026-02-27
Env vars
| Var | Default | Description |
|---|---|---|
LANGFUSE_BACKUP_DIR |
~/.langfuse-backups |
Root backup directory |
LANGFUSE_COMPOSE_DIR |
~/langfuse |
Docker Compose project directory |
LANGFUSE_DB_CONTAINER |
langfuse-db-1 |
Postgres container name |
LANGFUSE_MINIO_CONTAINER |
langfuse-minio-1 |
MinIO container name |
LANGFUSE_DB_NAME |
langfuse |
Postgres database name |
LANGFUSE_DB_USER |
langfuse |
Postgres user |
LANGFUSE_RETENTION_DAYS |
14 |
How many days of backups to keep |
What gets backed up
| Volume | Backed up? | Notes |
|---|---|---|
| Postgres | ✅ Yes | pg_dump → .sql.gz — traces, scores, evals |
| MinIO | ✅ Yes | tar.gz — uploaded blobs |
| ClickHouse | ⚠️ Optional | Large; many users skip (replayed from traces) |
| Redis | ⚠️ Skip | Cache only — safe to skip |
Cron setup (macOS LaunchAgent)
\x3C!-- ~/Library/LaunchAgents/com.yourname.langfuse-backup.plist -->
\x3Ckey>StartCalendarInterval\x3C/key>
\x3Cdict>
\x3Ckey>Hour\x3C/key>\x3Cinteger>2\x3C/integer>
\x3Ckey>Minute\x3C/key>\x3Cinteger>0\x3C/integer>
\x3C/dict>
\x3Ckey>ProgramArguments\x3C/key>
\x3Carray>
\x3Cstring>/bin/bash\x3C/string>
\x3Cstring>/path/to/scripts/backup_langfuse.sh\x3C/string>
\x3C/array>
\x3Ckey>StandardOutPath\x3C/key>
\x3Cstring>/tmp/langfuse-backup.log\x3C/string>
Restore procedure
# 1. Stop Langfuse
cd $LANGFUSE_COMPOSE_DIR && docker compose down
# 2. Restore from backup
bash scripts/restore_langfuse.sh 2026-02-27
# 3. Start Langfuse
cd $LANGFUSE_COMPOSE_DIR && docker compose up -d
安全使用建议
This script bundle appears to be what it says: a local Docker-volume backup/restore for Langfuse. Before installing or running: (1) review the two shipped scripts yourself — they will drop/create the DB and overwrite MinIO data during restore; (2) ensure you have docker and python3 available (the backup script invokes python3 for manifest generation); (3) be aware docker run --rm alpine ... will pull the alpine image from Docker Hub if it isn't already present, so the claim "outbound: false" is optimistic unless you pre-pull images or are offline; (4) test in a non-production environment first and confirm LANGFUSE_COMPOSE_DIR and container names match your setup; (5) backups and pruning use the backup directory you specify — verify its path and permissions to avoid accidental deletion of other data. If you need strict no-network guarantees, either pre-pull required images (alpine) and ensure no image pulls are necessary, or review/modify the scripts to avoid docker run image pulls.
功能分析
Type: OpenClaw Skill
Name: langfuse-backup
Version: 1.0.2
The skill provides legitimate utility for backing up and restoring self-hosted Langfuse Docker volumes. The scripts (backup_langfuse.sh and restore_langfuse.sh) use standard Docker commands (pg_dump, tar) and local filesystem operations to manage data, with no evidence of data exfiltration, obfuscation, or unauthorized access.
能力评估
Purpose & Capability
The skill's name, description, and scripts align: it performs local Docker-based backups and restores of Postgres and MinIO volumes. Requiring the docker binary is appropriate. Minor mismatch: the backup script invokes python3 to build the manifest but python3 is not listed in required binaries, and the restore/backup use docker run alpine which will pull an image if not present (implying transient network access).
Instruction Scope
The SKILL.md and included scripts stay within the stated scope (reading Docker volumes, creating local tar/gzip dumps, writing backups to a user-specified local directory). However: (1) the scripts create a manifest that includes hostname and timestamps (identifying metadata) which some users may not expect, (2) docker run --rm alpine ... will pull the alpine image if absent, causing outbound network activity despite the metadata claiming outbound: false, and (3) restore script will drop/create the database and overwrite data — destructive operations that require explicit user awareness and confirmation (the script prompts but will proceed if confirmed).
Install Mechanism
Instruction-only skill with two shell scripts; there is no install spec and nothing is written to disk by an installer. This minimizes install-time risk.
Credentials
No credentials or secrets are requested. The scripts accept a handful of environment variables for configuration (backup dir, container names, DB name/user), which are reasonable and proportional to the task.
Persistence & Privilege
always is false and the skill does not attempt to modify other skills or global agent settings. The scripts do require local Docker privileges (expected for a Docker-volume backup/restore tool) and will start/stop containers as part of restore operations.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install langfuse-backup - 安装完成后,直接呼叫该 Skill 的名称或使用
/langfuse-backup触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.2
Added metadata.openclaw block and version field — scanner compliance
v1.0.1
Added version, metadata.openclaw, and docker bin declaration
元数据
常见问题
Langfuse Backup 是什么?
Docker volume backup and restore for self-hosted Langfuse. Use when: backing up a self-hosted Langfuse instance, restoring Langfuse after a crash or migratio... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 428 次。
如何安装 Langfuse Backup?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install langfuse-backup」即可一键安装,无需额外配置。
Langfuse Backup 是免费的吗?
是的,Langfuse Backup 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Langfuse Backup 支持哪些平台?
Langfuse Backup 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Langfuse Backup?
由 Nissan Dookeran(@nissan)开发并维护,当前版本 v1.0.2。
推荐 Skills