ClawdTalk Persona Plugin — Persona Plugin — 通话者记忆管理

您可以使用持久的通话者记忆系统。用它来记住您与谁在通话，并在过程中对每个人有更深入的了解。

使用时机

• 每次外呼之前: 使用 persona_get_caller 加载上下文，然后将 prompt_context 作为 purpose 参数传递给 clawtalk_call
• 每次通话结束: 使用 persona_log_call 保存通话记录，然后使用 persona_update_docs 保存您了解到的关于通话者的信息

三个工具，按顺序使用：get → log → update。

工具

persona_get_caller

参数:

• phone (必填) — E.164格式（例如 +15551234567）

返回:

• found — 此通话者是否存在于系统中
• prompt_context — 预编译的文本块，在发起通话时作为 purpose 传递
• persona.soul — 他们的沟通风格和个性
• persona.identity — 事实信息（姓名、家庭、偏好）
• persona.memory — 过去通话中的情景记忆
• recent_calls — 最近3次通话及摘要

当 found 为 false 时，这是一个全新的通话者。介绍您自己并了解他们。

persona_log_call

在每次通话结束时使用此工具。 记录通话元数据。

参数:

• phone (必填) — E.164格式
• summary (必填) — 通话中发生了什么。要具体：讨论的话题、做的决定、表达的情绪、提到的后续事项
• purpose — 通话的原因（例如 "check-in"、"appointment reminder"）
• duration_seconds — 通话持续时间
• direction — "inbound" 或 "outbound"
• call_id — ClawdTalk通话ID。如果提供，后端会自动获取完整转录本

persona_update_docs

在 persona_log_call 后立即使用此工具。 您是LLM — 从对话中提取观察结果并保存到这里。

参数:

• phone (必填) — E.164格式
• soul (可选) — 沟通风格和个性观察。只在注意到他们如何沟通的某些方面时包含。变化缓慢。

{"style": "warm, patient", "pace": "slow", "humor": "dry, appreciates puns"}

• identity (可选) — 您了解到的 factual 信息。随着时间累积。

{"name": "Margaret", "nickname": "Maggie", "family": {"daughter": "Susan"}, "likes": ["gardening", "tea"]}

• memory (可选) — 来自本次通话的情景笔记，按今天的日期键控。

{"2026-03-21": "Talked about new rose bushes. Doctor appointment next Tuesday. Susan hasn't called in a while."}

每次更新都会创建一个新版本 — 旧版本永远不会丢失。

典型通话流程

1. 拨打电话之前
   └─► 使用通话者电话号码调用 persona_get_caller
   └─► 如果找到：从结果中获取 prompt_context
   └─► 如果未找到：这是新的人
发起通话
   
└─► 使用以下参数调用 clawtalk_call:
       - to: 电话号码
       - purpose: 步骤1中的 prompt_context
       - greeting: 基于您了解到的信息定制问候语
通话期间
   
└─► 进行自然的对话
   └─► 不需要工具 — 只需交谈
通话结束 — 两个步骤:
   
步骤A: 记录通话
   └─► 使用以下参数调用 persona_log_call:
       - 电话号码
       - 你们讨论内容的摘要
       - clawtalk_call 结果中的 call_id
   步骤B: 更新人格（立即执行）
   └─► 使用以下参数调用 persona_update_docs:
       - 电话号码
       - soul: 任何个性/风格观察（可选）
       - identity: 任何了解到的新事实（可选）
       - memory: 来自本次通话的情景笔记（始终包含）

重要说明

• 电话号码必须使用E.164格式：+15551234567（带国家代码）
• 始终在 clawtalk_call 之前调用 persona_get_caller，这样您可以将人格上下文作为 purpose 传递
• 始终在通话结束时调用 persona_log_call 和 persona_update_docs — 先记录，然后更新
• persona_log_call 工具会在通话者不存在时自动创建他们
• 对于 memory，始终按今天的日期键控条目（例如 "2026-03-21": "..."）
• 对于 identity，与您已了解的信息合并 — 不要重复已有事实，添加新的
• 对于 soul，只在注意到关于他们沟通风格的真正新事物时更新
• 如果Persona API无法访问，工具将返回错误 — 通话仍可继续进行