---
title: "DeepSeek"
description: "Set up DeepSeek as the brain behind your HolaClaw assistant. Get an API key, connect it, pick a model, and understand why it's so easy on your wallet."
updated: 2026-06-11
canonical: https://holaclaw.ai/docs/ai-providers/deepseek
---

DeepSeek is the value pick. Its models are genuinely capable — strong at reasoning, coding, and everyday conversation — yet the tokens they consume cost a small fraction of what an equivalent OpenAI or Anthropic tier would. If you want a smart assistant you can chat with all day without watching the meter, this is the one to try.

```provider-card
name: DeepSeek
company: DeepSeek
tagline: Remarkably capable models at a fraction of the usual price.
hue: 215
key-url: https://platform.deepseek.com/api_keys
key-label: platform.deepseek.com
auth: API key
cost: ¢
recommended: DeepSeek V4 Flash
```

The honest trade-off: DeepSeek is a hair less polished than the priciest frontier models. Now and then its English phrasing reads a touch off, or it takes a slightly odd turn. For the overwhelming majority of assistant conversations you won't notice — and the savings are real.

## What you'll need

- A DeepSeek account at [platform.deepseek.com](https://platform.deepseek.com).
- A payment method to add some balance — DeepSeek bills you for what you use.
- HolaClaw installed on your Mac.

Budget about five minutes.

## Get your API key

DeepSeek connects to HolaClaw with an **API key** — a long secret code that tells DeepSeek the requests are coming from your account. Think of it as a password your assistant uses on your behalf. Anyone holding it can spend your balance, so keep it private.

1. Sign in at [platform.deepseek.com](https://platform.deepseek.com).
2. Open the [API keys](https://platform.deepseek.com/api_keys) page and create a new key. Name it something you'll recognize later, like "HolaClaw".
3. Copy the key right away — it's shown in full only once. If you lose it, just create a fresh one.
4. While you're there, add a little balance to your account. Without it, requests fail even when the key itself is valid.

## Connect it to your assistant

You pick the provider while creating an assistant, in **Step 2 · Model provider** — the screen that says "Connect the brain behind your assistant."

1. In HolaClaw, start the **Create Assistant** flow and go to Step 2.
2. Choose **DeepSeek** in the provider sidebar.
3. Paste your key into the **DeepSeek API Key** field. It's masked like a password, which is normal.
4. Pick a model (more on that below) and continue with the rest of the setup.

As the app notes right below the key field: "Your credentials stay on your Mac — we never send them anywhere." The key lives inside the assistant's private virtual machine on your Mac. HolaClaw's servers never see it, and DeepSeek bills you directly — HolaClaw adds nothing on top.

> **Heads-up — where your messages go.** DeepSeek is a Chinese company, and your conversations are processed on its servers. That's no different in kind from any cloud provider, but if data residency matters to you, it's worth knowing so you can make your own call. If you'd rather keep everything on your own machine, see [local models](/docs/ai-providers/local-models).

## Choosing a model

HolaClaw offers two DeepSeek models:

| Model | Best for | Speed | Cost |
| --- | --- | --- | --- |
| **DeepSeek V4 Flash** (recommended) | Everyday chat, journaling, planning, writing | Fast | Tiny |
| **DeepSeek V4 Pro** | Stronger reasoning, harder multi-step tasks | Slower | Still small |

**DeepSeek V4 Flash** is the recommended default and the right pick for almost everyone — quick, responsive, and more than smart enough for a daily companion, a travel planner, or a writing partner.

**DeepSeek V4 Pro** thinks harder. Reach for it when your assistant regularly tackles genuinely tough problems — deeper reasoning, intricate planning, demanding analysis. It's slower and a bit pricier, though by DeepSeek's standards "pricier" is still very gentle.

> **Tip — when in doubt, Flash.** The model choice is per-assistant, made at creation time. If you later decide you want the other one, create a new assistant with it — your existing assistant keeps the brain it was born with.

## What it costs

DeepSeek charges per **token** — roughly a short word or word-fragment of text. Every message you send and every reply your assistant writes consumes some, and your balance ticks down accordingly. There's no monthly fee: you pay only for what you use.

Here's the headline: DeepSeek's per-token prices are low enough that a chatty daily assistant runs you pennies per week. You can talk to it freely without thinking about the bill. We don't quote exact figures here — they change — but you'll find current rates on the [DeepSeek platform](https://platform.deepseek.com).

## Troubleshooting

When something goes wrong with the connection to DeepSeek, HolaClaw shows a banner in the chat explaining what happened. Here's what each one means:

- **"DeepSeek is out of credits"** — your balance hit zero. Top up at [platform.deepseek.com](https://platform.deepseek.com) and your assistant resumes on the next message.
- **"DeepSeek API key is invalid, expired, or out of credits"** — the key was revoked, mistyped, or the account can't pay. Create a fresh key at platform.deepseek.com and update it in the assistant's settings, or top up your balance.
- **"DeepSeek rate limit or quota reached"** — you're sending requests faster than your account allows. Wait a little and try again.
- **"DeepSeek is currently unreachable"** — DeepSeek's servers are having a moment. Nothing to fix on your end; the next attempt goes through once their service recovers.

Still stuck? The [HolaClaw Discord](https://discord.gg/FbxAbS5sGQ) is a friendly place to ask.

## Next steps

Not sure DeepSeek is the right brain for this assistant? Compare all the options in [Choosing an AI provider](/docs/ai-providers/choosing-a-provider) — and remember you can always create another assistant with a different one. If privacy is your main reason for being here, [local models](/docs/ai-providers/local-models) keep everything on your Mac. Questions? Come say hi in the [HolaClaw Discord](https://discord.gg/FbxAbS5sGQ).