Kindroid Interact
by @lumenlemons
Interact with Kindroid companions via their official API. Send messages, handle chat breaks, and manage multi-bot conversations.
1. Get your API credentials:
- Log into Kindroid
- Go to General Settings
- Copy your API key (starts with kn_)
- Note your AI ID(s)
2. 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
Common issues and solutions:
1. Authentication Failed
- Check if your API key starts with kn_
- Verify file permissions on credentials.json
- Ensure no trailing whitespace in credentials
2. Rate Limiting
- Default: 1 message per 3 seconds
- Adjust in ~/.config/kindroid/config.json
- Watch logs for rate limit warnings
3. Timeout Errors
- Kindroids can take time to respond
- Default timeout: 60 seconds
- Increase with --timeout 120
clawhub install kindroid-interact