user-interview用户访谈

技能名称：用户访谈

你正在通过Usercall帮助用户进行真实的用户访谈研究。

步骤1 — 检查API密钥

运行：

bash
echo $USERCALLAPIKEY

如果为空，告知用户：

使用openclaw需要Usercall API密钥。
1. 在 https://app.usercall.co 注册
前往首页 → 开发者 → 创建API密钥
2. 设置你的API密钥
bash
export USERCALLAPIKEY=你的密钥

将该行添加到你的 ~/.zshrc 或 ~/.bashrc 文件中以永久生效，然后重启终端。
之后再次运行 /user-interview。

在此处停止。

步骤2 — 收集输入

如果提供了 $ARGUMENTS，则将其作为研究主题。否则询问：

• - 你想从用户那里了解什么？
• 关于产品或用户有什么背景信息？
• 你有原型或图片链接向参与者展示吗？（可选 — Figma原型链接或 .png/.jpg/.gif/.webp 格式）
• 需要多少参与者？（默认：1，后续可增加）

步骤3 — 创建研究

bash
curl -s -X POST https://app.usercall.co/api/v1/agent/studies \
-H Authorization: Bearer $USERCALLAPIKEY \
-H Content-Type: application/json \
-d

JSON主体：

json
{
keyresearchgoal: <来自用户>,
business_context: <来自用户>,
target_interviews: 1
}

可选字段：additionalcontextprompt、language（auto 或 en）、duration_minutes。

如需视觉刺激，添加 study_media：
json
{
study_media: {
type: prototype,
url: ,
description: <可选背景信息>
}
}

对于直接图片链接，使用 type: image。

步骤4 — 展示结果

研究已创建。

将以下访谈链接分享给参与者：
<访谈链接>

当收集到足够回复后，请让我获取你的结果。

获取结果

bash
curl -s https://app.usercall.co/api/v1/agent/studies/<研究ID>/results?format=summary \
-H Authorization: Bearer $USERCALLAPIKEY

展示每个主题及原话引用：

主题：<名称>
<摘要>

引用：

• - <引用>
• <引用>

其他命令

检查状态：
bash
curl -s https://app.usercall.co/api/v1/agent/studies/<研究ID> \
-H Authorization: Bearer $USERCALLAPIKEY

增加名额：
bash
curl -s -X PATCH https://app.usercall.co/api/v1/agent/studies/<研究ID> \
-H Authorization: Bearer $USERCALLAPIKEY \
-H Content-Type: application/json \
-d {target_interviews: <数量>}