Triggers
Triggers let external events and schedules drive your KiloClaw agent automatically. Instead of typing every instruction yourself, triggers deliver messages to your agent on your behalf. This lets it react to real-world events or run tasks on a schedule without polling.
All triggers are managed from the Settings page in the KiloClaw section of the sidebar.
Webhook triggers and scheduled triggers use the same trigger concepts across KiloClaw and Cloud Agent, but target different agents. Use KiloClaw triggers when an HTTP event or schedule should deliver a chat message to a KiloClaw instance. Use Cloud Agent triggers when the automation should start a Cloud Agent session against a repository.
Trigger Types
| Type | Description |
|---|---|
| Webhooks | Receive HTTP requests from external services (GitHub, Stripe, monitoring tools, etc.) and deliver them as chat messages to your agent |
| Scheduled | Run tasks on a recurring schedule (e.g. every 15 minutes, daily at 9 AM, weekdays only) |
How Triggers Work
- A trigger fires
- Your prompt template is rendered into a message
- That message is delivered to your KiloClaw instance as a chat message
- Your agent processes and responds like any other conversation
Each trigger type has its own set of template variables. See the Webhooks and Scheduled pages for details.
When a trigger fires, the rendered message is sent directly to your KiloClaw agent as a prompt. If your instance is configured with a permission model that allows all actions, the agent will execute commands automatically without your explicit approval. This means triggers can cause your agent to take actions without you being aware. Review your instance's permission settings and prompt templates carefully before enabling triggers.
Request History
Trigger activity appears in request history so you can inspect recent webhook and scheduled invocations. History entries show the source (webhook or scheduled), status such as captured, in progress, success, or failed, request metadata, payload details when available, and links or sharing actions for the resulting session.