▋
docs/qa/live-gates.md

Clanky Live Gates

These checks touch real services or credentials. Run the non-live checks first:

cd /path/to/clanky-pi
pnpm check
pnpm smoke

Do not paste tokens into chat or docs. Prefer the interactive login commands where available because they store credentials in the active profile's auth.json with 0600 permissions.

OpenAI Model Auth

Required for normal Clanky model use, OpenAI web search/media tools, and Discord voice Realtime.

clanky --home ~/.clanky --profile personal

Inside Clanky:

/openai-login
/openai-whoami

Expected result: /openai-login validates the key, /openai-whoami reports the stored credential source, and a normal prompt can complete with the configured Pi model.

Agent-Owned Discord Text

Required for Clanky's own Discord identity and Discord subagent path.

clanky --home ~/.clanky --profile personal

Inside Clanky:

/discord-login
/discord-whoami

Restart Clanky after login. Then run:

/discord-status

Expected result: the text bridge is active when CLANKY_CHAT_GATEWAY_OWNER is unset or agent, and Clanky responds only to DMs, mentions, replies, configured conversation IDs, or accepted wake-name follow-ups.

Discord Voice

Required for live voice join, speaker transcription, spoken output, Pi delegation from voice, and optional Discord Go Live watching.

Use discord-voice-live-runbook.md (same directory). It covers bot-token audio, user-token Go Live, OpenAI Realtime speech, and ElevenLabs speech.

Minimum credential set:

  • Discord bot token or stored /discord-login credential.
  • OpenAI API key or stored /openai-login credential.
  • For ElevenLabs speech only: ELEVENLABS_API_KEY, CLANKY_ELEVENLABS_API_KEY, or stored /elevenlabs-login, plus CLANKY_ELEVENLABS_VOICE_ID or the TUI voice setting.

Linear

Required only when the installed Linear MCP, CLI, or skill is used for live Linear issue creation, comments, or status updates.

LINEAR_API_KEY=... clanky --home ~/.clanky --profile personal

Expected result: the Linear integration can create or update the issue, then work_tracker_link can persist the tracker ref. If tracker credentials or tools are unavailable, Clanky should report the skipped tracker update explicitly rather than pretending it happened.

xAI Media

Required only for xAI image/video tools.

XAI_API_KEY=... clanky --home ~/.clanky --profile personal

Expected result: media_backend_status shows xAI image/video backends as configured and media-generation prompts can call the relevant tool.