# Send KallyAI Executive Assistant (Claude Code) to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "kallyai-api",
    "name": "KallyAI Executive Assistant (Claude Code)",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/sltelitsyn/kallyai-api",
    "canonicalUrl": "https://clawhub.ai/sltelitsyn/kallyai-api",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/kallyai-api",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=kallyai-api",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "references/api-reference.md",
      "scripts/kallyai.py",
      "scripts/kallyai_call.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "kallyai-api",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-04T16:24:12.787Z",
      "expiresAt": "2026-05-11T16:24:12.787Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=kallyai-api",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=kallyai-api",
        "contentDisposition": "attachment; filename=\"kallyai-api-2.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "kallyai-api"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/kallyai-api"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/kallyai-api",
    "downloadUrl": "https://openagent3.xyz/downloads/kallyai-api",
    "agentUrl": "https://openagent3.xyz/skills/kallyai-api/agent",
    "manifestUrl": "https://openagent3.xyz/skills/kallyai-api/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/kallyai-api/agent.md"
  }
}
```
## Documentation

### KallyAI Executive Assistant

KallyAI is an AI executive assistant that handles outbound + inbound calls, email, bookings, research, bills, rides, food orders, errands, multi-channel messaging, and phone number management — all from the terminal.

### Quick Start

# The 80% command — natural language, routes automatically
python kallyai.py ask "Book a table at Nobu for 4 tonight"
python kallyai.py ask "Email Dr. Smith to reschedule my Thursday appointment"
python kallyai.py ask "Find the best plumber near me and negotiate a quote"

# Check credits (NOT minutes — credits are the sole billing unit)
python kallyai.py credits balance

# Check your inbox
python kallyai.py messages inbox

# View incoming calls handled by your AI receptionist
python kallyai.py inbound calls

### Step 1: Gather Intent

Determine what the user needs. KallyAI covers 14 domains:

DomainExamplesCoordination"Book a table", "Handle this for me", any multi-step requestCallsCall a business, check on a reservation, negotiateInboundView incoming calls, manage routing rules, voicemails, contactsPhoneProvision numbers, set up forwarding, manage caller IDActionsCalendar events, bookings, bill analysis, rides, food, errandsMessagesCheck inbox, read messages, view threadsSearchFind businesses, research options, compare pricesEmailSend emails, manage accounts, train voice profileChannelsManage WhatsApp, Telegram, email contacts, channel statusOutreachMulti-channel outreach tasks (call + email + messaging)BudgetEstimate costs, approve budgets, view breakdownsCreditsCheck balance, view history, spending breakdown, plansSubscriptionChange plan, view status, cancel pending changesReferralsGet referral code, view stats, track referrals

For most requests, use ask — it routes through the coordination AI automatically.

### Step 2: Authenticate

Authentication is automatic. First API call opens browser for Google/Apple sign-in.

python kallyai.py login         # Force re-auth
python kallyai.py logout        # Clear credentials
python kallyai.py auth-status   # Check login

### Step 3: Execute

Natural language (preferred):

python kallyai.py ask "Reserve a table for 4 at 8pm at Nobu"

Direct commands (when you know the domain):

python kallyai.py calls make -p "+15551234567" -t "Reserve table for 4 at 8pm"
python kallyai.py actions calendar create --title "Dinner" --start "2026-02-14T20:00"
python kallyai.py search run "best Italian restaurant downtown"
python kallyai.py inbound calls --status completed
python kallyai.py phone list

### Step 4: Monitor & Follow Up

# Check goal status
python kallyai.py coord goals --status active
python kallyai.py coord goal <GOAL_ID>

# Review outbound call results
python kallyai.py calls history
python kallyai.py calls info <CALL_ID>
python kallyai.py calls transcript <CALL_ID>

# Review inbound calls handled by AI receptionist
python kallyai.py inbound calls
python kallyai.py inbound call <CALL_ID>
python kallyai.py inbound transcript <CALL_ID>

# Check inbox for responses
python kallyai.py messages inbox --unread

### ask — Natural Language (80% of usage)

python kallyai.py ask "Your request in plain English"

Routes through coordination AI. Creates goals, makes calls, sends emails — whatever is needed.

### coord — Coordination & Goals

coord message "text"           # Chat with coordination AI
coord goals [--status X]       # List goals
coord goal <id>                # Goal details
coord goal-tree <id>           # Goal + sub-goals
coord cancel-goal <id>         # Cancel goal
coord cascade-cancel <id>      # Cancel goal + sub-goals
coord escalate <id>            # Escalate for attention
coord approve-step <id>        # Approve next step
coord accept <id>              # Accept outcome
coord continue <id>            # Continue negotiating
coord archive <id>             # Archive goal
coord batch-archive <id>...    # Archive multiple
coord budget <id>              # Goal budget details
coord history                  # Conversation history
coord conversations            # List conversations
coord new                      # New conversation

### calls — Outbound Phone Calls

calls make -p "+1..." -t "task"  # Make a call
calls history                     # List calls
calls info <id>                   # Call details
calls transcript <id>             # Transcript
calls recording <id>              # Recording URL
calls calendar <id>               # Calendar .ics
calls cancel <id>                 # Cancel call
calls reschedule <id>             # Reschedule
calls stop <id>                   # Stop active call

### inbound — AI Receptionist (Incoming Calls)

inbound calls [--status X]          # List incoming calls
inbound call <id>                    # Call details
inbound transcript <id>              # Call transcript
inbound recording <id>               # Call recording
inbound summary                      # Incoming call summary/stats
inbound analytics [--from X --to X]  # Call analytics
inbound transfer <id> --to "+1..."   # Transfer call
inbound takeover <id>                # Take over live call
inbound reject <id> [--reason X]     # Reject call
inbound rules                        # List routing rules
inbound add-rule --name "..." --action "..." # Create rule
inbound update-rule <id> ...         # Update rule
inbound delete-rule <id>             # Delete rule
inbound voicemails                   # List voicemails
inbound voicemail <id>               # Voicemail details
inbound voicemail-playback <id>      # Voicemail audio
inbound contacts                     # List contacts
inbound add-contact --name "..." --phone "+1..." # Add contact
inbound update-contact <id> ...      # Update contact
inbound delete-contact <id>          # Delete contact
inbound import-contacts <file>       # Import contacts
inbound events [--from X --to X]     # Event log

### phone — Phone Number Management

phone list                           # List your numbers
phone info <id>                      # Number details
phone countries                      # Supported countries
phone available --country US         # Search available numbers
phone provision --country US         # Provision new number
phone forwarding <id> --target "+1..." # Set call forwarding
phone remove-forwarding <id>         # Remove forwarding
phone verify-start <number>          # Start verification
phone verify-check <number> --code X # Check verification code
phone caller-id <id> --name "..."    # Set caller ID
phone release <id>                   # Release number

### actions — Autonomous Actions

actions calendar create --title "..." --start "..."
actions calendar slots [--date X]
actions calendar sync
actions calendar delete <id>
actions restaurant search "query" [--location X]
actions booking create --type restaurant [--date X]
actions booking cancel <id>
actions bill analyze "description" [--amount X]
actions bill dispute "description" [--reason X]
actions ride --pickup "..." --destination "..."
actions food "order description" [--address X]
actions errand "errand description"
actions email send --to "..." --subject "..." "body"
actions email approve <id>
actions email cancel <id>
actions email outbox
actions email replies <id>
actions log [--type X]
actions undo <id>

### messages — Unified Inbox

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

### search — Research

search run "query" [--location X]
search quick "query"
search history
search sources

### email — Email Account Management

email accounts                          # List connected
email connect gmail|outlook             # Connect provider
email disconnect <id>                   # Disconnect
email list [--classification important] # List messages
email read <id>                         # Read email
email respond <id> [instructions]       # Respond
email voice-profile                     # Get voice profile
email train-voice                       # Train from samples

### channels — Multi-Channel Management

channels status                  # All channel statuses
channels email-add <address>     # Add email contact
channels email-list              # List email contacts
channels email-update <id> ...   # Update email contact
channels email-delete <id>       # Delete email contact
channels email-verify <token>    # Verify email
channels mailbox                 # Get KallyAI mailbox address
channels connect <channel>       # Connect WhatsApp/Telegram
channels test <channel>          # Test channel connection
channels disconnect <channel>    # Disconnect channel

### outreach — Multi-Channel Outreach

outreach tasks [--status X]      # List outreach tasks
outreach task <id>               # Task details
outreach create --channel call --target "+1..." "description"
outreach retry <id>              # Retry failed task
outreach cancel <id>             # Cancel task

### budget — Cost Management

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

### credits — Balance & Usage

credits balance     # Current balance (credits, NOT minutes)
credits history     # Usage history
credits breakdown   # Spending breakdown by action type
credits costs       # Credit cost reference
credits plans       # Available credit plans

### subscription — Plan Management

subscription status               # Current plan status
subscription change-plan <plan>   # Change to new plan
subscription cancel-change        # Cancel pending plan change

### referrals — Referral Program

referrals code        # Get your referral code
referrals stats       # Referral statistics
referrals history     # Referral history

### notifications — Notifications

notifications pending   # Check pending notification counts

### Output Format

Default output is JSON (machine-readable for Claude Code). Add --human for formatted tables.

python kallyai.py credits balance              # JSON
python kallyai.py credits balance --human      # Pretty table

### Backward Compatibility

Old flags still work — they map to new subcommands:

python kallyai.py --phone "+1..." --task "..."   → calls make
python kallyai.py --usage                         → credits balance
python kallyai.py --history                       → calls history
python kallyai.py --call-info ID                  → calls info ID
python kallyai.py --transcript ID                 → calls transcript ID

### Security

Tokens stored in ~/.kallyai_token.json with 0600 permissions
Only localhost redirect URIs accepted for CLI auth
CSRF protection via state parameter
Tokens expire after 1 hour, auto-refresh supported

### Common Errors

CodeHTTPActionquota_exceeded402User needs more credits — kallyai.com/pricingmissing_phone_number422Ask user for phone numberemergency_number422Cannot call emergency servicescountry_restriction403Country not supportedbudget_exceeded402Goal over budget — approve or cancelemail_not_connected400Need to connect email account firstphone_not_provisioned400Need to provision a phone number first

### Full API Reference

See references/api-reference.md for complete endpoint documentation.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: sltelitsyn
- Version: 2.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-04T16:24:12.787Z
- Expires at: 2026-05-11T16:24:12.787Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/kallyai-api)
- [Send to Agent page](https://openagent3.xyz/skills/kallyai-api/agent)
- [JSON manifest](https://openagent3.xyz/skills/kallyai-api/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/kallyai-api/agent.md)
- [Download page](https://openagent3.xyz/downloads/kallyai-api)