# Media and attachments

> Why a generated image or PDF was not delivered to chat

- 网址：https://funcoding.ai/agents/openclaw/help/faq/media-and-attachments/
- 来源：OpenClaw 官方文档原文（英文），MIT 许可，同步于 2026-10-11
- 官方原文：https://docs.openclaw.ai/zh-CN/help/faq/media-and-attachments

---
## Media and attachments

<details>
<summary>My skill generated an image/PDF, but nothing was sent</summary>

Outbound attachments from the agent must use structured media fields such as `media`, `mediaUrl`, `path`, or `filePath`. See [OpenClaw assistant setup](https://funcoding.ai/agents/openclaw/start/openclaw/) and [Agent send](https://funcoding.ai/agents/openclaw/tools/agent-send/).

```bash
openclaw message send --target +15555550123 --message "Here you go" --media /path/to/file.png
```

Also check: the target channel supports outbound media and is not blocked by allowlists; the file is within the provider's size limits (images resize to a max side of 2048px); `tools.fs.workspaceOnly=true` limits local-path sends to workspace, temp/media-store, and sandbox-validated files; `tools.fs.workspaceOnly=false` (default) lets structured local media sends use host-local files the agent can already read, for media plus safe document types (images, audio, video, PDF, Office docs, and validated text documents such as Markdown/MD, TXT, JSON, YAML/YML). This is not a secret scanner - an agent-readable `secret.txt` or `config.json` can be attached when the extension and content validation match. Keep sensitive files outside agent-readable paths, or keep `tools.fs.workspaceOnly=true` for stricter local-path sends.

See [Images](https://funcoding.ai/agents/openclaw/nodes/images/).

</details>