名称： kallyai
描述： "KallyAI 行政助理 — 一款能代您处理电话（呼出+呼入）、邮件、预订、调研、跑腿、多渠道消息和电话号码管理的 AI。适用于以下场景：拨打/接听电话、管理呼入规则、处理语音邮件、配置电话号码、发送邮件、预订餐厅/酒店、搜索服务、管理日历、查看收件箱/消息、处理账单、订购外卖/打车、跑腿、查看积分/预算、协调目标、管理渠道（WhatsApp/Telegram/社交媒体）、开展推广活动、推荐或任何委托任务。"
元数据： {"clawdbot":{"emoji":"📞","requires":{"bins":["kallyai"]},"install":[{"id":"pip","kind":"pip","package":"kallyai-cli","bins":["kallyai"],"label":"通过 pip 安装"}]}}

KallyAI 行政助理

KallyAI 是一款 AI 行政助理，可处理呼出与呼入电话、邮件、预订、调研、账单、打车、外卖订购、跑腿、多渠道消息和电话号码管理。

快速开始

# 自然语言 — 自动路由（80% 的使用场景）
kallyai ask "今晚在 Nobu 预订一张 4 人桌"
kallyai ask "给 Smith 博士发邮件，重新安排我周四的预约"
kallyai ask "找到附近最好的水管工并协商报价"

# 查看积分（注意：不是分钟数 — 积分是唯一的计费单位）
kallyai credits balance

# 查看收件箱
kallyai messages inbox

# 查看由 AI 接待员处理的呼入电话
kallyai inbound calls

完整工作流程

步骤 1：收集意图

KallyAI 涵盖 14 个领域：

对于大多数请求，使用 ask — 它会通过协调 AI 自动路由。

步骤 2：身份验证

对于 OAuth 集成，将用户重定向至：

https://api.kallyai.com/v1/auth/authorize?response_type=code&client_id=YOUR_CLIENT_ID&redirect_uri=YOUR_REDIRECT_URI&scope=calls.write

用户使用 Google 或 Apple 登录 → 收到访问令牌。

对于 CLI，身份验证是自动的（首次 API 调用会打开浏览器）。

kallyai login         # 强制重新认证
kallyai logout        # 清除凭据
kallyai auth-status   # 检查登录状态

步骤 3：执行

自然语言（推荐）：

kallyai ask "在 Nobu 预订晚上 8 点 4 人桌"

直接命令（当您知道具体领域时）：

kallyai calls make -p "+15551234567" -t "预订晚上 8 点 4 人桌"
kallyai actions calendar create --title "晚餐" --start "2026-02-14T20:00"
kallyai search run "市中心最好的意大利餐厅"
kallyai inbound calls --status completed
kallyai phone list

步骤 4：监控与跟进

# 检查目标状态
kallyai coord goals --status active
kallyai coord goal <GOAL_ID>

# 查看呼出电话结果
kallyai calls history
kallyai calls info <CALL_ID>
kallyai calls transcript <CALL_ID>

# 查看由 AI 接待员处理的呼入电话
kallyai inbound calls
kallyai inbound call <CALL_ID>
kallyai inbound transcript <CALL_ID>

# 检查收件箱中的回复
kallyai messages inbox --unread

API 参考

基础 URL: https://api.kallyai.com

身份验证: Authorization: Bearer <access_token>

拨打电话 (API)

POST https://api.kallyai.com/v1/calls
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "submission": {
    "task_category": "general",
    "task_description": "询问商店营业时间和可用性",
    "respondent_phone": "+15551234567",
    "language": "en",
    "call_language": "en"
  },
  "timezone": "America/New_York"
}

响应:

{
  "call_id": "uuid",
  "status": "success",
  "highlights": "他们晚上 8 点有空位",
  "next_steps": "预订已确认"
}

状态值: success, no_answer, busy, failed, voicemail, cancelled

必填字段:

可选字段:

领域命令参考

ask — 自然语言 (80% 的使用场景)

kallyai ask "您的纯英文请求"

coord — 协调与目标

coord message "文本"           # 与协调 AI 聊天
coord goals [--status X]       # 列出目标
coord goal <id>                # 目标详情
coord goal-tree <id>           # 目标 + 子目标
coord cancel-goal <id>         # 取消目标
coord cascade-cancel <id>      # 取消目标及其子目标
coord escalate <id>            # 请求关注/升级
coord approve-step <id>        # 批准下一步
coord accept <id>              # 接受结果
coord continue <id>            # 继续协商
coord archive <id>             # 归档目标
coord batch-archive <id>...    # 归档多个目标
coord budget <id>              # 目标预算详情
coord history                  # 对话历史
coord conversations            # 列出对话
coord new                      # 新建对话

calls — 呼出电话

calls make -p "+1..." -t "任务"  # 拨打电话
calls history                     # 通话列表
calls info <id>                   # 通话详情
calls transcript <id>             # 通话文本记录
calls recording <id>              # 录音 URL
calls calendar <id>               # 日历 .ics 文件
calls cancel <id>                 # 取消通话
calls reschedule <id>             # 重新安排通话
calls stop <id>                   # 停止进行中的通话

inbound — AI 接待员 (呼入电话)

inbound calls [--status X]          # 列出呼入电话
inbound call <id>                    # 通话详情
inbound transcript <id>              # 通话文本记录
inbound recording <id>               # 通话录音
inbound summary                      # 呼入电话摘要/统计
inbound analytics [--from X --to X]  # 通话分析
inbound transfer <id> --to "+1..."   # 转接通话
inbound takeover <id>                # 接管进行中的通话
inbound reject <id> [--reason X]     # 拒接通话
inbound rules                        # 列出路由规则
inbound add-rule --name "..." --action "..."  # 创建规则
inbound update-rule <id> ...         # 更新规则
inbound delete-rule <id>             # 删除规则
inbound voicemails                   # 列出语音邮件
inbound voicemail <id>               # 语音邮件详情
inbound voicemail-playback <id>      # 语音邮件音频
inbound contacts                     # 列出联系人
inbound add-contact --name "..." --phone "+1..."  # 添加联系人
inbound update-contact <id> ...      # 更新联系人
inbound delete-contact <id>          # 删除联系人
inbound import-contacts <file>       # 导入联系人
inbound events [--from X --to X]     # 事件日志

phone — 电话号码管理

phone list                           # 列出您的号码
phone info <id>                      # 号码详情
phone countries                      # 支持的国家/地区
phone available --country US         # 搜索可用号码
phone provision --country US         # 配置新号码
phone forwarding <id> --target "+1..." # 设置呼叫转移
phone remove-forwarding <id>         # 移除呼叫转移
phone verify-start <number>          # 开始验证
phone verify-check <number> --code X # 检查验证码
phone caller-id <id> --name "..."    # 设置来电显示名称
phone release <id>                   # 释放号码

actions — 自主行动

actions calendar create --title "..." --start "..."
actions calendar slots [--date X]
actions calendar sync
actions calendar delete <id>
actions restaurant search "查询" [--location X]
actions booking create --type restaurant [--date X]
actions booking cancel <id>
actions bill analyze "描述" [--amount X]
actions bill dispute "描述" [--reason X]
actions ride --pickup "..." --destination "..."
actions food "订单描述" [--address X]
actions errand "跑腿描述"
actions email send --to "..." --subject "..." "正文"
actions email approve <id>
actions email cancel <id>
actions email outbox
actions email replies <id>
actions log [--type X]
actions undo <id>

messages — 统一收件箱

messages inbox [--channel email|sms|call|chat] [--unread]
messages read <id>
messages thread <conversation_id>
messages mark-read <id> [<id>...]

search — 调研

search run "查询" [--location X]
search quick "查询"
search history
search sources

email — 邮件账户管理

email accounts                          # 列出已连接的账户
email connect gmail|outlook             # 连接提供商
email disconnect <id>                   # 断开连接
email list [--classification important] # 列出邮件
email read <id>                         # 阅读邮件
email respond <id> [instructions]       # 回复邮件
email voice-profile                     # 获取语音配置文件
email train-voice                       # 根据样本训练

channels — 多渠道管理

channels status                  # 所有渠道状态
channels email-add <address>     # 添加邮件联系人
channels email-list              # 列出邮件联系人
channels email-update <id> ...   # 更新邮件联系人
channels email-delete <id>       # 删除邮件联系人
channels email-verify <token>    # 验证邮箱
channels mailbox                 # 获取 KallyAI 邮箱地址
channels connect <channel>       # 连接 WhatsApp/Telegram
channels test <channel>          # 测试渠道连接
channels disconnect <channel>    # 断开渠道连接

outreach — 多渠道推广

outreach tasks [--status X]      # 列出推广任务
outreach task <id>               # 任务详情
outreach create --channel call --target "+1..." "描述"
outreach retry <id>              # 重试失败的任务
outreach cancel <id>             # 取消任务

budget — 成本管理

budget estimate --type call "描述"
budget approve <goal_id>
budget breakdown <goal_id>
budget ack-cap <goal_id>

credits — 余额与使用情况

credits balance     # 当前余额（积分，不是分钟数）
credits history     # 使用历史
credits breakdown   # 按操作类型划分的支出明细
credits costs       # 积分成本参考
credits plans       # 可用积分套餐

subscription — 套餐管理

subscription status               # 当前套餐状态
subscription change-plan <plan>   # 更改为新套餐
subscription cancel-change        # 取消待处理的套餐更改

referrals — 推荐计划

referrals code        # 获取您的推荐码
referrals stats       # 推荐统计数据
referrals history     # 推荐历史

notifications — 通知

notifications pending   # 检查待处理通知数量

常见错误

安全

• 令牌存储: ~/.kallyai_token.json，权限为 0600
• CSRF 防护: 状态参数验证
• 仅限本地主机: OAuth 重定向仅限 localhost/127.0.0.1
• 自动刷新: 令牌过期时自动刷新