# Sellbird: tự tìm khách, kiểm tra email, 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à nền tảng outreach mã nguồn mở viết bằng Python, chạy trên máy của bạn. Nó tìm doanh nghiệp phù hợp, tìm người quyết định, xác minh email, viết cold email rồi gửi và soạn sẵn câu trả lời cho phản hồi. Cài không quá khó nếu bạn có Python 3.11 trở lên và gói Claude Pro/Max hoặc ChatGPT có Codex. Mặc định không email 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-31 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/sellbird-tu-dong-tim-khach-gui-cold-email-huong-dan-cai-dat

Sellbird là một nền tảng mã nguồn mở giúp bạn làm cold email từ đầu đến cuối: tìm công ty cần thứ bạn bán, tìm người quyết định, kiểm tra địa chỉ email, viết thư riêng cho từng người, gửi đi và xử lý thư trả lời. Nó chạy ngay trên máy của bạn, viết bằng Python. Dự án trước đây tên là Harvey và hiện có khoảng 5.250 sao, 1.127 fork trên GitHub.

Ai nên dùng? Chủ doanh nghiệp nhỏ, nhân viên kinh doanh, người làm agency hoặc dev muốn tìm khách hàng mới nhưng không muốn trả tiền cho cả bộ công cụ như Apollo, ZoomInfo, Clearbit hay Clay. README nói thẳng là Sellbird không dùng các công cụ đó.

Điểm đáng giá nhất là chuyện chi phí và quyền kiểm soát. Sellbird dùng "bộ não" AI thông qua gói Claude Pro/Max (qua Claude Code CLI) hoặc gói ChatGPT (qua Codex), nên không cần API key và không bị tính tiền theo token. Ngoài ra, theo mặc định, mọi email đều nằm chờ trong hộp Outbox cho đến khi bạn tự duyệt. Bạn có thể xem video ngắn bên dưới để thấy tổng quan trước khi cài.

```repo
- repo | ethanplusai/sellbird
- kind | Ứng dụng
- desc | Nền tảng mã nguồn mở chạy trên máy bạn: 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 sau khi bạn duyệt 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 gồm nhiều bước. Bạn chạy trọn vòng, hoặc dừng ở bất kỳ bước nào.

- **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ó 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. 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 hoặc đang tuyển một vị trí nào đó. Bước này không gọi mô hình AI nên không tốn phí. Mỗi công ty chỉ cần ba request HTTP.
- **Tìm người quyết định.** Tìm chủ hoặc quản lý có 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 bị ngập trong danh sách dài vô nghĩa.
- **Kiểm tra địa chỉ email.** Sellbird học cách đặt email của công ty và xác minh một địa chỉ. Mỗi địa chỉ được gắn nhãn verified, risky, guess hoặc invalid. Chỉ địa chỉ gửi được mới được gửi thư. Điều này giúp giảm thư bị trả về và bảo vệ uy tín hộp thư của bạn.
- **Viết và gửi.** Viết một chuỗi email ngắn cho từng người dựa trên những gì tìm được, rồi gửi từ hộp thư Gmail, Microsoft 365 hoặc SMTP của bạn. Nó tuân theo giới hạn gửi mỗi ngày và giờ làm việc của người nhận.
- **Xử lý phản hồi.** Đọc mọi thư trả lời, soạn nháp câu đáp, tách riêng thư tự động, tôn trọng yêu cầu từ chối ngay lập tức, và chuyển cho bạn những thư mà nó không nên tự trả lời.

Nếu bạn chỉ cần danh sách khách hàng, hãy dừng sau bước xác minh rồi chạy `sellbird export` để lấy file CSV dùng được cho công cụ gửi email khác.

Ngoài ra còn một bảng điều khiển (dashboard) chạy ở máy bạn, và lệnh `sellbird sending pause` để dừng toàn bộ việc gửi ngay lập tứ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 đi kèm Python 3.9, nên nếu `python3 --version` báo 3.9 thì cài thêm bằng `brew install python@3.13`.
- **Claude Pro hoặc Max** đã đăng nhập Claude Code CLI bằng `claude login`, hoặc **gói ChatGPT có Codex CLI**.
- **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. README nhắc một mức giá tham khảo khoảng 7 USD mỗi tháng cho Google Workspace.
- **Warmup (làm nóng) hộp thư.** README khuyên dùng TrulyInbox để làm nóng hộp thư mới trước khi gửi cold email. Đây là liên kết affiliate, tác giả có thể nhận hoa hồng. Bạn không bắt buộc phải dùng.

Phần cứng đặc biệt thì tư liệu không yêu cầu. File `.env.example` còn liệt kê nhiều biến tuỳ chọn như khoá của Reoon, ZeroBounce, Hunter, Instantly, Cloudflare… Bạn chỉ cần điền những dịch vụ mình thật sự dùng.

Về hệ điều hành, README có nêu thư mục dữ liệu cho macOS, Windows và Linux. Các lệnh cài đặt thủ công trong README được viết theo kiểu macOS/Linux, và Docker được ghi là dành cho Linux.

```note
Sellbird gửi email thật từ hộp thư thật của bạn. Hãy dùng tên miền gửi riêng, đừng dùng hộp thư chính của công ty. Tìm hiểu quy định gửi email thương mại và chuyện deliverability trong tài liệu Legal and deliverability của repo trước khi bật chế độ tự động.
```

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

```steps
- Tải mã nguồn | Clone repo về máy và vào thư mục sellbird
- Cài gói | Tạo môi trường ảo và cài bằng pip install -e .
- Điền thông tin | Sao chép .env.example thành .env rồi điền thông tin hộp thư
- Dạy Sellbird | Chạy sellbird train với website của bạn, rồi xác nhận tín hiệu
- Tìm khách | Chạy sellbird discover
- Mở dashboard | Chạy sellbird dashboard và sellbird run
```

README đưa ra hai cách: nhờ Claude cài giúp, hoặc tự làm. Mình đi qua cả hai.

### Cách dễ nhất: để Claude cài giúp

Mở terminal (macOS/Linux dùng Terminal; Windows dùng PowerShell hoặc Git Bash) tại thư mục bạn muốn đặt dự án, rồi chạy:

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

Lệnh đầu tải mã nguồn về. Lệnh thứ hai đi vào thư mục vừa tải. Lệnh `claude` mở Claude Code ngay trong thư mục này. Sau đó bạn gõ **set up Sellbird for me** (README ghi câu này bằng tiếng Anh). Theo README, file `CLAUDE.md` của repo biến Claude Code thành người hướng dẫn: kiểm tra bạn đang ở đâu, cài những gì còn thiếu, hỏi thứ nó cần và huấn luyện Sellbird về sản phẩm của bạn. Bạn cần đã chạy `claude login` trước đó.

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

Bạn vẫn ở trong thư mục `sellbird`. Lệnh dưới đây là nguyên văn README:

```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ột môi trường Python riêng tên `.venv`, kích hoạt nó, rồi cài Sellbird ở chế độ chỉnh sửa được. Sau khi cài, bạn có lệnh `sellbird`. Chỗ người mới hay vấp: nếu máy chỉ có Python cũ, lệnh `python3.13` sẽ báo không tìm thấy. Lúc đó hãy cài Python mới trước. Lệnh `source .venv/bin/activate` là kiểu macOS/Linux; README chưa ghi lệnh kích hoạt riêng cho Windows, nên người dùng Windows có thể chọn cách nhờ Claude cài ở trên hoặc xem mục Troubleshooting trong thư mục `docs/` của repo.

### Điền thông tin hộp thư

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

Lệnh này sao chép file mẫu thành file `.env` thật rồi mở nó để bạn sửa. Mỗi biến đều có giải thích ngay trong file. Bạn điền thông tin của dịch vụ gửi mail mình dùng, ví dụ nhóm `GMAIL_*`, nhóm `SMTP_*` hoặc nhóm `M365_*`. Nếu `$EDITOR` chưa được đặt, bạn có thể mở file `.env` bằng trình soạn thảo quen thuộc. Tuyệt đối không đưa file `.env` lên mạng.

### 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

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

Lệnh `train` đọc website của bạn để hiểu bạn bán gì, rồi ghi kết quả vào file `sellbird.local.yaml`. Hãy thay `https://your-company.com` bằng địa chỉ website thật của bạn. Lệnh `signals --confirm free` giúp bạn xác nhận điều gì làm nên một khách hàng tiềm năng tốt.

### Tìm doanh nghiệp, mở dashboard và chạy

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

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

Lệnh `discover` dùng nguồn miễn phí, không cần tài khoản. Lệnh `dashboard` in ra một đường link riêng trỏ tới địa chỉ chạy trên máy bạn (127.0.0.1:5555). Lệnh `run` bật vòng lặp chính. Mở dashboard trong một cửa sổ terminal và chạy `run` ở cửa sổ khác là cách gọn nhất.

### Chạy bằng Docker (tuỳ chọn, trên Linux)

README chỉ ghi ngắn gọn rằng trên Linux bạn có thể chạy bằng Docker; repo có sẵn Dockerfile và docker-compose.yml. Các lệnh cụ thể README có nêu trong phần nâng cấp từ Harvey, mình chép lại để bạn tham khảo:

```bash
docker compose build
docker compose up -d
```

Nếu bạn mới dùng, hãy ưu tiên cách cài thường. Hướng dẫn Docker đầy đủ nằm trong thư mục `docs/` của repo.

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

Sau khi chạy `sellbird run`, README cho thấy màn hình mẫu như sau:

```
Sellbird is online.
Checking pipeline state...
Decision: write_campaign (3 new prospects with no drafts)
  writer    → 2-email sequence: ...
  outbox    → 5 emails waiting for your approval
Cycle complete. Sleeping for 15 minutes.
```

Dấu hiệu bạn thấy nên là dòng "Sellbird is online", rồi các bước như viết chiến dịch, và cuối cùng là "Cycle complete", tức hết một vòng và nghỉ 15 phút. Nếu có email chờ duyệt, nó nằm trong Outbox của dashboard.

Cách kiểm tra khác: chạy `sellbird dashboard`. Nếu terminal in ra đường link riêng và bạn mở được trang ở cổng 5555, nghĩa là cài thành công. Repo cũng có dữ liệu demo hư cấu (công ty "Bookwell" bán phần mềm đặt lịch cho thợ lợp mái, nha khoa, sửa điều hoà, dùng tên miền `.test`) để bạn làm quen mà không gửi thư thật.

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

Dưới đây là bốn tình huống bám đúng những gì README mô tả.

### Chủ shop dịch vụ muốn có danh sách khách địa phương

Bạn mở tiệm làm tóc hoặc phòng khám nhỏ và chỉ cần danh sách doanh nghiệp quanh khu vực để mời hợp tác. Bạn chạy `sellbird train` với website của mình, `sellbird signals --confirm free`, rồi `sellbird discover` với nguồn miễn phí. Sellbird đọc website từng doanh nghiệp để tìm tín hiệu và tìm người có tên trên trang đó. Kết quả là một danh sách công ty cùng người liên hệ đã được phân loại.

### Nhân viên kinh doanh chỉ cần file CSV

Bạn đã có công cụ gửi email riêng (sequencer) và chỉ cần danh sách sạch. Hãy chạy tới bước xác minh rồi gõ:

```bash
sellbird export
```

Bạn nhận về file CSV chứa mọi thứ Sellbird tìm được, sẵn sàng đưa vào công cụ của mình. Vì mỗi địa chỉ có nhãn verified, risky, guess hoặc invalid, bạn biết ngay nên giữ địa chỉ nào.

> Không email nào rời máy bạn nếu bạn chưa bấm duyệt.
>
> — Ông T

### Chủ doanh nghiệp duyệt thư mỗi sáng

Bạn để `sellbird run` chạy nền. Mỗi chu kỳ, Sellbird viết chuỗi email cho khách mới và đặt vào Outbox. Sáng ra bạn mở dashboard, đọc từng email, sửa nếu cần rồi duyệt. Trước khi gửi, một bước kiểm tra không dùng mô hình AI sẽ loại thư còn sót merge tag chưa điền, cụm từ bị cấm, thư quá dài, thừa link hoặc địa chỉ không gửi được. Kết quả: bạn kiểm soát nội dung mà vẫn tiết kiệm phần lớn thời gian viết.

### Người làm sales xử lý phản hồi

Khi khách trả lời, Sellbird đọc thư, phân loại (như quan tâm hay phản đối), soạn sẵn câu trả lời, để riêng thư tự động và ghi nhận ngay yêu cầu từ chối. Những thư nó không nên tự trả lời sẽ được chuyển cho bạn. Bạn chỉ cần mở dashboard để xem nháp và quyết định. Nếu cần dừng tất cả, gõ `sellbird sending pause`.

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

- **`python3` báo phiên bản 3.9 hoặc cài gói thất bại.** Đây là lỗi README đã cảnh báo trên macOS. Hãy cài Python mới bằng `brew install python@3.13` rồi dùng `python3.13` để tạo môi trường ảo thay vì `python3`.
- **Không thấy lệnh `sellbird`.** Thường do bạn chưa kích hoạt môi trường ảo hoặc chưa cài xong bằng `pip install -e .`. Mở lại terminal trong thư mục dự án, kích hoạt `.venv` rồi thử lại.
- **Claude hoặc Codex chưa đăng nhập.** Sellbird nhờ vào gói đăng ký của bạn nên cần đăng nhập CLI trước. Với Claude, chạy `claude login`. Với ChatGPT, xem hướng dẫn Codex trong thư mục `docs/`.
- **Gửi mail không được hoặc lọt vào spam.** Kiểm tra lại các biến hộp thư trong `.env`, dùng tên miền gửi riêng và làm warmup hộp thư trước khi gửi nhiều. Xem thêm tài liệu Legal and deliverability và Troubleshooting trong repo.
- **`git pull` báo "your local changes would be overwritten" khi nâng cấp từ Harvey.** README hướng dẫn chạy `git stash`, `git pull`, `git stash pop`. Về lâu dài nên để cấu hình riêng trong `sellbird.local.yaml`, vì file này git không động tới.

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

**Điểm mạnh.** Không cần API mô hình riêng và không bị tính tiền theo token, vì dùng gói Claude hoặc ChatGPT bạn đang có. Nguồn tìm doanh nghiệp mặc định miễn phí. Mỗi tìm kiếm trả phí đều báo giá trước. Mọi thư chờ duyệt trước khi gửi, và có lệnh dừng khẩn cấp. Mã nguồn mở nên bạn đọc và chỉnh được các prompt, skill. Dự án vẫn được cập nhật trong ba tháng gần đây.

**Giới hạn.** Bạn phải tự lo hộp thư gửi, tên miền riêng và warmup, đây là phần dễ sai nhất của cold email. Cài đặt thủ công cần quen terminal, và README chưa ghi rõ lệnh cho Windows. Giấy phép là AGPL-3.0, bạn nên đọc kỹ nếu định tích hợp vào sản phẩm thương mại. Cold email có quy định pháp lý riêng tuỳ quốc gia, nên hãy đọc tài liệu pháp lý của repo và tự kiểm tra luật nơi bạn hoạt động.

**Khi nào chọn cách khác.** Nếu bạn không muốn tự vận hành gì cả, README nhắc tới bản hosted tại sellbird.ai (đang trong giai đoạn early access), có sẵn tên miền gửi, hộp thư và warmup. Nếu bạn chỉ cần vài chục liên hệ một lần, làm tay hoặc dùng công cụ quen thuộc có thể nhanh hơn. Còn nếu bạn muốn một dây chuyền tìm khách chạy trên máy mình, kiểm soát từng email gửi đi, thì Sellbird rất đáng thử.

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

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

Phần mềm là mã nguồn mở theo giấy phép AGPL-3.0. Theo README, nguồn tìm doanh nghiệp mặc định là miễn phí, còn nguồn trả phí rẻ nhất khoảng 0,37 USD cho 1.000 kết quả. 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 nhắc Google Workspace khoảng 7 USD mỗi tháng.

### Sellbird có cần API key của OpenAI hay Anthropic không?

Không. README nói 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ần API key mô hình và không tính tiền theo token. Một số dịch vụ tuỳ chọn khác như xác minh email vẫn có biến khoá riêng trong .env.example.

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

Tư liệu không yêu cầu GPU hay phần cứng đặc biệt. Phần suy nghĩ do Claude hoặc Codex đảm nhiệm thông qua gói đăng ký của bạn.

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

README có nêu thư mục dữ liệu cho Windows, nhưng các lệnh cài thủ công được viết theo kiểu macOS/Linux và Docker được ghi là dành cho Linux. README chưa ghi lệnh kích hoạt môi trường ảo cho Windows, nên bạn có thể nhờ Claude cài giúp hoặc xem tài liệu trong thư mục docs/ của repo.

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

Mặc định thì không. Mọi email nằm trong Outbox chờ bạn duyệt cho tới khi bạn tự bật autopilot. Ngay cả khi bật, các email có link tới tên miền không phải của bạn sẽ bị giữ lại, và bạn có thể dừng tất cả bằng lệnh sellbird sending pause.

### Dữ liệu của tôi lưu ở đâu, có an toàn không?

Cấu hình, kiến thức và dữ liệu nằm trong một thư mục home trên máy bạn, gồm cơ sở dữ liệu, log và token dashboard. Dashboard chạy ở địa chỉ cục bộ 127.0.0.1. README không nói thêm về mức bảo mật nên bạn nên tự bảo vệ file .env và xem SECURITY.md của repo.

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

Đó là cùng một dự án. Harvey được đổi tên thành Sellbird từ bản 0.4.0, cấu hình và dữ liệu của bạn được mang sang tự động. Các bản Harvey đến 0.3.x dùng giấy phép MIT, còn từ khi đổi tên là AGPL-3.0.
