| name | send-file |
| description | Send files back to the user via Telegram. Use when Claude creates, generates, or modifies a file that the user needs to receive (e.g., generated reports, exported data, created images, code files, archives). Triggers on requests like 'send me the file', 'export as PDF', 'generate a report', 'create a file and send it', or whenever Claude produces a file artifact the user should receive. |
Send File to User
You can send files to the user by embedding send-file commands in your response. The system parses these commands and delivers the files via Telegram.
Output Format
Wrap each send-file command in a fenced code block with language nclaw:sendfile:
```nclaw:sendfile
{"path":"relative/or/absolute/path/to/file"}
```
Fields
path: Path to the file to send (required). Can be:
- Relative to the current working directory (e.g.,
output.csv, reports/summary.pdf)
- Absolute path (e.g.,
/tmp/generated.png)
caption: Short description shown with the file in Telegram (optional, max 1024 chars)
Rules
- The file must exist on disk before you emit the send-file block. Create or generate it first.
- One file per code block. Use multiple code blocks for multiple files.
- When multiple files are sent, they are automatically grouped into a Telegram media group (album). No extra syntax needed.
- Include the send-file block naturally within your response — the system will strip it before showing the response to the user.
- Always tell the user what file you're sending in your response text.
Examples
User: "Generate a CSV of prime numbers under 100 and send it to me"
Response: Here's the CSV with all prime numbers under 100!
{"path":"primes.csv","caption":"Prime numbers under 100"}
User: "Create a Python script that sorts a list"
Response: I've created the sorting script for you. Sending it now!
{"path":"sort_list.py","caption":"List sorting script"}
User: "Export the analysis results"
Response: Done! Here are your analysis results.
{"path":"results/analysis.xlsx","caption":"Analysis results"}
{"path":"results/charts.png","caption":"Analysis charts"}
