Media Tool

Inspect GoClaw’s live media storage state so the agent can reason about capacity, cleanup risk, and where files should live.

Use media when you need to:

• check current store usage and global quota
• inspect one category such as keeper, uploads, or browser
• understand whether a directory is permanent or subject to cleanup
• see warning conditions before generating, downloading, or saving large files

Do not use this tool to show files to the user. Use media_display for that.

Actions

info

Return live media-store configuration, usage, and warnings.

{
  "action": "info"
}

Optional category focus:

{
  "action": "info",
  "category": "browser"
}

Optional warnings toggle:

{
  "action": "info",
  "includeWarnings": false
}

Output

The tool returns:

• a short natural-language summary
• normalized store metadata such as base directory, max file size, cleanup settings, and global quota
• per-category usage, file counts, permanence, TTL, and over-quota state
• warning lines when storage pressure exists

Category Guidance

• uploads and keeper are preserved and never auto-deleted
• browser, camera, generated, downloads, and voice are temporary categories that may be cleaned based on TTL and quota policy
• nested paths inherit the policy of their top-level category

See Also

• Message — Send files or mixed content to channels
• Internal Tools — Core agent tools
• Configuration — Media retention and storage settings