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

> Sellbird (trước đây tên Harvey) là ứng dụng Python mã nguồn mở giúp làm outreach: tìm công ty hợp với khách hàng của bạn, tìm người quyết định, kiểm tra email, viết thư cá nhân hoá rồi 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 cần API key của mô hình. Cài không quá khó nếu bạn quen terminal, và mặc định không có thư nào được gửi đi khi bạn chưa duyệt.

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

Sellbird là một nền tảng outreach mã nguồn mở chạy trên máy của bạn. Nó tìm các công ty có thể cần thứ bạn bán, tìm người ra quyết định, kiểm tra địa chỉ email, viết cho mỗi người một cold email riêng, gửi đi rồi xử lý thư trả lời. Dự án trước đây tên là Harvey, nay đổi thành Sellbird.

Bạn nên xem qua nếu bạn làm kinh doanh, bán dịch vụ cho doanh nghiệp nhỏ, hoặc là dev muốn tự dựng quy trình tìm khách thay vì trả tiền cho cả bộ công cụ prospecting. Hiện repo có khoảng 5250 sao và 1127 fork, giấy phép AGPL-3.0, và vẫn được cập nhật trong vài tháng gần đây.

Điểm đáng giá nhất: Sellbird dùng gói Claude Pro/Max (qua Claude Code CLI) hoặc gói ChatGPT (qua Codex) mà bạn đang trả, nên không có API key mô hình và không tính tiền theo token. Ngoài ra, mặc định không email nào rời máy bạn khi bạn chưa bấm duyệt. Bạn có thể xem video ngắn bên dưới để thấy nó chạy trước khi cài.

```repo
- repo | ethanplusai/sellbird
- kind | Ứng dụng
- desc | Sellbird là nền tảng mã nguồn mở chạy trên gói Claude hoặc ChatGPT của bạn: tìm công ty, kiểm tra email, viết cold email, gửi và xử lý phản hồi.
- 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 bước. Bạn chạy trọn vẹn hoặc dừng ở bước nào cũng được.

- **Tìm công ty.** Tìm 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í. Bạn cũng có thể chọn nguồn trả phí, và mỗi lần tìm trả phí đều hiện chi phí trước khi chạy. Bạn không bị trừ tiền bất ngờ.
- **Hiểu vì sao 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 hoặc đang tuyển một vị trí nào đó. Bước này không gọi mô hình, nên không tốn gì.
- **Tìm người quyết định.** Tìm chủ hoặc quản lý được nêu trên chính trang của công ty, tối đa hai người mỗi công ty. Bạn không bị lan man gửi cho cả phòng ban.
- **Kiểm tra địa chỉ email.** Nó học cách đặt email của công ty và kiểm tra một địa chỉ. Mỗi địa chỉ được gắn nhãn verified, risky, guess hoặc invalid, và chỉ địa chỉ gửi được mới được dùng để gửi. Việc này giúp hạn chế thư bật lại.
- **Viết và gửi.** Viết một chuỗi email ngắn cho từng người dựa trên điều đã tìm được. Thư gửi từ hộp thư Gmail, Microsoft 365 hoặc SMTP của bạn, trong giới hạn gửi mỗi ngày và theo giờ làm việc của người nhận.
- **Xử lý thư trả lời.** Đọ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 hủy nhận ngay lập tức, và chuyển cho bạn những thư nó không nên tự trả lời.

Nếu bạn chỉ cần danh sách, hãy dừng sau bước kiểm tra email và chạy `sellbird export` để có file CSV dùng được ngay cho công cụ gửi thư khác.

Về an toàn, mỗi email gửi đi phải nằm trong hộp Outbox chờ bạn duyệt cho tới khi bạn tự bật autopilot. Trước khi gửi còn có một bước kiểm tra không dùng mô hình, chặn thư còn sót merge tag chưa điền, cụm từ bị cấm, thư quá dài, quá nhiều link và địa chỉ không gửi đượ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 Python >=3.11. README lưu ý macOS có sẵn bản 3.9, nên nếu `python3 --version` báo 3.9 thì chạy `brew install python@3.13` trước.
- **Gói Claude Pro hoặc Max** đã đăng nhập Claude CLI bằng `claude login`, hoặc **gói ChatGPT có Codex CLI**. Hướng dẫn Codex nằm trong thư mục docs của repo.
- **Một hộp thư để gửi đ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 chạy được.
- **Warmup cho hộp thư đó.** README gợi ý TrulyInbox để làm nóng hộp thư mới trước khi gửi cold email. Lưu ý đây là link affiliate của tác giả. Bạn không bắt buộc phải dùng, nhưng hộp thư mới chưa warmup thường dễ bị vào spam.

Về chi phí, README nói tìm doanh nghiệp là 0 đồng với nguồn mặc định, hoặc khoảng 0,37 USD cho 1.000 kết quả ở nguồn trả phí rẻ nhất. Đọc website là 0 đồng. Hộp thư Google Workspace khoảng 7 USD một tháng. README không nói gì về yêu cầu GPU hay RAM.

File `.env.example` liệt kê nhiều biến cấu hình tuỳ chọn 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…). Bạn chỉ điền những gì mình thực sự dùng.

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

```steps
- Lấy mã nguồn | Tải repo về máy bằng git clone
- Cài đặt | Tạo môi trường ảo Python và cài gói sellbird
- Điền thông tin | Sao chép .env.example thành .env rồi điền
- Dạy Sellbird về sản phẩm | Chạy sellbird train với website của bạn
- Tìm khách | Xác nhận tín hiệu rồi chạy sellbird discover
- Chạy | Mở dashboard và khởi động vòng lặp
```

Có hai cách: nhờ Claude cài giúp (dễ nhất) hoặc tự gõ lệnh.

### Cách dễ: để Claude cài cho bạn

Mở terminal (trên Windows là PowerShell hoặc Git Bash, trên macOS là Terminal) rồi chạy:

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

Lệnh đầu tải repo về, lệnh thứ hai đi vào thư mục vừa tải, lệnh thứ ba mở Claude Code ngay trong thư mục đó. Sau đó bạn gõ: **set up Sellbird for me**. File `CLAUDE.md` trong repo biến Claude Code thành người hướng dẫn: nó kiểm tra máy của bạn, cài thứ còn thiếu, hỏi những gì cần hỏi và huấn luyện Sellbird về sản phẩm của bạn. Chỗ người mới hay vấp: phải đứng trong thư mục `sellbird` rồi mới gõ `claude`, nếu không Claude sẽ không thấy file hướng dẫn.

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

Sau khi đã `git clone` và `cd sellbird` như trên, chạy:

```bash
# 1. Install. Use python3.13, not python3: on macOS bare python3 is 3.9.
python3.13 -m venv .venv && source .venv/bin/activate && pip install -e .
```

Lệnh này tạo môi trường ảo `.venv`, kích hoạt nó rồi cài Sellbird ở chế độ chỉnh sửa được. Sau khi cài xong bạn có lệnh `sellbird`. Lưu ý: dòng `source .venv/bin/activate` là cú pháp macOS/Linux. README chưa ghi cách kích hoạt môi trường ảo trên Windows, nên nếu dùng Windows bạn có thể chạy trong WSL hoặc Git Bash, hoặc xem thêm tài liệu trong thư mục `docs/` của repo.

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

```bash
# 2. Add credentials. Every variable is documented inline.
cp .env.example .env && $EDITOR .env
```

Lệnh sao chép file mẫu thành `.env` rồi mở bằng trình soạn thảo của bạn. Mỗi biến đều có chú thích ngay trong file. Bạn chỉ cần điền phần hộp thư gửi đi (ví dụ SMTP_* hoặc GMAIL_*) và các dịch vụ bạn thật sự dùng. Đừng chia sẻ file `.env` cho ai.

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

```bash
# 3. Learn your product from your website (writes sellbird.local.yaml).
sellbird train https://your-company.com
```

Thay `https://your-company.com` bằng website công ty bạn. Sellbird đọc trang web để hiểu bạn bán gì, rồi ghi kết quả vào `sellbird.local.yaml`. Đây là file riêng của bạn, git không đụng tới khi bạn cập nhật.

### Xác nhận tín hiệu và tìm doanh nghiệp

```bash
# 4. Confirm what makes a good prospect.
sellbird signals --confirm free

# 5. Find businesses. The default source is free and needs no account.
sellbird discover
```

Lệnh `signals` xác nhận những dấu hiệu cho thấy một công ty là khách tiềm năng tốt. Lệnh `discover` tìm doanh nghiệp từ nguồn mặc định, miễn phí và không cần tài khoản.

### Mở dashboard và chạy

```bash
# 6. Open the dashboard and start the loop.
sellbird dashboard          # prints a private link to http://127.0.0.1:5555
sellbird run
```

`sellbird dashboard` in ra một đường link riêng tư tới địa chỉ trên máy bạn (`http://127.0.0.1:5555`). `sellbird run` khởi động vòng lặp chính. Mỗi chu kỳ nó kiểm tra trạng thái, viết thư, xử lý thư trả lời rồi nghỉ 15 phút. Nếu cần chạy cả hai, mở hai cửa sổ terminal.

Trên Linux bạn còn có thể chạy bằng Docker. Repo có `Dockerfile` và `docker-compose.yml`; chi tiết xem tài liệu Docker trong `docs/`.

```note
Sellbird gửi email thật từ hộp thư của bạn. Hãy dùng tên miền gửi riêng, warmup hộp thư trước, và giữ chế độ duyệt tay (mặc định) cho tới khi bạn tin vào chất lượng thư. Đọc phần Legal and deliverability trong docs/ để biết quy định gửi cold email ở nơi bạn gửi tới.
```

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

Cách đơn giản nhất là chạy `sellbird run`. Theo README, bạn sẽ thấy dòng thông báo Sellbird is online, sau đó là phần kiểm tra trạng thái và một quyết định như `write_campaign`. Tiếp theo nó liệt kê các việc đã làm (handler trả lời thư, writer viết chuỗi email) và cuối cùng là dòng cho biết có bao nhiêu email đang chờ bạn duyệt, rồi báo Cycle complete và nghỉ 15 phút.

Bạn cũng nên mở đường link mà `sellbird dashboard` in ra. Nếu trang dashboard hiện lên và có hộp Outbox, nghĩa là phần cài đặt đã ổn. README có kèm dữ liệu demo giả (công ty Bookwell bán phần mềm đặt lịch cho thợ lợp mái, nha khoa, điều hoà) trên tên miền `.test` để bạn xem thử mà không gửi cho ai thật.

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

### Chủ công ty dịch vụ chỉ cần danh sách khách

Bạn bán phần mềm đặt lịch và chưa muốn gửi email tự động. Sau khi `train` và `signals`, bạn chạy `sellbird discover`, để Sellbird tìm công ty, đọc website, tìm người quyết định và kiểm tra email. Rồi dừng ở đó và chạy:

```bash
sellbird export
```

Kết quả là file CSV sẵn sàng đưa vào công cụ gửi thư bạn đang dùng, trong đó mỗi địa chỉ có nhãn verified, risky, guess hoặc invalid để bạn lọc.

> Chỉ cần danh sách thì dừng sau bước kiểm tra email: không tốn công cụ prospecting nào.
>
> — Ông T

### Nhân viên sales duyệt từng thư trước khi gửi

Bạn muốn tự động hoá nhưng vẫn kiểm soát. Bạn chạy `sellbird dashboard` và `sellbird run`. Sellbird viết chuỗi email (ví dụ 2 email nhắc việc công ty đang tuyển điều phối viên), đưa vào Outbox. Bạn mở dashboard, đọc từng thư, sửa nếu cần rồi duyệt. Kết quả: thư vẫn được cá nhân hoá theo từng công ty nhưng bạn là người quyết định cuối cùng.

### Dev hoặc người làm vận hành muốn dừng khẩn cấp

Bạn thấy một thư viết chưa ổn hoặc hộp thư có dấu hiệu bị đánh spam. Bạn chạy:

```bash
sellbird sending pause
```

Lệnh này dừng mọi hoạt động gửi cùng lúc. Bạn sửa prompt hoặc kỹ năng viết thư trong thư mục `prompts/` và `skills/` (README nói các file này bạn được phép chỉnh), rồi mới cho chạy lại.

### Người đang dùng Harvey cũ

Nếu bạn đã chạy Harvey, README nói cấu hình, dữ liệu và đăng nhập dashboard được giữ nguyên. Bạn chạy `git pull`, `pip install -e .` một lần để có lệnh `sellbird` mới, rồi `sellbird dashboard`. Ở lần chạy đầu, Sellbird tự đổi tên các file `harvey.local.yaml` và `data/harvey.db` sang tên mới. Nếu bạn từng sửa trực tiếp `harvey.yaml`, README hướng dẫn dùng `git stash`, `git pull`, `git stash pop` và nên chuyển các thiết lập sang `sellbird.local.yaml`.

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

- **`python3 --version` báo 3.9 trên macOS.** Đây là lỗi README đã cảnh báo. Cài bản mới bằng `brew install python@3.13` và dùng `python3.13` thay vì `python3` khi tạo môi trường ảo.
- **Không thấy lệnh `sellbird`.** Thường do môi trường ảo chưa được kích hoạt hoặc chưa chạy `pip install -e .`. Kích hoạt lại `.venv` rồi cài lại. Trên Windows, README chưa ghi cách kích hoạt môi trường ảo, nên xem thêm trong `docs/`.
- **Claude hoặc Codex chưa đăng nhập.** Sellbird dựa vào CLI đã đăng nhập, nên chạy `claude login` trước (hoặc làm theo hướng dẫn Codex trong docs). Đừng tìm chỗ nhập API key mô hình vì README nói không cần.
- **`git pull` báo “your local changes would be overwritten”** khi nâng cấp từ Harvey. Làm theo README: `git stash`, `git pull`, `git stash pop`. Nếu có xung đột trong `sellbird.yaml`, giữ phần của bạn, xoá dấu xung đột, rồi chạy `git stash drop`.
- **Email bị bật lại hoặc vào spam.** Đây là rủi ro chung của cold email. Hãy warmup hộp thư, dùng tên miền gửi riêng, chỉ gửi tới địa chỉ verified và đọc phần Troubleshooting cùng Legal and deliverability trong `docs/`.

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

**Điểm mạnh.** Không cần API key mô hình, dùng luôn gói bạn đã có. Nguồn tìm khách mặc định miễn phí. Có bước duyệt tay mặc định và kiểm tra trước khi gửi. Dữ liệu chạy trên máy của bạn. Mã nguồn mở, có thể chỉnh prompt và kỹ năng bán hàng.

**Giới hạn.** Bạn phải quen terminal ở mức cơ bản. Cách cài trong README viết cho macOS/Linux, người dùng Windows nên chuẩn bị thêm. Bạn vẫn cần một hộp thư gửi, nên có thêm chi phí và công warmup. Giấy phép AGPL-3.0 có điều kiện riêng nếu bạn muốn sửa rồi cung cấp thành dịch vụ cho người khác. Ngoài ra, cold email có quy định pháp lý và rủi ro với danh tiếng tên miền, nên bạn cần tự chịu trách nhiệm.

**Khi nên chọn cách khác.** Nếu bạn không muốn tự vận hành, tác giả có bản hosted tại sellbird.ai (đang trong giai đoạn early access, theo README). Nếu chỉ cần gửi thư hàng loạt đơn giản, một công cụ email marketing quen thuộc có thể đủ dùng hơn.

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

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

Bản mã nguồn mở là miễn phí, giấy phép AGPL-3.0. Tuy nhiên bạn cần gói Claude Pro/Max hoặc ChatGPT có Codex, và một hộp thư gửi (README nhắc Google Workspace khoảng 7 USD một tháng). Nguồn tìm doanh nghiệp mặc định là 0 đồng, nguồn trả phí rẻ nhất khoảng 0,37 USD cho 1.000 kết quả.

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

Không. Theo README, Sellbird dùng Claude Code CLI trên gói Claude Pro/Max hoặc 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ó thể dùng key riêng, được liệt kê trong file .env.example.

### Có cần GPU không?

README không nói gì về yêu cầu GPU hay cấu hình phần cứng. Vì phần suy nghĩ chạy qua Claude hoặc Codex, có vẻ máy bạn không phải tự chạy mô hình, nhưng tư liệu chưa xác nhận điều này rõ ràng.

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

README có nêu thư mục dữ liệu cho Windows (%APPDATA%\sellbird), nhưng các lệnh cài đặt được viết cho macOS/Linux và Docker được nhắc cho Linux. Chưa có hướng dẫn riêng cho Windows trong README, bạn nên xem thêm thư mục docs của repo.

### Sellbird có tự gửi email mà tôi không biết không?

Không, mặc định mọi email nằm trong Outbox chờ bạn duyệt cho tới khi bạn tự bật autopilot. Có thêm bước kiểm tra trước khi gửi, và lệnh sellbird sending pause dừng mọi hoạt động gửi ngay lập tức.

### Dữ liệu của tôi có an toàn không?

README nói Sellbird chạy trên máy của bạn, cấu hình, dữ liệu và cơ sở dữ liệu nằm trong thư mục home của bạn. Dashboard mở tại địa chỉ trên máy và dùng link riêng tư. Tuy vậy việc suy nghĩ vẫn đi qua Claude hoặc Codex, và README không nói chi tiết về chính sách dữ liệu của các nhà cung cấp này.

### Sellbird khác Harvey thế nào?

Đây là cùng một dự án, chỉ đổi tên từ Harvey thành Sellbird từ bản 0.4.0, giữ nguyên lịch sử. Cấu hình và dữ liệu cũ được chuyển sang tên mới ở lần chạy đầu. Lệnh harvey cũ vẫn chạy tạm thời nhưng sẽ bị gỡ ở bản sau.
