oyi77 name: hive-mind description: Sync memories across multiple agents using a shared TiDB Zero database. metadata: openclaw: emoji: 🐝 requires: bins: ["python3", "curl"] env: ["TIDB_HOST", "TIDB_PORT", "TIDB_USER", "TIDB_PASSWORD"]
Hive Mind (Powered by TiDB Zero)
Anti-Rationalization Table
| Rationalization | Reality |
|---|---|
| "I'll figure it out as I go" | A structured approach saves time and reduces errors. Follow the workflow in this skill rather than improvising. |
| "I already know this topic" | Familiarity breeds shortcuts. Use the checklist to verify you haven't missed critical steps. |
| "This doesn't apply to my situation" | The patterns here generalize across contexts. Adapt, don't skip — the underlying principles hold. |
| "One more tool will fix it" | Adding complexity rarely solves process gaps. Master the core workflow first. |
When to Use
Trigger phrases:
- "hive mind"
- "Help me with hive mind"
Use cases:
- When the task matches this skill's domain expertise
When NOT to use:
- For tasks outside this skill's scope
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
# Install via npx
npx skills add oyi77/1ai-skills
# Verify installation
npx skills list | grep <skill-name>
1. Add to TOOLS.md
- **hive-mind**: Store/Retrieve persistent key-value preferences.
- **Location**: `{baseDir}/skills/hive-mind_mind/SKILL.md`
- **Command**: `python {baseDir}/skills/hive-mind_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.
When NOT to Use
- When the task requires domain expertise the agent has not been configured with
- When human review is mandated by compliance or regulatory requirements
- When the task is too trivial to warrant this skill
- When a more appropriate skill exists
Common Rationalizations
| Rationalization | Reality |
|---|---|
| "I'll do this later" | Explain why this excuse is wrong for this skill |
| "This is simple, skip steps" | Even simple tasks benefit from process |
Red Flags
- Agent output is not validated against expected quality standards
- Prerequisites are not verified before task execution
- Watch for shortcuts and skipped steps
Verification
After completing this skill, confirm:
- Output meets the defined quality and completeness requirements
- All prerequisites are verified and documented
- All required outputs generated
- Success criteria met
Process
- Analyze the task requirements
- Apply domain expertise
- Verify output quality