Kindroid 集成技能

启用你的 OpenClaw agent，通过官方 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": "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

基础用法

# 发送消息（使用 default_ai）
kindroid send "Hello! How are you today?"

# 发送给指定伙伴
kindroid send -to nickname1 "Hey there!"

# 以聊天断点方式开启全新对话
kindroid break "Let's start a new conversation"

# 查看伙伴状态
kindroid status nickname1

高级功能

多 Bot 对话

若你管理多个 Kindroid 实例，可实现：

• 为每个伙伴独立设置对话上下文
• 将消息定向路由至特定 AI
• 维护彼此隔离的聊天历史

速率限制

该技能自动处理以下策略：

• 消息发送间的最小延迟（支持配置）
• 每分钟最大消息数
• 在 API 错误时自动退避重试

错误恢复

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

面向开发者

自定义集成

本技能提供简洁的 Node.js 封装接口：

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

// 使用凭证初始化
const bot = new kindroid.Companion('nickname1');

// 发送消息
await bot.send('Hello!');

// 触发聊天断点
await bot.break('New conversation');

Webhook 支持

如需高级集成，可配置 Webhook：

kindroid webhook add http://your-server.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 使用 🍋 构建