← 返回 Skills 市场

Beeper

Name: Beeper
Author: krausefx

作者 KrauseFx · GitHub ↗ · v0.0.1

darwinlinux ✓ 安全检测通过

2172

总下载

当前安装

版本数

在 OpenClaw 中安装

/install beeper

功能描述

Search and browse local Beeper chat history (threads, messages, full-text search).

使用说明 (SKILL.md)

Beeper CLI

Beeper is a universal chat app that unifies messages from WhatsApp, Telegram, Signal, iMessage, Discord, and more in a single inbox.

This skill provides read-only access to your local Beeper chat history. Browse threads, search messages, and extract conversation data.

Requirements

Beeper Desktop app installed (provides the SQLite database)
beeper-cli binary on PATH

Database Path

The CLI auto-detects:

~/Library/Application Support/BeeperTexts/index.db (macOS)
~/Library/Application Support/Beeper/index.db (macOS)

Override with:

--db /path/to/index.db
BEEPER_DB=/path/to/index.db

Commands

List Threads

beeper-cli threads list --days 7 --limit 50 --json

Show Thread Details

beeper-cli threads show --id "!abc123:beeper.local" --json

List Messages in Thread

beeper-cli messages list --thread "!abc123:beeper.local" --limit 50 --json

Search Messages (Full-Text)

# Simple search
beeper-cli search 'invoice' --limit 20 --json

# Phrase search
beeper-cli search '"christmas party"' --limit 20 --json

# Proximity search
beeper-cli search 'party NEAR/5 christmas' --limit 20 --json

# With context window (messages before/after match)
beeper-cli search 'meeting' --context 6 --window 60m --json

Database Info

beeper-cli db info --json

Notes

Read-only: This tool never sends messages
JSON output: Always use --json for structured output agents can parse
FTS5 search: Uses Beeper's built-in full-text index (FTS5) for fast search
DM name resolution: Optionally resolves DM names via bridge databases (disable with --no-bridge)

Installation

Option 1: Go Install (recommended)

go install github.com/krausefx/beeper-cli/cmd/beeper-cli@latest

Option 2: Build from Source

git clone https://github.com/krausefx/beeper-cli.git
cd beeper-cli
go build ./cmd/beeper-cli
# Move beeper-cli to PATH, e.g., /usr/local/bin

Examples

Search for work-related messages from last week:

beeper-cli threads list --days 7 --json | jq '.threads[] | select(.name | contains("work"))'
beeper-cli search 'project deadline' --limit 10 --json

Find messages about invoices with context:

beeper-cli search 'invoice' --context 3 --json

安全使用建议

This skill is coherent with its description, but it reads your local Beeper chat database — which contains private messages. Before installing or using it: (1) confirm you have the beeper-cli binary from a trusted source (review the GitHub repo at github.com/krausefx/beeper-cli and its code/maintainer), (2) ensure the binary runs locally and truly performs read-only queries you expect, and (3) consider whether you want an agent with autonomous invocation to be able to run these local reads (agent outputs could leak message contents). Also note the SKILL.md suggests installing via `go install`; the registry metadata does not include a platform install step, so you will need to install the binary yourself. If you are unsure, review the beeper-cli code or run it manually on a test DB first.

功能分析

Type: OpenClaw Skill Name: beeper Version: 0.0.1 The skill is classified as benign. Its stated purpose is to provide read-only access to local Beeper chat history using the `beeper-cli` tool. The `SKILL.md` explicitly states 'Read-only: This tool never sends messages' and all commands shown are local executions. There is no evidence of data exfiltration, malicious execution, persistence mechanisms, obfuscation, or prompt injection attempts against the agent. The installation instructions are standard for Go projects, fetching from a specific GitHub repository (github.com/krausefx/beeper-cli).

能力评估

✓ Purpose & Capability

Name/description match the actions in SKILL.md: the skill uses the beeper-cli tool to read and search a local Beeper SQLite database. Requiring a beeper-cli binary (and showing how to install it via `go install`) is appropriate for this functionality.

ℹ Instruction Scope

Instructions are narrowly scoped to running beeper-cli against a local database and using --json output. They explicitly state read-only behavior. One minor note: DM name resolution can optionally read 'bridge' databases — the skill does not enumerate those paths, so the agent could access additional local bridge DB files if beeper-cli is configured to do so. The skill does not instruct any network calls or reading of unrelated system files.

ℹ Install Mechanism

There is no platform-level install spec, but SKILL.md includes an in-doc recommendation to install the binary via `go install github.com/krausefx/beeper-cli/...@latest` or to build from the repository. This is a common, low-risk install path (GitHub/go toolchain). Verify the GitHub repository and its releases/source before running the install command.

✓ Credentials

The skill does not request credentials or broad environment variables. It documents an optional BEEPER_DB env var to override the DB path, which is proportionate to the task. No unrelated secrets or service tokens are requested.

✓ Persistence & Privilege

The skill does not request permanent/always-on inclusion and uses the platform defaults for invocation. It does not declare any capability to modify other skills or system-wide settings.

如何使用

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

版本历史

v0.0.1

元数据

Slug beeper

版本 0.0.1

许可证 —

累计安装 7

当前安装数 7

历史版本数 1

常见问题

Beeper 是什么？

Search and browse local Beeper chat history (threads, messages, full-text search). 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 2172 次。

如何安装 Beeper？

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

Beeper 是免费的吗？

是的，Beeper 完全免费（开源免费），可自由下载、安装和使用。

Beeper 支持哪些平台？

Beeper 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（darwin, linux）。

谁开发了 Beeper？

由 KrauseFx（@krausefx）开发并维护，当前版本 v0.0.1。