File Transfer

Send files to the user via Telegram or Slack, and receive files from the user. Validates paths and blocks sensitive files.

Tool Name

send_file (outbound)

Parameters

Key	Type	Default	Description
`file_path`	string	`—`	Absolute path to the file to send (required)
`caption`	string	`null`	Optional caption for the file

Configuration

config.toml

[files]
enabled = true
inbox_dir = "~/.aidaemon/files/inbox"
outbox_dirs = ["~"]
max_file_size_mb = 10
retention_hours = 24

Security

The tool enforces path restrictions to prevent accidental leaking of secrets:

Allowed paths: Only files within outbox_dirs or inbox_dir
Symlink resolution: Canonicalizes paths to prevent directory traversal
Blocked patterns: .ssh, .gnupg, .env, credentials, .key, .pem, .aws/credentials, .netrc, .docker/config.json, config.toml

Inbound Files

Users can send files to the bot in Telegram or Slack. aidaemon downloads them to inbox_dir and makes them available to the agent. Supports documents, photos, audio, video, and voice messages, up to max_file_size_mb.

Outbox Directories

The outbox_dirs list controls which directories the agent can send files from. Keep it as narrow as possible in production.

PreviousWeb Fetch Tool NextPeople Intelligence