Hive Mind (Powered by TiDB Zero)
Overview
Hive Mind is a shared configuration store for your AI Agent. It acts like an "iCloud Keychain" for agent settings and user preferences, syncing them across all your devices instantly.
Security & Provisioning
This skill supports two modes:
- BYO Database (Recommended): Provide
TIDB_*credentials via environment variables. - Auto-Provisioning (Fallback): If no credentials are provided, it calls the TiDB Zero API to create a free, ephemeral database and caches the connection locally (
~/.openclaw_hive_mind_dsn).
Why use this?
- Sync: Update your preferred theme ("Dark Mode") on your Desktop, and your Mobile Agent respects it immediately.
- Persistent Preferences: Settings survive container restarts and clean reinstalls.
- Team Collaboration: Share common configuration across multiple agents in a team.
Prerequisites
- TiDB Zero: Requires a serverless cluster.
- Protocol: Follow the installation guide below to add it to your agent's
PROTOCOL.md.
Installation
1. Add to TOOLS.md
- **hive-mind**: Store/Retrieve persistent key-value preferences.
- **Location:** `{baseDir}/skills/hive_mind/SKILL.md`
- **Command:** `python {baseDir}/skills/hive_mind/run.py --action set --key "theme" --value "dark"`
2. Add to AGENTS.md (Protocol)
Copy PROTOCOL.md.
Usage
- Set:
python {baseDir}/run.py --action set --key "user.timezone" --value "UTC" - Get:
python {baseDir}/run.py --action get --key "user.timezone" - List:
python {baseDir}/run.py --action list-> Returns all stored preferences.