Skip to main content

​
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
​
title
string
required
Notification title.
​
body
string
required
Notification body text.
​
sound
boolean
default:"false"
Play the system notification sound.
​
urgency
string
default:"normal"
Urgency level: low, normal, critical. Affects display priority on Linux.
{
  "title": "Build Complete",
  "body": "Your TypeScript build finished successfully.",
  "sound": true
}
Platform support: macOS (via 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
​
region
object
Capture region: { x, y, width, height }. Omit for full screen.
​
display
number
default:"0"
Display index for multi-monitor setups.
Returns the screenshot as a base64-encoded PNG.
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
​
format
string
default:"text"
Content format: text, image.
Returns the clipboard text or a base64 PNG for image content.

​
clipboard_write

Write text to the clipboard. Security level: moderate | Tier: Full
​
text
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
​
action
string
required
Action type: send_message, react, create_channel.
​
channel
string
Channel ID or name.
​
text
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: 
// In a tool or plugin
// Do NOT block waiting for notification delivery
void notify({ title: "Job complete", body: result.summary });

Browser Tools

Take browser screenshots instead of system screenshots.

Sessions

Send results back to parent sessions rather than system notifications.