核心功能与用法
KKClaw Server 是面向 Ubuntu/Raspbian 的 OpenClaw 无头版本,专为边缘设备与云端实例设计。核心工作流为:初始化配置 → 启动守护进程 → 与网关建立长连接 → 维持心跳与队列管理。用户通过 kkclaw-server init 生成配置后,可配置 systemd 服务实现开机自启。
显著优点
- 高可用设计:心跳机制(默认30s)+ 指数退避重连 + 会话自动恢复,三层容错保障边缘节点不掉线
- 零停机运维:热模型切换无需重启,失败自动回滚至备用模型,适合生产环境
- 资源友好:无GUI开销,树莓派即可运行,内存与运行时长持续上报
- 队列可靠性:断网时消息本地缓存,FIFO顺序恢复,避免请求丢失
潜在局限
- 依赖 Node.js 运行时环境,ARM 架构需确认预编译二进制可用性
- 配置为本地 JSON 文件,无集中式配置管理,多节点部署需手动同步
- 模型切换30秒超时在弱网环境可能触发误回滚
- 队列上限100条,高并发场景需评估容量
适合人群
- 需在树莓派/工控机部署 AI 代理的 IoT 开发者
- 构建分布式边缘推理网络的架构师
- 追求低运维成本的私有化 LLM 部署团队
常规风险
- API 密钥以明文存储于本地 JSON,需配合文件权限控制(建议600)
- 指数退避重连在网关故障时可能产生延迟堆积
- 自动恢复机制若与网关状态不一致,可能导致重复消息投递
- systemd 配置中
Restart=always在持续崩溃场景下可能形成重启风暴