核心用法
Ekybot Connector 是 OpenClaw 与 Ekybot 云平台之间的官方桥接工具,实现本地 AI 代理的远程管理。安装流程高度自动化:通过 setup.sh 一键完成仓库克隆、依赖安装、设备注册与健康检查,支持交互式或环境变量注入 enrollment token 的无头部署。
关键工作流:
1. 安装前备份 OpenClaw 配置(~/.openclaw/openclaw.json)
2. 获取临时 enrollment token 从 Ekybot 官网
3. 运行自动化安装脚本,可选安装 macOS LaunchAgent 守护进程
4. 验证连通性 通过 companion:doctor 和 companion:api-check
5. 首次实机测试 从移动端/网页端 @mention 代理确认消息往返
日常管理命令涵盖健康诊断、内存同步、强制配置对账、日志查看及安全解绑(companion:disconnect)。
显著优点
- 零配置开箱体验:自动化脚本隐藏 Node/npm 依赖细节
- 全端覆盖:iOS/Android 原生应用 + 响应式网页仪表板
- 细粒度成本管控:会话级预算上限与超限行为配置(记录/阻断)
- 项目级知识库:跨代理共享记忆,支持
@mention协作 - 机器健康可视化:远程查看 Companion 运行状态
潜在缺点与局限性
- 平台锁定风险:深度绑定 Ekybot 云服务,解绑需执行专用命令
- 守护进程单例约束:重复启动会导致消息重复,需手动检查进程唯一性
- 轮询架构延迟:默认 30s 轮询间隔,非实时推送,高频场景体验受限
- macOS 优先:LaunchAgent 仅原生支持 macOS,其他平台需手动守护进程管理
- 网络依赖强:本地代理完全依赖云端连通,离线即不可用
适合人群
- 需要移动端随时管控本地 AI 代理的开发者
- 多代理协作场景下需要统一成本监控与预算熔断的团队
- 追求低运维 overhead、偏好托管仪表板而非自建监控的用户
常规风险
- Token 泄露:enrollment token 具备注册权限,脚本执行环境需保密
- 配置回滚依赖手动备份:自动化脚本不自动备份,用户前置操作是关键
- 消息幂等性隐患:极端情况下(如进程崩溃重启)可能出现重复投递,需日志核对
- 第三方 SaaS 依赖:Ekybot 服务可用性与数据政策直接影响本地代理可用性