MyClaws Logo MyClaws

Trigger

用 Cron 表达式或 Webhook 让 Agent 自动开工；调用 TypeScript / Python / C# SDK 接入 GitHub Actions 等外部系统。

最近更新 · Mon Jun 22 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

本页目录 8
  1. 什么场景适合用 Trigger
  2. 新建一个 Trigger 的两条路径
  3. Cron Trigger 的字段
  4. Webhook Trigger 与 secret 管理
  5. SDK 集成方式
  6. 执行历史与手动触发
  7. 时区、凭据与资源边界
  8. 相关

Trigger

一句话总结：Trigger 让 Agent 按时间或外部事件自动启动会话；Cron 适合巡检，Webhook 适合 CI / 外部系统集成。

什么场景适合用 Trigger

  • 凌晨自动跑代码质量巡检。
  • GitHub Actions 完成后触发 Agent 处理结果。
  • 自有系统通过 HTTP 调用 Agent 完成轻量任务。

新建一个 Trigger 的两条路径

  1. Trigger 管理页 → 新建。
  2. 选择「Cron」或「Webhook」。
  3. Cron：填表达式 + 目标 Claw + Agent + 初始指令；Webhook：复制生成的 URL。
  4. 保存后查看执行历史确认运行情况。

Cron Trigger 的字段

  • cron：标准 cron 表达式（5 段：分 时 日 月 周）
  • clawId：目标 Claw
  • agentId：要使用的 Agent
  • initialMessage：会话首条指令
  • timezone：建议显式指定（默认 UTC）

例：0 2 * * * + Agent「代码质量巡检」+ Claw「云主机」+ 指令「检查代码质量并写报告」。

Webhook Trigger 与 secret 管理

  • 创建后系统生成一个 8 位 webhookId 与 webhookSecret。
  • 公开 URL：https://myclaws.weid.fun/api/webhooks/<webhookId>
  • HTTP POST 触发时校验 secret，再通过 Claw WS 代理拉起会话。
  • 完成后可向 callback_url 发送回调（包含会话产出摘要）。

SDK 集成方式

packages/agent-client-sdk/ 提供 TypeScript / Python / C# SDK，封装：

  • 鉴权
  • Webhook 触发
  • 完成回调监听

参见仓库内 agent-client-sdk/ts|python|csharp/README.md。

执行历史与手动触发

每次触发会留下执行记录：触发时间、Claw、Agent、状态、产出对话 ID。可在 Trigger 详情页查看。 每个 Trigger 都支持「Manual Fire」按钮（Mobile 端也有），便于联调。

时区、凭据与资源边界

Cron 表达式时区

不显式指定时区时按 UTC 计算；与本地时间会有偏差。

Webhook secret 是敏感信息

不要把它放进公开仓库；定期轮换。

Trigger 会话默认不挂载 MCP

避免凭据语义混乱。需要 MCP 时请在配置里显式声明。

长时间运行的 Trigger 也算 conversation

它会消耗 Agent / Claw 资源；准时率指标 cron 偏差 ≤ 1s。

相关

继续阅读