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

导读：想让你的 Kimi Bot 运行在本地 OpenClaw 网关上吗？本指南从零开始，手把手教你配置 kimi-claw 插件，实现 Kimi Bot 与本地 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），需要编译。先安装构建工具：

bash 复制代码

sudo apt-get install -y build-essential

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

常见错误：

go 复制代码

npm build error: not found: make

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

步骤 2：安装 kimi-claw 插件

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

bash 复制代码

bash <(curl -fsSL https://cdn.kimi.com/kimi-claw/install.sh) --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

成功输出示例：

css 复制代码

[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。

检查待批准的配对请求：

bash 复制代码

openclaw devices list

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

arduino 复制代码

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

使用请求 ID 批准：

bash 复制代码

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

步骤 4：重启 Gateway

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

bash 复制代码

openclaw gateway restart

验证连接日志：

bash 复制代码

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

你应该看到：

ini 复制代码

[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：测试验证

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

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

📁 安装文件位置

路径	说明
`~/.openclaw/extensions/kimi-claw/`	插件安装目录
`~/.openclaw/openclaw.json`	OpenClaw 配置（token 存储在此）
`~/.kimi/kimi-claw/kimi-claw-config.json`	本地同步配置（如有）
`~/.kimi/kimi-claw/log/`	安装失败日志
`/tmp/openclaw/openclaw-<date>.log`	实时 gateway 日志

🔧 故障排查

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

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

解决方案：

bash 复制代码

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

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

原因：缺少构建工具。

解决方案：

bash 复制代码

sudo apt-get install -y build-essential

然后重新运行安装脚本。

问题 3：查看实时日志

bash 复制代码

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

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

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

bash 复制代码

bash <(curl -fsSL https://cdn.kimi.com/kimi-claw/install.sh) --bot-token <YOUR_BOT_TOKEN>

📖 常用命令参考

命令	说明
`openclaw gateway status`	检查 gateway 运行状态
`openclaw gateway restart`	重启 gateway 服务
`openclaw plugins list`	列出所有插件及状态
`openclaw devices list`	列出已配对和待批准的设备
`openclaw devices approve <id>`	批准待批准的配对请求
`openclaw devices remove <id>`	移除已配对设备

💡 最佳实践

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，便于快速重建

🎯 下一步

配置完成后，你可以：

集成其他插件 ：探索 ClawHub 上的其他技能（clawhub search）
配置自动化 ：使用 Cron jobs 定时任务（openclaw cron add）
多 Agent 协作：设置 Sub-agents 处理专业任务
监控告警：配置 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

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

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