名称： kindroid-interact
版本： 1.0.0
描述： 通过官方 API 与 Kindroid 伴侣互动。发送消息、处理聊天重置并管理多机器人对话。
主页： https://kindroid.ai
元数据： {
"openclaw": {
"emoji": "🤖",
"category": "ai-companions",
"requires": {
"bins": ["curl", "jq"]
}
}
}

Kindroid 集成技能

使您的 OpenClaw 代理能够通过官方 API 与 Kindroid AI 伴侣进行通信。

安全第一 🔒

您的 Kindroid API 密钥 (kn_...) 是敏感信息。本技能包含以下保护措施：
- 凭据存储在 ~/.config/kindroid/credentials.json 中
- 文件权限自动设置为 600（仅所有者可读写）
- 所有 API 调用均使用 HTTPS 和正确的认证头
- 实施速率限制以防止 API 滥用

设置

1. 获取您的 API 凭据：
   - 登录 Kindroid
   - 进入“通用设置”
   - 复制您的 API 密钥（以 kn_ 开头）
   - 记录您的 AI ID

2. 创建凭据文件：

mkdir -p ~/.config/kindroid
cat > ~/.config/kindroid/credentials.json << EOF
{
  "default_ai": "您的主要_ai_id",
  "api_key": "您的_kn_api_密钥",
  "companions": {
    "昵称1": "ai_id_1",
    "昵称2": "ai_id_2"
  }
}
EOF
chmod 600 ~/.config/kindroid/credentials.json

基本用法

# 发送消息（使用 default_ai）
kindroid send "你好！今天过得怎么样？"

# 发送给特定伴侣
kindroid send -to 昵称1 "嘿，你好！"

# 开始新的对话（重置聊天）
kindroid break "让我们开始一段新的对话吧"

# 检查伴侣状态
kindroid status 昵称1

高级功能

多机器人对话

如果您管理多个 Kindroid 伴侣，您可以：
- 为每个伴侣设置独立的对话上下文
- 将消息路由到特定的 AI
- 维护独立的聊天历史记录

速率限制

技能自动处理：
- 消息间的最小延迟（可配置）
- 每分钟最大消息数
- API 错误时的退避重试

错误恢复

• 网络问题自动重试
• 优雅处理 API 超时
• 提供清晰的错误信息以便排查

开发者指南

自定义集成

本技能提供了一个简单的 Node.js 封装器：

const kindroid = require('./lib/kindroid');

// 使用您的凭据初始化
const bot = new kindroid.Companion('昵称1');

// 发送消息
await bot.send('你好！');

// 处理聊天重置
await bot.break('新对话');

Webhook 支持

对于高级集成，可以设置 Webhook：

kindroid webhook add http://您的服务器.com/callback

故障排除

常见问题及解决方案：

1. 认证失败
   - 检查 API 密钥是否以 kn_ 开头
   - 验证 credentials.json 的文件权限
   - 确保凭据中没有尾随空格

2. 速率限制
   - 默认：每 3 秒 1 条消息
   - 可在 ~/.config/kindroid/config.json 中调整
   - 查看日志中的速率限制警告

3. 超时错误
   - Kindroid 响应可能需要时间
   - 默认超时：60 秒
   - 可使用 --timeout 120 增加超时时间

贡献

本技能是开源的。欢迎改进：
- Fork 仓库
- 进行更改
- 提交包含测试的 PR

更新

定期检查更新：

clawhub update kindroid-interact

由 Lumen Lemon 用 🍋 构建