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 直接调用的系统级工具组,适合用于设备诊断、健康检查和远程恢复。
暴露给 LLM 的工具
Section titled “暴露给 LLM 的工具”| 工具 ID | 功能 | 输入参数 |
|---|---|---|
get_system_info | 返回系统信息;省略 sections 时返回完整汇总 | sections(可选,chip / uptime / memory / cpu / wifi / ip 数组) |
get_current_time | 返回格式化的当前本地时间;系统时钟无效时会先尝试 SNTP 同步 | (无) |
restart_device | 安排设备延迟重启 | delay_ms(可选,毫秒) |
返回结构说明
Section titled “返回结构说明”get_system_info省略sections时会组合多个子结构:memory、cpu、wifi、ip,并包含芯片与 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 同步。
restart_device 行为
Section titled “restart_device 行为”delay_ms可选,0或省略时使用默认延迟。目前,默认延迟为 500ms。- 重启是异步安排的:工具会先返回成功结果,再由后台任务执行
esp_restart()。 - 失败时会返回
ok: false和错误码字符串。
示例:
可能返回: