| name | desktop-screenshot-reply |
| description | Capture the current desktop and send the screenshot back into chat in OpenClaw. Use when the user asks for a desktop screenshot, current screen capture, or wants the screen image returned in the conversation. Works with a local screenshot helper command that returns a file path, then emits a standalone MEDIA:/absolute/path line for OpenClaw media delivery. |
| metadata | {"openclaw":{"emoji":"🖼️","requires":{"env":["OPENCLAW_SCREENSHOT_CMD"]},"install":[{"id":"manual-env","kind":"manual","label":"Set OPENCLAW_SCREENSHOT_CMD to a local screenshot helper that prints an absolute image path"}]}} |
desktop-screenshot-reply
Use this skill to capture the current desktop and return the image to the user in chat.
Workflow
- Run
scripts/take_and_print_media.sh.
- Read stdout.
- Reply briefly to the user.
- Put the emitted
MEDIA: line in the reply on its own line exactly as returned.
Expected script contract
The screenshot helper must:
- be executable on the local host
- capture the current desktop when called with no required interactive input
- print the absolute output file path to stdout
- exit non-zero on failure
The bundled script validates the returned path and then prints:
MEDIA:/absolute/path/to/file.png
Configuration
Preferred configuration:
export OPENCLAW_SCREENSHOT_CMD=/absolute/path/to/your/screenshot-helper
Fallback default if the environment variable is not set:
/home/why/.openclaw/workspace/bin/desktop-screenshot
Treat that fallback as a convenience for the original author environment, not as a portable default.
Rules
- Do not alter the
MEDIA: line.
- Do not wrap the
MEDIA: line in markdown or code fences.
- Keep the surrounding reply short.
- If the script fails, report failure plainly instead of inventing a path.