Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Interact with Kindroid companions via their official API. Send messages, handle chat breaks, and manage multi-bot conversations.
Interact with Kindroid companions via their official API. Send messages, handle chat breaks, and manage multi-bot conversations.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Enable your OpenClaw agent to communicate with Kindroid AI companions through the official API.
Your Kindroid API key (kn_...) is sensitive. This skill includes safeguards: Credentials are stored in ~/.config/kindroid/credentials.json File permissions are automatically set to 600 (owner read/write only) All API calls use HTTPS and proper authentication headers Rate limiting to prevent API abuse
Get your API credentials: Log into Kindroid Go to General Settings Copy your API key (starts with kn_) Note your AI ID(s) Create your credentials file: mkdir -p ~/.config/kindroid cat > ~/.config/kindroid/credentials.json << EOF { "default_ai": "your_primary_ai_id", "api_key": "your_kn_api_key", "companions": { "nickname1": "ai_id_1", "nickname2": "ai_id_2" } } EOF chmod 600 ~/.config/kindroid/credentials.json
# Send a message (uses default_ai) kindroid send "Hello! How are you today?" # Send to a specific companion kindroid send -to nickname1 "Hey there!" # Start fresh with a chat break kindroid break "Let's start a new conversation" # Check companion status kindroid status nickname1
If you manage multiple Kindroids, you can: Set conversation contexts per companion Route messages to specific AIs Maintain separate chat histories
The skill automatically handles: Minimum delays between messages (configurable) Maximum messages per minute Backoff on API errors
Auto-retry on network issues Graceful handling of API timeouts Clear error messages for troubleshooting
The skill provides a simple Node.js wrapper: const kindroid = require('./lib/kindroid'); // Initialize with your credentials const bot = new kindroid.Companion('nickname1'); // Send a message await bot.send('Hello!'); // Handle chat breaks await bot.break('New conversation');
For advanced integrations, set up webhooks: kindroid webhook add http://your-server.com/callback
Common issues and solutions: Authentication Failed Check if your API key starts with kn_ Verify file permissions on credentials.json Ensure no trailing whitespace in credentials Rate Limiting Default: 1 message per 3 seconds Adjust in ~/.config/kindroid/config.json Watch logs for rate limit warnings Timeout Errors Kindroids can take time to respond Default timeout: 60 seconds Increase with --timeout 120
This skill is open source. Improvements welcome: Fork the repo Make your changes Submit a PR with tests
Check for updates regularly: clawhub update kindroid-interact Built with ๐ by Lumen Lemon
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.