Getting Started

This guide is intentionally short. The old KIRA-Slack setup surface is no longer the main product path.

Use KiraClaw for fresh installs.

KiraClaw is designed around a lightweight local core engine with a small desktop harness around it. It is meant to feel like a local AI Coworker, not a large control platform.

1. Download

• macOS (Apple Silicon): Download KiraClaw for macOS
• Windows: Download KiraClaw for Windows

2. Install

macOS

1. Open the .dmg
2. Drag KiraClaw.app into Applications
3. Launch it

If macOS blocks first launch, see Troubleshooting.

Windows

1. Run the installer
2. Finish the setup wizard
3. Launch KiraClaw

3. Choose a workspace

KiraClaw uses a local filesystem base directory for:

• skills/
• memories/
• schedule_data/
• logs/

The current default workspace is typically under ~/Documents/KiraClaw.

4. Open the desktop app

Inside the app, start with:

• Talk
• Channels
• Skills
• Schedules
• Logs

5. Add an API key

Open Settings and add either:

• an Anthropic API key
• or an OpenAI API key

That is enough to start using Talk right away.

If you want the design context, KiraClaw is a fresh start inspired in part by OpenClaw, but with a smaller and more local product shape.

6. Optional: connect channels

The app currently supports:

• Slack
• Telegram
• Discord

Channel settings live in the desktop Channels screen.

7. Identity and persona

Set:

• your agent name
• persona text

in Settings > Identity.

8. Verify the runtime

The simplest smoke test is:

1. Open Talk
2. Ask a short question
3. Confirm that both internal summary and spoken reply appear

Migrating from KIRA-Slack

KIRA-Slack is now treated as legacy.

If you already used KIRA-Slack, KiraClaw can still reuse:

• ~/.kira/config.env
• ~/.kira/credential.json

That lets you move forward without rebuilding everything from scratch.