Kimi Bot + OpenClaw 完整配置指南：5 步实现本地 AI Agent 集成

Kimi Bot + OpenClaw 完整配置指南：5 步实现本地 AI Agent 集成

前置条件

开始之前，确保你满足以下条件：

• 操作系统：Linux（Ubuntu/Debian 系）
• Node.js：v18+ 和 npm
• OpenClaw CLI：已安装（openclaw 命令在 PATH 中）
• Kimi Bot Token：从 www.kimi.com/bot 获取（sk-... 格式）

步骤 1：安装构建工具

kimi-claw 插件包含一个原生 Node.js 模块（node-pty），需要编译。先安装构建工具：

sudo apt-get install -y build-essential

这会安装 gcc、g++、make 等必要工具。

常见错误：

npm build error: not found: make

解决方案：运行上面的 apt-get 命令安装构建工具。

步骤 2：安装 kimi-claw 插件

运行官方安装脚本，传入你的 bot token：

bash <(curl -fsSL ) --bot-token <YOUR_BOT_TOKEN>

将 <YOUR_BOT_TOKEN> 替换为你的 token（如 sk-XXXXXXXXXXXX）。

安装脚本会执行：

• 下载插件包到 ~/.openclaw/extensions/kimi-claw
• 运行 npm install 编译原生依赖
• 在 OpenClaw 中注册并启用插件
• 将 token 存储到 ~/.openclaw/openclaw.json
• 设置默认 prompt 超时为 30 分钟（1800000ms）
• 尝试重启 gateway

成功输出示例：

[install-oss] downloading package
[install-oss] staging main plugin
[install-oss] installing dependencies in staging dir
[install-oss] registering plugin
[install-oss] plugin config updated
[install-oss] prompt timeout set to 1800000ms
[install-oss] main plugin installed successfully
[install-oss] restarting gateway
[install-oss] done

步骤 3：批准设备配对（关键！）

安装完成后，kimi-claw 插件会注册为本地 gateway 的一个设备并等待批准。如果跳过这步，插件会反复报错 handshake rejected: pairing required。

检查待批准的配对请求：

openclaw devices list

你应该看到一个名为 kimi-bridge-connector 的 Pending 条目：

Pending (1)
┌──────────────────────────────────────┬────────────────────────────┬──────────┐
│ Request                              │ Device                     │ Role     │
├──────────────────────────────────────┼────────────────────────────┼──────────┤
│ c9fb9b18-0dad-498e-b530-1caba20d8156 │ kimi-bridge-connector      │ operator │
└──────────────────────────────────────┴────────────────────────────┴──────────┘

使用请求 ID 批准：

openclaw devices approve c9fb9b18-0dad-498e-b530-1caba20d8156

步骤 4：重启 Gateway

批准配对后，重启 gateway 让插件用新 token 重新连接：

openclaw gateway restart

验证连接日志：

tail -30 /tmp/openclaw/openclaw-$(date +%Y-%m-%d).log | grep kimi-bridge

你应该看到：

[kimi-bridge] [gateway] handshake complete
[kimi-bridge] local gateway connected url=ws://127.0.0.1:18789 (acp adapter mode)
[kimi-bridge] [bridge-acp] connected
[kimi-bridge] bridge ACP connected url=wss://www.kimi.com/api-claw/bots/agent-ws

步骤 5：测试验证

1. 打开 www.kimi.com/bot
2. 给你的 bot 发送一条消息
3. 你应该收到通过本地 OpenClaw gateway 路由的回复

成功标志：消息从你的本地网关处理，而不是 Kimi 云端。

安装文件位置

故障排查

问题 1：插件卡在 "pairing required"

原因：设备 token 在 gateway 启动前未批准。

解决方案：

openclaw devices list        # 找到 pending 请求 ID
openclaw devices approve <REQUEST_ID>
openclaw gateway restart

问题 2：npm 构建错误 not found: make

原因：缺少构建工具。

解决方案：

sudo apt-get install -y build-essential

然后重新运行安装脚本。

问题 3：查看实时日志

tail -f /tmp/openclaw/openclaw-$(date +%Y-%m-%d).log | grep kimi-bridge

问题 4：重新运行安装（升级或修复）

安装脚本是幂等的——重新运行会覆盖安装插件，同时保留现有配置：

bash <(curl -fsSL ) --bot-token <YOUR_BOT_TOKEN>

常用命令参考

最佳实践

1. 安全性建议

• Token 保护：~/.openclaw/openclaw.json 包含敏感 token，确保文件权限为 600
• 网络隔离：建议在 VPS 或隔离环境中运行，避免暴露在公网
• 日志审计：定期检查 /tmp/openclaw/openclaw-*.log 查看异常连接

2. 性能优化

• 超时设置：默认 30 分钟超时适合大多数场景，如需调整可修改配置
• 资源监控：使用 openclaw gateway status 监控内存和 CPU 使用
• 日志轮转：定期清理旧日志文件，避免磁盘占用过高

3. 备份策略

• 配置备份：定期备份 ~/.openclaw/openclaw.json
• 插件备份：复制 ~/.openclaw/extensions/kimi-claw/ 到安全位置
• 快速恢复：保存安装命令和 token，便于快速重建

下一步

配置完成后，你可以：

1. 集成其他插件：探索 ClawHub 上的其他技能（clawhub search）
2. 配置自动化：使用 Cron jobs 定时任务（openclaw cron add）
3. 多 Agent 协作：设置 Sub-agents 处理专业任务
4. 监控告警：配置 Heartbeat 定期检查系统健康

版本信息：

• OpenClaw: v2026.3.2
• kimi-claw: v0.12.2
• 更新日期：2026-03-06

参考资料：

• OpenClaw 官方文档：docs.openclaw.ai
• ClawHub 技能市场：clawhub.ai
• Kimi Bot 平台：www.kimi.com/bot

遇到问题？在评论区留言，我会尽快回复！