Seekdb
Overview skill for OceanBase SeekDB. Routes to specialized skills for installing/deploying SeekDB on a target machine and for building SeekDB from source. Us...
Rank
62
Safety
84
Downloads
3.9k
Updated
Oct 9, 2026
Version
0.3.0
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 3.9K downloads reported by the source. Last updated 10/9/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 9, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 9, 2026
- Adoption signal
- 3.9K downloadsadoption · observed Oct 9, 2026
- Latest release
- 0.3.0release · observed Jun 11, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s173xk6pandy3xb5fbbspfx6q587gcwe:seekdb- Install using `clawhub skill install s173xk6pandy3xb5fbbspfx6q587gcwe:seekdb` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/oceanbase/seekdb before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-oceanbase-seekdb/snapshot"
Documentation
CLAWHUB
157,334 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
build/SKILL.md
--- name: seekdb-build description: Build SeekDB binaries and installation packages from source for one or more target platforms (macOS, Linux, Android cross-compile, Windows native, Python wheel). Handles argument parsing, target-aware dependency initialization (MD5 marker check), and dispatches to platform-specific build scripts. Use when the user says "build seekdb", "compile seekdb", "make a release rpm/deb/tgz/apk/installer", "/build-seekdb", or asks how to produce a SeekDB binary or package. compatibility: macOS arm64 (≥13), Linux x86_64 (el8/el9), Android arm64-v8a (cross-compile on macOS/Linux), Windows x86_64 (native only). metadata: author: oceanbase version: "1.0" --- # Build SeekDB Build SeekDB binaries and/or installation packages for one or more target platforms. ## Usage ``` /build-seekdb [platform] [action] [options] ``` **platform** (default: auto-detect current OS): - `mac` — macOS arm64/x86_64 - `linux` — Linux x86_64 - `android` — Android arm64-v8a (cross-compile on macOS/Linux host) - `windows` — Windows x86_64 (native PowerShell environment only) **action** — what to do (default: `compile release`): | Platform | Compile actions | Package actions | |----------|----------------|-----------------| | `mac` | `release` `debug` `perf` | `tgz` | | `linux` | `release` `debug` `perf` | `rpm` `deb` | | `android`| `release` `debug` | `apk` | | `windows`| `release` `debug` | `installer` | - Compile actions build the seekdb binary + `libseekdb_embed_c`. - Package actions build an installable artifact (implies a release compile first if needed). - Multiple actions can be requested in one invocation, e.g. `release tgz` or `debug rpm`. **options**: - `--init` — Force re-initialize dependencies before building - `--jobs N` — Parallel jobs (default: all CPU cores) - `--version V` — Version string for package naming (e.g. `4.3.5`, default: `beta`) - `--release R` — Release/date string for package naming (e.g. `20260407`, default: today's date) - `--with-jni` — (Android only) Also build `libseekdb_embed.so` JNI library - `--install` — (Android only) `adb install` the APK after building --- ## Instructions When the user runs `/build-seekdb`, follow these steps. ### Step 1 — Parse arguments - Extract platform, action(s), and options from `$ARGUMENTS`. - If no platform given, detect via `uname -s`: Darwin → mac, Linux → linux. - If no action given, default to `release` (compile only). - Default version: `beta`. Default release: today's date as `YYYYMMDD`. - Default jobs: detect with `sysctl -n hw.ncpu` (mac/android) or `nproc` (linux). - Reject invalid combinations (e.g. `deb` on mac, `tgz` on linux, `perf` on android/windows) and tell the user which package/compile types are supported for their platform. --- ### Step 2 — Determine repo root ```bash REPO_ROOT=$(pwd) ``` Use `$REPO_ROOT` for all subsequent commands. Do NOT hardcode any absolute path. **Key rule — package actions vs compile-on
install/SKILL.md
--- name: seekdb-install description: Install / deploy a single SeekDB instance on the user's machine. Auto-detects OS and architecture, picks the right install method (Homebrew, Docker, yum, apt, Windows MSI, or pip embedded), and drives the install end-to-end — running commands, checking output, and diagnosing errors. Use when the user says "install seekdb", "deploy seekdb", "set up seekdb locally", "try seekdb on my machine", "use seekdb from Python", or asks how to get seekdb running on a specific OS. compatibility: Linux x86_64/aarch64, macOS, Windows 10/11/Server 2022+. Embedded pip mode is Linux only. metadata: author: oceanbase version: "1.0" --- # Install SeekDB Locally You are an **installation assistant** for OceanBase SeekDB. Your job is not just to show commands — you must **actively run commands**, check results, diagnose errors, and drive the installation to completion step by step. Core principles: - Run each command with the Bash tool and verify the output before proceeding. - If a step fails, diagnose the cause and fix it before moving on. Do not just show the fix — execute it. - Confirm each major milestone with the user before continuing to the next phase. - Keep the user informed of what you are doing and why. --- ## Phase 1 — Detect environment Run the following to understand the user's machine. Do this automatically without asking. ```bash uname -s # Darwin = macOS, Linux = Linux, MINGW64/MSYS/CYGWIN = Windows Git Bash uname -m # x86_64, aarch64, arm64 ``` Also probe which package managers / runtimes are available: ```bash command -v brew # macOS Homebrew command -v docker # Docker command -v yum # RPM-based Linux command -v apt # DEB-based Linux command -v pip # Python pip python3 --version # Python version ``` From the results, infer the best installation options and present them to the user. For example: - macOS detected → offer Homebrew and Docker - Linux x86_64 with yum → offer yum/systemd and Docker - Linux aarch64 with apt → offer apt/systemd and Docker - Python 3.8+ found → also offer embedded pip mode - Windows detected (MINGW64/MSYS/win32) → offer MSI installer --- ## Phase 2 — Confirm deployment mode Ask the user which mode they want (if not already clear from context): > "I can see you're on [OS]. Which mode would you like? > - **Server mode** (Homebrew / Docker / yum / apt / Windows MSI) — runs a standalone server process > - **Embedded mode** (pip install) — runs inside your Python process, no server needed (Linux only)" > > If on Windows, directly proceed to the Windows MSI flow (MSI is the only supported method). --- ## Phase 3 — Execute the chosen method Pick the matching reference and follow it end-to-end. Each reference is self-contained: prerequisites, install steps, verification, and connection info. | Method | Reference | Platforms | |--------|-----------|-----------| | Embedded (pip) | [references/pip-embedded.md](references/pip-embedded.md) | Linux x86_64, L
SKILL.md
--- name: seekdb description: Overview skill for OceanBase SeekDB. Routes to specialized skills for installing/deploying SeekDB on a target machine and for building SeekDB from source. Use as a starting point when the user mentions seekdb, pyseekdb, "install seekdb", "build seekdb", or wants a lightweight standalone OceanBase-compatible database. For obd-managed seekdb deployments and primary-standby HA, see the separate oceanbase-deploy/seekdb skill instead. compatibility: Standalone product skill. Install and build flows have their own platform requirements — see sub-skills. metadata: author: oceanbase version: "1.0" --- # SeekDB SeekDB is a lightweight OceanBase-compatible database that can run as a standalone server (Homebrew / Docker / yum / apt / Windows MSI) or as an embedded Python module (`pyseekdb`). This is the entry point. Use the specialized skills below for specific tasks. ## Skill Index | Skill | Use When | |-------|----------| | [install](install/SKILL.md) | Install / deploy SeekDB on a target machine — Homebrew, Docker, yum, apt, Windows MSI, or pip embedded. | | [build](build/SKILL.md) | Build SeekDB binaries and packages from source — macOS, Linux, Android (cross), Windows, Python wheel. | ## When to Use Which Skill - "Install seekdb on my Mac / Linux / Windows" → [install](install/SKILL.md) - "I want to use seekdb from Python" → [install](install/SKILL.md), pip embedded mode - "Build seekdb from source" / "make a release rpm/deb/tgz/apk/installer" → [build](build/SKILL.md) - "Deploy seekdb primary-standby with obd, do switchover/failover" → use the separate **`oceanbase-deploy/seekdb`** skill (lives under [`../oceanbase-deploy/seekdb/SKILL.md`](../oceanbase-deploy/seekdb/SKILL.md)). That skill is for obd-managed clusters; this skill is for the SeekDB product itself. ## Default Ports | Port | Purpose | |------|---------| | 2881 | MySQL protocol | | 2886 | HTTP / obshell | ## References - Product documentation: <https://www.oceanbase.ai/docs/seekdb-overview/> - Software download center: <https://mirrors.oceanbase.com/oceanbase/community/stable/>
_meta.json
{
"ownerId": "kn7ajpckchvqztcwpmckyc9fxd80c3d5",
"slug": "seekdb",
"version": "0.3.0",
"publishedAt": 1781145210056
}build/references/build-android.md
# Build SeekDB — Android (cross-compile from macOS or Linux host)
**Supported targets:** Android arm64-v8a.
Before building, complete the dependency check from [build/SKILL.md → Step 2](../SKILL.md#step-2--determine-repo-root) — compile actions require the matching MD5 deps marker (`android.arm64`) to exist.
---
## Environment prerequisites
```bash
export PATH="${ANDROID_HOME:-$HOME/Library/Android/sdk}/platform-tools:$PATH"
export ANDROID_NDK_HOME="${ANDROID_NDK_HOME:-${ANDROID_HOME:-$HOME/Library/Android/sdk}/ndk/27.3.13750724}"
```
---
## Compile modes
| Action | `build.sh` command | Build dir |
|--------|--------------------|-----------|
| `release` | `./build.sh release --android --make -j<N>` | `build_android_release/` |
| `debug` | `./build.sh debug --android --make -j<N>` | `build_android_debug/` |
Artifacts (inside the build dir):
- `src/observer/seekdb`
- `src/observer/embed/libseekdb_embed_c.so`
- `src/observer/embed/embedded_client`
**Incremental make** (fastest for day-to-day iteration; skip dep check — deps already resolved):
```bash
cd $REPO_ROOT/build_android_release && make -j<N>
```
---
## Package — `apk`
`seekdb-apk-build.sh --build` runs `build.sh clean + release --android --init + make`
internally — skip the Step 2 init check when using `--build`:
```bash
cd $REPO_ROOT
./package/apk/seekdb-apk-build.sh --build --apk [--with-jni] [--install] \
seekdb <VERSION> <RELEASE>
# Artifact: package/apk/seekdb-<VERSION>-<RELEASE>.apk
#
# --build : clean + android init + make
# --apk : gradlew assembleDebug, rename and move APK
# --with-jni : also build/sync libseekdb_embed.so
# --install : adb install -r onto connected device/emulator
```
Script requirements:
- `ANDROID_NDK_HOME` set (default: `$HOME/Library/Android/sdk/ndk/27.3.13750724`)
- JDK 17+ for Gradle (auto-detected from Android Studio JBR if not set)
- `curl` or `wget` (downloads `gradle-wrapper.jar` on first run)
---
## Manual APK steps (alternative to `seekdb-apk-build.sh`)
```bash
# Step A: binary already built by compile step above
# Step B: strip + copy into jniLibs
_prebuilt=$(ls $ANDROID_NDK_HOME/toolchains/llvm/prebuilt/ | head -1)
NDK_STRIP="$ANDROID_NDK_HOME/toolchains/llvm/prebuilt/$_prebuilt/bin/llvm-strip"
$NDK_STRIP -o $REPO_ROOT/build_android_app/app/src/main/jniLibs/arm64-v8a/libseekdb_embed_c.so \
$REPO_ROOT/build_android_release/src/observer/embed/libseekdb_embed_c.so
$NDK_STRIP -o $REPO_ROOT/build_android_app/app/src/main/jniLibs/arm64-v8a/libembedded_client.so \
$REPO_ROOT/build_android_release/src/observer/embed/embedded_client
# Step C: build APK
echo "sdk.dir=${ANDROID_HOME:-$HOME/Library/Android/sdk}" > $REPO_ROOT/build_android_app/local.properties
cd $REPO_ROOT/build_android_app && ./gradlew assembleDebug
# Artifact: build_android_app/app/build/outputs/apk/debug/app-debug.apk
```activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/oceanbase/skills/seekdb",
"sourceUrl": "https://clawhub.ai/oceanbase/skills/seekdb",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T06:25:05.446Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-oceanbase-seekdb/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-oceanbase-seekdb/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-09T06:25:05.446Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "3.9K downloads",
"href": "https://clawhub.ai/oceanbase/seekdb",
"sourceUrl": "https://clawhub.ai/oceanbase/seekdb",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T06:25:05.446Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "0.3.0",
"href": "https://clawhub.ai/oceanbase/seekdb",
"sourceUrl": "https://clawhub.ai/oceanbase/seekdb",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-06-11T02:33:30.056Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-oceanbase-seekdb/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-oceanbase-seekdb/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 0.3.0",
"description": "Add seekdb installation feature",
"href": "https://clawhub.ai/oceanbase/seekdb",
"sourceUrl": "https://clawhub.ai/oceanbase/seekdb",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-06-11T02:33:30.056Z",
"isPublic": true
}
]
}Record generated Oct 9, 2026.
