跳转到内容

cap_system — 系统信息、时间查询与设备重启

源码:cap_system.ccomponents/claw_capabilities/cap_system/src/cap_system.c · 头文件:cap_system.hcomponents/claw_capabilities/cap_system/include/cap_system.h

cap_system 提供设备运行状态和当前本地时间的统一查询入口,并提供可控的重启动作。它属于可被 LLM 直接调用的系统级工具组,适合用于设备诊断、健康检查和远程恢复。

工具 ID功能输入参数
get_system_info返回系统信息;省略 sections 时返回完整汇总sections(可选,chip / uptime / memory / cpu / wifi / ip 数组)
get_current_time返回格式化的当前本地时间;系统时钟无效时会先尝试 SNTP 同步(无)
restart_device安排设备延迟重启delay_ms(可选,毫秒)
  • get_system_info 省略 sections 时会组合多个子结构:memorycpuwifiip,并包含芯片与 uptime 字段。
  • sections 可用于只请求部分结构,例如 {"sections":["memory","wifi"]}
  • cpu 在未启用 FreeRTOS 运行时统计时,返回 supported: false 与说明消息。
  • wifi / ip 在未连网时会返回 connected: false 与空值字段。
  • get_current_time 返回格式为 YYYY-MM-DD HH:MM:SS TZ (weekday) 的本地时间;当系统时间早于 2024-01-01 时,会先尝试通过 SNTP 同步。
  • delay_ms 可选,0 或省略时使用默认延迟。目前,默认延迟为 500ms。
  • 重启是异步安排的:工具会先返回成功结果,再由后台任务执行 esp_restart()
  • 失败时会返回 ok: false 和错误码字符串。

示例:

{"delay_ms": 1500}

可能返回:

{"ok":true,"message":"device restart scheduled","delay_ms":1500}