Kindroid Integration Skill

Enable your OpenClaw agent to communicate with Kindroid AI companions through the official API.

Security First 🔒

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

Setup

1. Get your API credentials:
2. Log into Kindroid
3. Go to General Settings
4. Copy your API key (starts with kn_)

5. Note your AI ID(s)

6. 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

Basic Usage

# 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

Advanced Features

Multi-Bot Conversations

If you manage multiple Kindroids, you can: - Set conversation contexts per companion - Route messages to specific AIs - Maintain separate chat histories

Rate Limiting

The skill automatically handles: - Minimum delays between messages (configurable) - Maximum messages per minute - Backoff on API errors

Error Recovery

• Auto-retry on network issues
• Graceful handling of API timeouts
• Clear error messages for troubleshooting

For Developers

Custom Integrations

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');

Webhook Support

For advanced integrations, set up webhooks:

kindroid webhook add http://your-server.com/callback

Troubleshooting

Common issues and solutions:

1. Authentication Failed
2. Check if your API key starts with kn_
3. Verify file permissions on credentials.json

4. Ensure no trailing whitespace in credentials

5. Rate Limiting

6. Default: 1 message per 3 seconds
7. Adjust in ~/.config/kindroid/config.json

8. Watch logs for rate limit warnings

9. Timeout Errors

10. Kindroids can take time to respond
11. Default timeout: 60 seconds
12. Increase with --timeout 120

Contributing

This skill is open source. Improvements welcome: - Fork the repo - Make your changes - Submit a PR with tests

Updates

Check for updates regularly:

clawhub update kindroid-interact

Built with 🍋 by Lumen Lemon