Overview
Integration tools let the agent interact with the host system beyond the filesystem: send native OS notifications, read/write the clipboard, and capture screenshots. These tools are in the Full tier and primarily useful for desktop deployments.Tools
notify
Send a native operating system notification.
Security level: moderate | Tier: Standard
string
required
Notification title.
string
required
Notification body text.
boolean
default:"false"
Play the system notification sound.
string
default:"normal"
Urgency level:
low, normal, critical. Affects display priority on Linux.osascript), Linux (via notify-send), Windows (via PowerShell toast).
screen_capture
Capture a screenshot of the entire screen or a specific region.
Security level: moderate | Tier: Full
object
Capture region:
{ x, y, width, height }. Omit for full screen.number
default:"0"
Display index for multi-monitor setups.
On macOS, screen capture requires Screen Recording permission in System Settings > Privacy & Security.
clipboard_read
Read the current clipboard contents.
Security level: moderate | Tier: Full
string
default:"text"
Content format:
text, image.clipboard_write
Write text to the clipboard.
Security level: moderate | Tier: Full
string
required
Text to write to the clipboard.
Channel-Specific Notification Tools
For sending messages through chat channels rather than system notifications, profClaw provides channel-specific action tools:slack_actions
Send messages, react to messages, or create channels in Slack.
Tier: Full | Requires: Slack provider configured
string
required
Action type:
send_message, react, create_channel.string
Channel ID or name.
string
Message text.
discord_actions
Send messages or create threads in Discord.
Tier: Full | Requires: Discord provider configured
telegram_actions
Send messages, photos, or documents via Telegram.
Tier: Full | Requires: Telegram provider configured
Async Notification Pattern
Notifications from background jobs should be dispatched asynchronously to avoid blocking:Related Tools
Browser Tools
Take browser screenshots instead of system screenshots.
Sessions
Send results back to parent sessions rather than system notifications.