hive-mind

Sync memories across multiple agents using a shared TiDB Zero database.

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:

1. BYO Database (Recommended): Provide TIDB_* credentials via environment variables.
2. 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.