ProfileClaw
简历机会执行台定价
ProfileClaw
ProfileClawCareer Graph OS
ProfileClaw 数据层

一次构建,让上下文在所有智能体里持续工作。

ProfileClaw 会把测评、材料和长期上下文整理好,再交给 OpenClaw、Claude Work、Nanobot 等产品继续调用,让 AI 带着记忆行动,而不是每次冷启动。

© 2026 ProfileClaw。保留所有权利。

沪ICP备2026012738号

【工业和信息化部】尊敬的用户路承龙,您的ICP备案申请已通过审核,备案/许可证编号为:沪ICP备2026012738号,审核通过日期:2026-04-09。特此通知!【工信部ICP备案】

产品

  • 首页
  • 测评
  • 报告
  • 简历
  • 机会执行台
  • 定价
  • 关于

测评

  • 测评
  • RIASEC
  • 工作风格
  • 职业价值观
  • 优势与天赋
  • 协作与冲突
  • 压力与调节
  • 表达风格
  • 当前状态脉冲

开发者

  • 开发者中心
  • 文档
  • 快速开始
  • API 文档
  • Agents
  • 集成

我的

  • 我的
  • 报告
  • 机会执行台
  • 求职偏好
  • 简历
  • 购买与点数
  • API Keys
  • 认证
查看快速开始查看快速开始,了解 ProfileClaw 如何接入文档、API 与 Agent 工作流。
开始使用创建账户并开始测评,先沉淀一份 AI 可以长期调用的个人能力档案。
系统运行正常
首页定价文档隐私政策服务条款
首页测评报告我的
ProfileClaw 文档
首页
定价
Agents 总览Agent 快速开始Agent 鉴权缓存闭环架构重试Agent Webhooks指南总览测评指南集成总览OpenClaw 集成
文档AgentsWebhooks

Agent Webhooks

在正确时刻唤醒工作流,而不是无限轮询

webhook 真正有价值的时刻,是工作流需要在稍后的用户或系统事件发生后继续执行。它应该触发 fresh read 和确定性续跑,而不是变成神秘的第二事实源。

Format: AI-first docs
Source: DocsAgentsWebhooksPage
信息

如果工作流还不是真异步,就不要急着上 webhook。

起步阶段轮询更简单;只有当时机和连续性变成产品要求时,webhook 才会真正值得。

Webhook 职责

把事件当成触发器,而不是把它当成完整业务 payload。

Trigger

事件告诉 runtime:有变化发生,某条工作流可能需要恢复。

  • 用 profile 和 assessment 事件唤醒正确任务。
  • 在 runtime 里保持事件路由显式。
  • 不要把业务逻辑塞进投递层。

Re-fetch

收到投递后,先从正式 API 表面重新读取状态,再做动作。

  • 让 webhook 决定何时拉取,而不是盲信它本身。
  • 动作前重新读取 context 或更窄端点。
  • 让续跑保持幂等,重复投递也无害。

Operations

订阅必须可见、有归属,而且能被清理。

  • 记录哪条工作流拥有哪个 webhook URL。
  • 在模型循环之外审计订阅。
  • 流程退役时删除旧订阅。

把 webhook 用在续跑,而不是基础读取上

当 agent 需要在稍后某个事件发生后继续工作时,webhook 才最有意义。对简单只读流程,它通常不是必需的。

  • 在事件模型未证明前,早期集成仍以直接读取为主。
  • 当用户进展或系统变化需要定时跟进时,再用 webhook。
  • 优先使用显式的 continuation flow,而不是隐藏式后台逻辑。

每次投递都应配对一次 fresh read

事件 payload 更适合唤醒工作流;真正的用户动作判断,最好还是基于最新正式状态完成。

  • 让事件负责路由工作流,而不是取代数据层。
  • 在 runtime 代码和日志里显式保留幂等设计。
  • 保存足够元信息,方便排查重复或延迟投递。

Webhook 对比

只有当事件驱动明显优于直接轮询时,才值得进入。

模式最适合不适合
直接读取简单 request-response 流和第一版集成。工作流必须在未来外部事件后恢复。
轮询在事件模型尚未稳定时做短期过渡检查。流程开始变得浪费或对时机敏感。
Webhooks需要确定性唤醒行为的长时流程。你还没有明确事件归属和重新拉取计划。

决策矩阵

用这些规则判断什么时候该切到 webhook 设计。

情况

工作流可以在一次交互内完成

动作

继续使用直接读取。

原因

引入事件基础设施只会增加复杂度。

情况

工作流需要在稍后用户进展后继续

动作

创建 webhook 订阅,并在投递时重新拉取状态。

原因

这是恢复流程并保持数据新鲜度的最干净方式。

情况

出现重复或延迟投递

动作

让续跑保持幂等,并记录每次投递尝试。

原因

事件系统的可靠性来自重复安全,而不是来自绝不重复。

Webhook 生命周期示例

显式创建订阅,再通过 runtime tooling 列出或检查它们。

创建订阅
1curl -X POST "https://profileclaw.cn/api/v1/webhooks" -H "Authorization: Bearer $PROFILECLAW_API_KEY" -H "Content-Type: application/json" -d '{"url":"https://example.com/profileclaw/webhooks","events":["profile.updated","assessment.completed"]}'
列出订阅
1curl "https://profileclaw.cn/api/v1/webhooks" -H "Authorization: Bearer $PROFILECLAW_API_KEY"

下一步

事件模型清楚后,再去验证精确契约和失败分支。

查看 Webhooks API
查看 Error Types
打开 Reference