# Sellbird: tự tìm khách, viết và gửi cold email bằng gói Claude — hướng dẫn cài đặt và dùng

> Sellbird (trước đây tên Harvey) là nền tảng mã nguồn mở viết bằng Python, giúp tự động hoá cả quy trình bán hàng qua email lạnh: tìm khách, kiểm tra email, viết thư, gửi và xử lý thư trả lời. Nó chạy bằng gói Claude Pro/Max hoặc ChatGPT có Codex nên không tính tiền theo token. Cài không quá khó nếu bạn quen terminal, nhưng cần thêm hộp thư gửi và bước khởi động (warmup) hộp thư đó.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-05-28 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/sellbird-tu-dong-tim-khach-gui-cold-email-bang-claude-7

Sellbird là một công cụ mã nguồn mở chạy ngay trên máy bạn, làm trọn quy trình bán hàng qua email lạnh (cold email): tìm các công ty có thể cần sản phẩm của bạn, tìm người ra quyết định, kiểm tra địa chỉ email, viết thư riêng cho từng người, gửi đi rồi xử lý thư trả lời. Trước đây dự án tên là Harvey, nay đổi tên thành Sellbird, vẫn là cùng một dự án và cùng lịch sử.

Bạn nên xem nếu bạn là chủ doanh nghiệp nhỏ, người làm sales hoặc làm marketing và đang tự gõ từng email chào hàng bằng tay. Lập trình viên mới cũng dùng được, vì có một cách cài gần như "nói chuyện" với Claude để nó dẫn bạn đi.

Điều đáng giá nhất là hai chuyện. Thứ nhất, Sellbird suy nghĩ qua Claude Code CLI trên gói Claude Pro hoặc Max (hoặc Codex trên gói ChatGPT), nên không cần API key của mô hình và không bị tính tiền theo token. Thứ hai, mặc định không có email nào được gửi đi nếu bạn chưa bấm duyệt. Hiện repo có khoảng 5.250 sao và 1.127 fork, được cập nhật trong vài tháng gần đây. Bạn có thể xem video ngắn bên dưới để hình dung trước khi cài.

```repo
- repo | ethanplusai/sellbird
- kind | Ứng dụng
- desc | Sellbird tìm công ty và người quyết định, kiểm tra email, viết cold email cá nhân hoá, gửi đi và xử lý thư trả lời, chạy bằng gói Claude hoặc ChatGPT bạn đang có.
- stars | 5.3k
- lang | Python
- license | AGPL-3.0
```

```video
- youtube | https://youtube.com/shorts/JTq4Uz5waNI
- facebook | https://www.facebook.com/reel/2017725532236661
- title | Video giới thiệu sellbird
```

## Sellbird làm được gì

Sellbird là một dây chuyền nhiều công đoạn. Bạn có thể chạy hết, hoặc dừng ở bước nào cũng được.

### Tìm công ty phù hợp

Nó tìm các doanh nghiệp giống khách hàng lý tưởng của bạn. Nguồn mặc định là OpenStreetMap, miễn phí và không cần tài khoản. Nếu muốn nguồn trả phí, bạn tự chọn, và mỗi lần tìm trả phí đều hiện chi phí trước khi chạy. Nhờ vậy bạn không bị "cháy túi" bất ngờ.

### Tìm lý do họ sẽ mua

Sellbird đọc website của từng công ty để tìm các tín hiệu mua hàng mà bạn đã xác nhận, ví dụ: chưa có đặt lịch online, đang chạy quảng cáo, hay đang tuyển một vị trí nào đó. Bước này không gọi mô hình và không tốn tiền, theo README chỉ cần ba request HTTP cho mỗi công ty. Lợi ích thực tế: email của bạn có thể mở đầu bằng một lý do cụ thể thay vì câu chào chung chung.

### Tìm người quyết định

Nó tìm chủ hoặc quản lý được nêu tên trên chính các trang của công ty, tối đa hai người mỗi công ty. Bạn không phải mua thêm công cụ dữ liệu liên hệ. README nói rõ không dùng Apollo, ZoomInfo, Clearbit hay Clay.

### Kiểm tra địa chỉ email

Sellbird học cách đặt email của công ty đó rồi kiểm tra một địa chỉ. Mỗi địa chỉ được gắn nhãn: verified, risky, guess hoặc invalid. Chỉ những địa chỉ gửi được mới được gửi thư. Điều này giúp bạn tránh gửi vào địa chỉ sai, một nguyên nhân làm hộp thư bị đánh giá xấu.

### Viết và gửi

Nó viết một chuỗi email ngắn cho từng người dựa trên những gì tìm được. Sau đó gửi từ hộp thư Gmail, Microsoft 365 hoặc SMTP của bạn, trong giới hạn số thư mỗi ngày và theo giờ làm việc của người nhận.

### Xử lý thư trả lời

Sellbird đọc mọi thư trả lời, soạn sẵn câu đáp, tách riêng thư tự động trả lời, tôn trọng yêu cầu ngừng nhận thư ngay lập tức, và chuyển cho bạn những thư nó không nên tự trả lời.

Ngoài ra, nếu bạn chỉ cần danh sách khách hàng tiềm năng, có thể dừng sau bước kiểm tra email và chạy `sellbird export` để lấy file CSV đưa vào công cụ gửi thư khác.

## Cần chuẩn bị gì

Theo README, bạn cần:

- **Python 3.11 trở lên.** File `pyproject.toml` cũng yêu cầu `>=3.11`. README lưu ý macOS đời máy cài sẵn Python 3.9, nên nếu `python3 --version` báo 3.9 thì chạy `brew install python@3.13` trước.
- **Claude Pro hoặc Max** và đã đăng nhập Claude Code CLI bằng `claude login`. Hoặc **gói ChatGPT có Codex CLI**, có hướng dẫn riêng trong tài liệu của repo.
- **Một hộp thư để gửi.** README khuyên dùng Google Workspace trên một tên miền gửi riêng. Microsoft 365 và SMTP cũng dùng được. Chi phí tham khảo trong README là khoảng 7 USD mỗi tháng cho Google Workspace.
- **Warmup (làm nóng) hộp thư đó.** Tác giả giới thiệu TrulyInbox cho việc này. Theo README, các liên kết TrulyInbox trong dự án là liên kết affiliate. Đây chỉ là gợi ý của tác giả, không bắt buộc về mặt kỹ thuật.
- **Git** để tải mã về (cách cài trong README bắt đầu bằng `git clone`).

Về hệ điều hành, README nêu đường dẫn thư mục dữ liệu cho macOS, Windows và Linux, và nói thêm rằng trên Linux có thể chạy bằng Docker. README không viết hướng dẫn riêng cho Windows ở phần cài đặt nên nếu bạn dùng Windows, hãy đọc kỹ tài liệu Troubleshooting trong thư mục `docs/` của repo.

Tệp `.env.example` liệt kê các biến cấu hình cho từng nhà cung cấp (Gmail, SMTP/IMAP, Microsoft 365, các dịch vụ kiểm tra email như Reoon, ZeroBounce, Hunter, TrulyInbox...). Bạn không cần điền hết, chỉ điền phần mình dùng. Mỗi biến đều có chú thích ngay trong file.

```note
Bạn sẽ gửi email thật từ hộp thư thật của mình. Hãy dùng tên miền gửi riêng, không dùng hộp thư chính của công ty, và đọc tài liệu Legal and deliverability trong repo để biết quy định về email chào hàng ở nước bạn gửi tới. Mật khẩu và khoá trong file .env tuyệt đối không đưa lên mạng.
```

## Cài đặt từng bước

```steps
- Tải mã về | git clone repo Sellbird rồi vào thư mục
- Cài đặt | tạo môi trường ảo Python và cài gói bằng pip
- Điền thông tin | sao chép .env.example thành .env rồi sửa
- Dạy Sellbird về sản phẩm | chạy sellbird train với website của bạn
- Chọn khách lý tưởng và tìm doanh nghiệp | sellbird signals rồi sellbird discover
- Mở bảng điều khiển và chạy | sellbird dashboard, sau đó sellbird run
```

Có hai cách: để Claude cài giúp, hoặc tự gõ lệnh. Người mới nên thử cách thứ nhất.

### Cách dễ nhất: để Claude hướng dẫn

Mở terminal (trên macOS là Terminal, trên Windows có thể là PowerShell hoặc Git Bash), chạy ba lệnh sau. Lệnh đầu tải mã về, lệnh thứ hai vào thư mục vừa tải, lệnh thứ ba mở Claude Code ngay trong thư mục đó.

```bash
git clone https://github.com/ethanplusai/sellbird.git
cd sellbird
claude
```

Khi Claude mở lên, bạn gõ: **"set up Sellbird for me"**. Theo README, file `CLAUDE.md` của repo biến Claude Code thành người hướng dẫn cài đặt: nó kiểm tra bạn đang ở đâu, cài những gì còn thiếu, hỏi những gì cần hỏi và dạy Sellbird về sản phẩm của bạn. Chỗ người mới hay vấp: bạn phải đứng đúng trong thư mục `sellbird` trước khi gõ `claude`, và Claude Code phải đã đăng nhập (`claude login`).

### Cách tự cài: tạo môi trường và cài gói

Sau khi đã `git clone` và `cd sellbird` như trên, chạy lệnh sau. Lưu ý của README: dùng `python3.13`, đừng dùng `python3` trần, vì trên macOS `python3` trần là bản 3.9 quá cũ.

```bash
python3.13 -m venv .venv && source .venv/bin/activate && pip install -e .
```

Lệnh này làm ba việc: tạo môi trường ảo `.venv` để không lẫn với phần mềm khác trên máy, kích hoạt nó, rồi cài Sellbird ở chế độ chỉnh sửa được (`pip install -e .`). Dòng `source .venv/bin/activate` dành cho macOS/Linux. README không ghi lệnh kích hoạt tương ứng cho Windows, bạn cần xem tài liệu Troubleshooting hoặc dùng cách "Let Claude set it up".

### Điền thông tin đăng nhập

```bash
cp .env.example .env && $EDITOR .env
```

Lệnh `cp` sao chép file mẫu thành `.env`, rồi mở nó để bạn sửa. Đây là nơi bạn điền thông tin hộp thư gửi (ví dụ Gmail, SMTP) và khoá của dịch vụ kiểm tra email nếu có dùng. Nếu máy bạn chưa đặt sẵn trình soạn thảo, `$EDITOR` có thể trống. Khi đó cứ mở file `.env` bằng trình soạn thảo bất kỳ rồi sửa.

### Dạy Sellbird về sản phẩm của bạn

```bash
sellbird train https://your-company.com
```

Thay địa chỉ bằng website công ty bạn. Sellbird đọc website và ghi hiểu biết của nó về sản phẩm vào file `sellbird.local.yaml`. File này git không đụng tới, nên cập nhật sau này không làm mất nội dung của bạn.

### Chọn tín hiệu và tìm doanh nghiệp

```bash
sellbird signals --confirm free
sellbird discover
```

Lệnh đầu xác nhận thế nào là một khách tiềm năng tốt (các tín hiệu mua hàng). Lệnh thứ hai tìm doanh nghiệp, mặc định dùng nguồn miễn phí và không cần tài khoản.

### Mở bảng điều khiển và chạy vòng lặp

```bash
sellbird dashboard
sellbird run
```

`sellbird dashboard` in ra một liên kết riêng tư tới `http://127.0.0.1:5555`, chỉ truy cập được trên máy bạn. `sellbird run` khởi động vòng lặp làm việc.

Nếu bạn dùng Linux, README nói có thể chạy bằng Docker. Repo có `Dockerfile` và `docker-compose.yml`, chi tiết xem tài liệu Docker trong thư mục `docs/`.

## Kiểm tra đã chạy được chưa

Theo README, khi chạy `sellbird run` bạn sẽ thấy dòng chữ kiểu "Sellbird is online.", rồi nó kiểm tra trạng thái dây chuyền, đưa ra quyết định (ví dụ viết chiến dịch cho các khách mới chưa có thư nháp), và báo "Cycle complete" cùng thời gian nghỉ 15 phút trước vòng sau. README còn minh hoạ cảnh các email chờ trong hộp chờ duyệt (Outbox).

Cách kiểm tra thực tế:

- Chạy `python3.13 --version` hoặc `python3 --version` để chắc bạn có Python 3.11 trở lên.
- Chạy `sellbird dashboard` và mở liên kết nó in ra. Nếu thấy bảng điều khiển là phần cài đã ổn.
- Chạy `sellbird run` và xem vòng lặp có chạy xong một chu kỳ không.
- Vào Outbox xem có email nháp nào chờ bạn duyệt không. Nếu có, hệ thống đã chạy đúng.

Một điểm yên tâm: mặc định mọi email đều chờ bạn duyệt, nên lần chạy đầu sẽ không gửi gì ra ngoài.

## Dùng vào việc thật

### Chủ dịch vụ đặt lịch bán cho phòng khám và cửa hàng nhỏ

Bối cảnh: bạn có phần mềm đặt lịch và muốn chào hàng các phòng khám nha khoa, thợ sửa mái nhà hay tiệm điện lạnh. Bạn chạy `sellbird train` với website công ty, xác nhận tín hiệu bằng `sellbird signals --confirm free`, rồi `sellbird discover` để tìm doanh nghiệp từ nguồn miễn phí. Sellbird đọc website từng nơi để biết chỗ nào chưa có đặt lịch online, tìm chủ hoặc quản lý, kiểm tra email rồi viết chuỗi thư ngắn. Kết quả: bạn mở bảng điều khiển, thấy một loạt email nháp nằm trong Outbox, mỗi email nêu một lý do cụ thể cho từng doanh nghiệp. Bạn đọc, sửa nếu cần rồi mới duyệt gửi.

> Không có email nào ra khỏi máy bạn nếu bạn chưa bấm duyệt.
>
> — Ông T

### Nhân viên sales chỉ cần một danh sách sạch

Bối cảnh: công ty bạn đã có công cụ gửi thư (sequencer) và chỉ thiếu danh sách khách. Bạn chạy các bước tìm công ty, tìm người ra quyết định và kiểm tra email, rồi dừng lại. Sau đó chạy:

```bash
sellbird export
```

Kết quả là một file CSV sẵn sàng để nhập vào công cụ gửi thư. Mỗi địa chỉ đã mang nhãn verified, risky, guess hoặc invalid, nên bạn lọc được trước khi gửi.

### Chủ shop trả lời khách mà không bỏ sót

Bối cảnh: bạn bắt đầu gửi và có thư trả lời đổ về. Sellbird đọc từng thư, phân loại, soạn sẵn câu đáp (ví dụ khách quan tâm hoặc khách phản đối) và đưa vào chờ bạn duyệt. Thư tự động trả lời được tách ra, yêu cầu ngừng nhận thư được xử lý ngay, và những thư nó không nên tự trả lời sẽ được chuyển cho bạn. Nếu thấy có gì không ổn, bạn chạy:

```bash
sellbird sending pause
```

Lệnh này dừng mọi việc gửi thư cùng lúc.

### Người đang dùng Harvey nâng cấp lên Sellbird

Bối cảnh: bạn đã cài Harvey từ trước. README nói cấu hình, dữ liệu và đăng nhập bảng điều khiển của bạn được giữ nguyên. Bạn chạy:

```bash
git pull
pip install -e .
sellbird dashboard
```

Lần chạy đầu, Sellbird tự đổi tên `harvey.local.yaml` thành `sellbird.local.yaml` và đổi tên cơ sở dữ liệu cho khớp. Nó không ghi đè file đã có tên mới, và sẽ chờ nếu tiến trình Harvey còn đang chạy. Nhớ tắt Harvey cũ trước.

## Lỗi hay gặp và cách xử lý

### Lệnh `pip install` báo lỗi hoặc Python quá cũ

Nguyên nhân hay gặp là dùng `python3` trần trên macOS (bản 3.9) trong khi Sellbird cần 3.11 trở lên. Cách xử lý: chạy `brew install python@3.13` rồi dùng `python3.13` để tạo môi trường ảo như README hướng dẫn.

### Không gõ được lệnh `sellbird` sau khi cài

Thường là do môi trường ảo chưa được kích hoạt, nên terminal không tìm thấy lệnh. Hãy kích hoạt lại môi trường (`source .venv/bin/activate` trên macOS/Linux) hoặc mở terminal mới trong thư mục dự án rồi kích hoạt lại. Trên Windows, README không ghi cách kích hoạt, hãy xem tài liệu Troubleshooting trong `docs/`.

### Claude Code chưa đăng nhập

Sellbird dùng Claude Code CLI để suy nghĩ, nên nếu chưa đăng nhập nó sẽ không làm việc được. Chạy `claude login` và đăng nhập bằng tài khoản Claude Pro hoặc Max. Nếu bạn dùng ChatGPT thì làm theo tài liệu Codex trong repo.

### Email nhiều khả năng rơi vào thư rác

Nếu hộp thư mới tạo chưa được warmup mà gửi ngay, tỉ lệ vào thư rác thường cao. Đây là lý do README nhắc cần warmup, và nói Sellbird đọc tỉ lệ vào hộp thư đến từ TrulyInbox để báo khi bạn sẵn sàng. Hãy gửi từ tên miền riêng, bắt đầu từ ít thư, và đọc tài liệu Legal and deliverability.

### `git pull` bị chặn khi nâng cấp từ Harvey

Nếu bạn từng sửa trực tiếp file `harvey.yaml`, `git pull` sẽ báo "your local changes would be overwritten". Theo README: chạy `git stash`, rồi `git pull`, rồi `git stash pop`. Nếu có xung đột, giữ các dòng của bạn, xoá các ký hiệu xung đột, rồi chạy `git stash drop`. Về lâu dài, hãy đặt cấu hình trong `sellbird.local.yaml` vì git không bao giờ động tới file này.

## Có nên dùng không

**Điểm mạnh.** Sellbird gom cả quy trình vào một nơi, chạy trên máy bạn, và không cần API key của mô hình vì dùng gói Claude hoặc ChatGPT bạn đã trả tiền. Nguồn tìm khách mặc định miễn phí, các bước trả phí đều hiện chi phí trước. Việc gửi thư có nhiều lớp bảo vệ: mặc định chờ bạn duyệt, một bước kiểm tra trước khi gửi (không dùng mô hình) loại bỏ thẻ chưa điền, cụm từ bị cấm, email quá dài, link thừa và địa chỉ không gửi được. Giấy phép là AGPL-3.0, nên mã mở, nhưng nếu bạn định tích hợp hay cung cấp nó thành dịch vụ thì nên đọc kỹ giấy phép.

**Giới hạn.** Bạn vẫn phải có hộp thư gửi, tên miền riêng và warmup, đó là phần hạ tầng mà công cụ không thay bạn làm được khi tự chạy. Cài đặt cần quen terminal. Sellbird tự làm chậm để chừa chỗ cho việc riêng của bạn trên gói đăng ký, nên khối lượng gửi phụ thuộc vào hạn mức gói và giới hạn gửi mỗi ngày. README cũng nói công cụ tìm người quyết định dựa trên tên được nêu ở chính trang của công ty, tối đa hai người mỗi công ty, nên không phải công ty nào cũng tìm ra. Cuối cùng, email lạnh có quy định pháp lý khác nhau theo từng nước, và trách nhiệm tuân thủ thuộc về bạn.

**Khi nào chọn cách khác.** Nếu bạn không muốn tự vận hành gì cả, tác giả có bản chạy sẵn (hosted) tại trang chủ sellbird.ai, hiện ở giai đoạn truy cập sớm, với tên miền gửi, hộp thư và warmup được thiết lập sẵn. Nếu bạn chỉ cần vài email gửi tay, một công cụ đơn giản sẽ hợp hơn. Nếu bạn cần kênh khác ngoài email thì nên đọc kỹ tài liệu repo trước, vì README chỉ mô tả email.

## Câu hỏi thường gặp

### Sellbird có miễn phí không?

Mã nguồn mở theo giấy phép AGPL-3.0 và nguồn tìm doanh nghiệp mặc định là miễn phí. Nhưng bạn vẫn cần gói Claude Pro/Max (hoặc ChatGPT có Codex) và một hộp thư để gửi. README ví dụ Google Workspace khoảng 7 USD mỗi tháng, còn nguồn tìm khách trả phí rẻ nhất khoảng 0,37 USD cho 1.000 doanh nghiệp.

### Có cần API key của Claude hay OpenAI không?

Không. README nói Sellbird suy nghĩ qua Claude Code CLI trên gói Claude Pro hoặc Max, hoặc qua Codex trên gói ChatGPT, nên không có API key mô hình và không tính tiền theo token. Một số dịch vụ phụ như kiểm tra email có biến khoá riêng trong .env.example nếu bạn chọn dùng.

### Có cần GPU hay máy cấu hình mạnh không?

Tư liệu không nhắc tới yêu cầu GPU hay cấu hình phần cứng. Việc suy nghĩ do Claude hoặc Codex đảm nhiệm, còn đọc website chỉ cần vài request HTTP, nên chưa có dấu hiệu cần máy mạnh.

### Chạy được trên Windows không?

README có nêu thư mục dữ liệu trên Windows (%APPDATA%\sellbird), nhưng lệnh cài trong README viết cho macOS/Linux, còn Docker được nói là dùng trên Linux. Chưa có hướng dẫn riêng cho Windows ở phần cài đặt, nên bạn nên xem tài liệu Troubleshooting trong thư mục docs/ hoặc nhờ Claude cài giúp.

### Sellbird có tự gửi email lung tung không?

Mặc định thì không. Mọi email chờ trong Outbox cho đến khi bạn duyệt, trừ khi bạn tự bật chế độ autopilot. Trước khi gửi còn có bước kiểm tra không dùng mô hình, và lệnh sellbird sending pause dừng mọi việc gửi cùng lúc.

### Dữ liệu của tôi lưu ở đâu?

Sellbird chạy trên máy bạn. Cấu hình, tri thức và dữ liệu nằm trong một thư mục chung, gồm sellbird.yaml, .env, prompts/, skills/ và data/ (cơ sở dữ liệu, nhật ký, token bảng điều khiển). Tư liệu không nói gì thêm về việc dữ liệu được gửi đi đâu ngoài các dịch vụ bạn tự cấu hình.

### Sellbird khác gì Harvey?

Là cùng một dự án, Harvey được đổi tên thành Sellbird từ bản 0.4.0, giữ nguyên lịch sử. Cấu hình, dữ liệu và đăng nhập bảng điều khiển được chuyển sang tên mới. Lệnh harvey cũ vẫn chạy tạm thời nhưng sẽ bị bỏ ở bản sau, và các bản Harvey đến 0.3.x dùng giấy phép MIT.
