
KiloClaw Triggers 触发器完整指南用 Webhook 与定时任务驱动 AI Agent 自动化【免费下载链接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kilocodeKiloClaw 是 Kilo 旗下的托管式 OpenClaw 服务其完整背景见 KiloClaw 概览。Triggers触发器是 KiloClaw 的自动化入口它允许外部 HTTP 事件表单提交、GitHub Push、监控告警、电商订单、IoT 传感器数据等或你预先定义的 cron 调度来驱动 Agent 自动工作而不是每次手动输入指令。读完本指南你将掌握 KiloClaw 中 Webhook 与定时两类触发器的完整配置流程、prompt 模板语法、安全管理手段以及如何借助请求历史排查自动化任务的运行状况。注意根据仓库中 kiloclaw-eol.md 的说明KiloClaw 已不再面向新用户开放产品支持正在结束本文档仅作为现有用户参考保留。以下内容以仓库内当前文档与源码为准。触发器是什么在 KiloClaw 中触发器Triggers让外部事件和计划调度自动驱动你的 Agent。你不必逐条输入指令触发器会代替你向 Agent 投递消息使它能够响应真实世界的事件或在无需轮询polling的情况下按时执行任务。所有触发器都在侧边栏KiloClaw区域的Settings页面中统一管理包括创建、编辑、暂停、恢复、轮换与删除等操作。触发器与 Cloud Agent 的关系Webhook 触发器和定时触发器在 KiloClaw 与 Cloud Agent 之间共享同一套触发器概念但目标不同当 HTTP 事件或调度需要向某个 KiloClaw 实例投递一条聊天消息时使用KiloClaw 触发器当自动化需要针对某个仓库启动一个 Cloud Agent 会话时使用Cloud Agent 触发器。两者的 prompt 模板、触发语义一致区别仅在于消息的投递目标。触发器类型类型说明Webhooks接收来自外部服务GitHub、Stripe、监控工具等的 HTTP 请求将其作为聊天消息投递给你的 AgentScheduled定时按周期性调度例如每 15 分钟、每天上午 9 点、仅工作日执行任务触发器的工作原理无论哪种类型触发器的处理流程都遵循同一套流水线触发器被触发fire你的prompt 模板prompt template被渲染成一条消息该消息作为聊天消息投递到你的 KiloClaw 实例你的 Agent 像处理任何普通对话一样处理并响应这条消息。每种触发器类型拥有各自的模板变量集合。Webhook 变量详见 Webhooks 文档定时触发器变量详见 Scheduled 文档。安全警示触发器会直接把 prompt 发给 Agent⚠️ 当触发器被触发时渲染出的消息会直接作为 prompt 发送给你的 KiloClaw Agent。如果你的实例配置了允许所有动作的权限模型Agent 将无需你显式批准就自动执行命令。这意味着触发器可能在你不知情的情况下让 Agent 采取行动。在启用触发器之前请务必审查实例的权限设置和 prompt 模板。从仓库中的 Exec Approvals 文档可以看到权限模型的具体机制默认安全策略是deny拒绝所有主机执行请求你必须显式配置 allowlist白名单后 Agent 才能独立执行主机命令只有设置为fullAllow Everything策略时Agent 才能执行任意命令而无需提示。因此保持默认deny或严格维护 allowlist是安全启用触发器的重要前提。Webhook 触发器详解KiloClaw 支持入站 Webhook外部事件可以借此自动触发你的 Agent。任何能发送 HTTP 请求的服务——表单提交、告警、日历更新、电商订单、IoT 传感器数据——都能发起与 Agent 的对话。当 Webhook 被触发时payload 会经过 prompt 模板渲染并作为聊天消息投递到你的 KiloClaw 实例Agent 的处理方式与你亲手输入完全一致。设置 Webhook进入侧边栏KiloClaw区域的Settings找到Webhook Integration卡片点击Manage点击Set Up Webhook。KiloClaw 会为你的实例生成一个唯一的 Webhook URL。将其复制并配置到你想接收事件的服务GitHub、Stripe、监控工具等中作为目的地。将 URL 视为机密⚠️ Webhook URL 包含128 bits 的熵它本身就是一种凭证与 Slack Webhook URL 类似。任何持有该 URL 的人都可以向你的实例发送消息。请勿将其提交到公开仓库或在公开渠道分享。128 位熵意味着该 URL 的不可猜测性足以充当密钥不要把它当作普通地址对待泄露即等于开放了向你的 Agent 投递任意消息的通道。Webhook 的工作流程外部服务向你的 Webhook URL 发送 HTTP POST 请求Webhook worker 校验请求可选地检查认证payload 通过你的prompt 模板渲染见下文渲染后的消息作为聊天消息投递到你的 KiloClaw 实例你的 Agent 像处理普通对话一样接收并响应消息。Prompt 模板Prompt 模板控制 Webhook payload 以何种形式呈现给 Agent你可以在 Settings 的Webhook Integration区域自定义它。默认模板You received a webhook event. Here is the payload: {{bodyJson}}可用变量变量说明{{body}}原始请求体raw request body{{bodyJson}}美化排版后的 JSON 请求体{{method}}HTTP 方法例如POST{{headers}}请求头{{path}}请求路径{{query}}查询字符串参数{{timestamp}}Webhook 被接收的时间你可以根据业务需要定制模板给 Agent 更多上下文。例如A GitHub push event just arrived. Summarize the changes and open a PR if any tests are affected. Payload: {{bodyJson}}管理 WebhookWebhook 设置完成后Settings 中的Webhook Integration卡片提供如下控制能力暂停与恢复Pause and Resume切换Active/Paused开关即可在不删除 URL 的情况下临时停止接收 Webhook。暂停期间传入请求会被拒绝随时恢复以重新开始接收。轮换 URLRotate URL如果你的 Webhook URL 泄露点击Rotate URL即可生成一个新 URL。该操作会立即作废旧 URL因此你需要随后在集成方更新为新 URL。轮换前会显示确认对话框。Webhook 认证可选为了额外安全你可以要求入站请求携带一个共享密钥请求头。当发送方服务支持 Webhook 签名时这一层很有用打开Webhook Authentication开关设置Secret Header名称默认值x-webhook-secret输入Shared Secret值点击Save。缺少该请求头或提供错误 secret 的请求会被拒绝。说明认证是可选的。Webhook URL 本身已经是凭证128 位熵认证只是增加第二层防护仅在发送方服务要求或支持时才需要启用。查看 Webhook 活动KiloClaw Webhook 也会出现在Cloud下的Webhooks页面只读。在那里你可以点击View Captured Requests查看最近的 payload、响应码和耗时这对于排查集成问题非常有用。实战GitHub Push 通知在 KiloClaw Settings 中设置一个 Webhook进入你的 GitHub 仓库打开Settings Webhooks Add webhook将 KiloClaw Webhook URL 粘贴为Payload URL将Content type设为application/json选择要触发的事件例如Just the push event点击Add webhook。此后每次 push 都会向你的 Agent 发送 payload。配合自定义 prompt 模板你可以让 Agent 汇总提交summarize commits、运行检查run checks、通知频道或做任何你想做的事。更完整的 GitHub 集成方式可参考 GitHub 集成文档。定时触发器详解定时触发器让 Agent 按照你通过 cron 表达式定义的时间自动执行任务。与等待外部事件不同定时触发器在指定时间触发触发后 prompt 模板会被渲染并作为聊天消息投递到 KiloClaw 实例——流程与 Webhook 完全一致。设置定时触发器进入侧边栏KiloClaw区域的Settings找到Scheduled Triggers区域点击Add Scheduled Trigger为触发器命名至少 8 个字符配置调度与 prompt 模板点击Save。配额限制每个 KiloClaw 实例支持最多 5 个定时触发器外加 1 个 Webhook。配置调度调度构建器默认提供友好的选择器视图。需要更精细的控制时点击 Advanced切换到原始 cron 输入。简单模式默认通过下拉菜单选择频率、时间以及可选一周中的星期几。构建器会在后台为你生成 cron 表达式并预览接下来 5 次运行时间。Repeat每 10 分钟、每 15 分钟、每 30 分钟、每小时、每天、每周At选择一天中的时刻适用于每天/每周频率Day of week选择触发日适用于每周频率。高级模式点击 Advanced直接输入原始 cron 表达式获得对调度的完全控制。表达式会实时校验并预览未来的触发时间。cron 表达式采用标准的五字段格式┌───────── minute (0-59) │ ┌───────── hour (0-23) │ │ ┌───────── day of month (1-31) │ │ │ ┌───────── month (1-12) │ │ │ │ ┌───────── day of week (0-7, where 0 and 7 are Sunday) │ │ │ │ │ * * * * *示例表达式含义*/15 * * * *每 15 分钟0 9 * * 1-5工作日上午 9:000 0 1 * *每月 1 日午夜30 14 * * 3每周三 14:30注意定时触发器的最小间隔为10 分钟。比这更频繁的调度会被拒绝。时区为调度选择时区默认值为UTC。所有触发时间都相对于所选时区计算并且自动处理夏令时DST转换。Prompt 模板Prompt 模板控制调度触发时 Agent 收到的消息内容可在触发器的设置中自定义。默认模板Run your scheduled task. Triggered at {{scheduledTime}}.可用变量变量说明{{scheduledTime}}调度触发的时间ISO 字符串{{timestamp}}捕获时间戳ISO 字符串注意由于定时触发器不接收 HTTP 请求{{body}}、{{bodyJson}}、{{headers}}、{{method}}、{{path}}、{{query}}等 Webhook 变量不会被填充。请改用{{scheduledTime}}和{{timestamp}}。管理定时触发器暂停与恢复切换Active/Paused开关临时停止触发器。暂停时调度被挂起但配置被保留随时可恢复编辑可随时更新已有定时触发器的 cron 表达式、时区和 prompt 模板。注意激活模式webhook 还是 scheduled在创建后不能更改删除在 Settings 面板的内联控件中删除定时触发器删除前会显示确认对话框。查看定时触发器活动定时触发器的调用记录与 Webhook 出现在同一请求历史中。Source列会显示Scheduled徽标以区分 Webhook 触发的请求。点击请求可查看调度触发时间等详细信息。实战每日站会摘要创建一个每个工作日早晨触发、要求 Agent 汇总隔夜活动的定时触发器在 KiloClaw Settings 中添加一个定时触发器将频率设为Weekly选择Monday through Friday时间为本地时区的9:00 AM自定义 prompt 模板Good morning! Please summarize any overnight activity in the #engineering Slack channel and list open pull requests that need review today. Triggered at {{scheduledTime}}.之后你的 Agent 会在每个工作日 9:00 收到这条消息并回复摘要。请求历史Request History触发器活动会出现在请求历史中你可以借此检查近期的 Webhook 与定时调用。历史条目会展示来源sourcewebhook 或 scheduled状态statuscaptured已捕获、in progress进行中、success成功或 failed失败请求元数据request metadatapayload 详情可用时结果会话的链接或分享操作。请求历史是排查触发器明明触发了但 Agent 没反应这类问题的一线工具先确认请求是否被捕获captured、渲染是否成功、投递后会话状态如何再决定是否调整模板或权限设置。底层实现与仓库佐证从仓库源码与文档可以进一步印证触发器的运行机制与周边能力调度任务在 OpenClaw 中的实现根据 Control UI 概览OpenClaw 网关内置Cron Jobs能力——可在 Control UI 中创建、编辑、启用/禁用、立即运行并查看定时任务历史。KiloClaw 的定时触发器正是运行在这一调度基础设施之上的其调度语义与 OpenClaw 的 cron 机制一致。安全模型兜底Exec Approvals 定义了deny默认、allowlist、full三种安全策略以及askoff/on-miss/always与askFallback默认deny的行为。触发器投递的消息最终由 Agent 按该权限模型执行命令——这正是触发器文档反复警示先审查权限设置的原因。触发器配置的持久性在 Dashboard 参考文档 与 常见问题 中明确Redeploy 不会删除你的文件、git 仓库或 cron 作业——触发器配置保存在持久化存储中重部署仅相当于更新并重启。入口统一触发器消息与普通聊天共用同一套对话处理链路这解释了文档中反复出现的Agent 像处理任何普通对话一样响应的表述——触发器本质上只是消息投递通道的自动化而不是独立的执行引擎。相关文档Webhooks 触发器定时触发器KiloClaw 概览Dashboard 参考Exec Approvals执行审批GitHub 集成连接聊天平台【免费下载链接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kilocode创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考