# 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à nền tảng outreach mã nguồn mở viết bằng Python. Nó tìm công ty phù hợp, tìm người quyết định, kiểm tra email, viết và gửi cold email rồi xử lý phản hồi. Nó chạy bằng gói Claude Pro/Max hoặc ChatGPT (Codex) bạn đang có. Cài không quá khó, nhưng cần Python 3.11+ và một hộp thư để gửi.

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

Sellbird là một nền tảng mã nguồn mở giúp bạn đi hết quy trình bán hàng chủ động bằng email. Nó tìm các công ty cần thứ bạn bán, tìm người ra quyết định, kiểm tra địa chỉ email, viết email lạnh (cold email) riêng cho từng người, gửi đi và xử lý phản hồi. Toàn bộ chạy trên máy của bạn. Mặc định, không có email nào được gửi cho đến khi bạn bấm duyệt.

Repo này dành cho chủ doanh nghiệp nhỏ, người làm sales, agency, hoặc lập trình viên muốn có quy trình tìm khách mà không phải trả thêm cho các công cụ như Apollo, ZoomInfo, Clearbit hay Clay. Sellbird từng tên là Harvey. Hiện repo có khoảng 5.250 sao và 1.127 fork, và vẫn đượ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 để thấy nó chạy trước khi cài.

Điểm đáng giá nhất: Sellbird dùng chính gói Claude Pro/Max (qua Claude Code CLI) hoặc gói ChatGPT (qua Codex) của bạn để "suy nghĩ". Bạn không cần API key của model và không bị tính tiền theo token. Việc đọc website khách cũng không gọi model nên không tốn thêm.

```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, tìm người quyết định, xác minh email, viết cold email cá nhân hoá, gửi và xử lý trả lờ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 đường ống (pipeline). Bạn có thể chạy trọn vẹn, hoặc dừng ở bất kỳ bước nào.

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

Nó 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í và không cần tài khoản. 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. Nhờ vậy bạn không bị trừ tiền bất ngờ.

### Hiểu vì sao họ sẽ mua

Sellbird đọc chính website của từng công ty để tìm "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 model và không tốn phí (mỗi công ty chỉ ba request HTTP). Email viết ra sau đó có chi tiết thật để nhắc tới.

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

Nó tìm chủ hoặc quản lý được nêu tên trên các trang của chính công ty, tối đa hai người mỗi công ty. Nó không đi lục dữ liệu ở nơi khác.

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

Sellbird học cách đặt email của công ty rồi 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 bị gửi tới. Việc này bảo vệ uy tín hộp thư của bạn, vì gửi nhiều email trả lại sẽ khiến tên miền 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 thông tin đã tìm được. Sau đó nó gửi từ hộp thư Gmail, Microsoft 365 hoặc SMTP của bạn, trong hạn mức mỗi ngày và theo giờ làm việc của người nhận.

### Xử lý phản hồi

Nó đọc mọi thư trả lời và soạn sẵn câu trả lời. Thư tự động trả lời được tách riêng. Yêu cầu từ chối nhận mail được tôn trọng ngay. Những gì không nên tự trả lời thì nó chuyển cho bạn.

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

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

Theo README, bạn cần:

- **Python 3.11 trở lên.** File cấu hình dự án cũng yêu cầu Python >=3.11. README lưu ý macOS mặc định là Python 3.9, nên nếu `python3 --version` báo 3.9 thì chạy `brew install python@3.13` trước.
- **Một gói AI có sẵn:** Claude Pro hoặc Max với CLI đã đăng nhập (`claude login`), hoặc gói ChatGPT kèm 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.
- **Warmup (làm nóng) hộp thư đó.** README giới thiệu TrulyInbox cho việc này. Link TrulyInbox trong dự án là link affiliate, tức tác giả có thể nhận hoa hồng. Bạn không bắt buộc dùng nó, nhưng hộp thư mới mà gửi ồ ạt thì rất dễ vào thư rác.
- **Git** để tải mã nguồn.

Về phần cứng, tư liệu không nói cần GPU hay cấu hình riêng. Docker được nhắc là chạy được trên Linux. Về Windows, README chỉ nêu thư mục dữ liệu (`%APPDATA%\sellbird`), chưa có hướng dẫn cài riêng cho Windows.

File `.env.example` liệt kê nhiều biến tuỳ chọn: thông tin Gmail, SMTP/IMAP, Microsoft 365, và các dịch vụ xác minh email như Reoon, ZeroBounce, Hunter. Bạn không phải điền hết. Chỉ điền những gì bạn thật sự dùng.

```note
Lưu ý an toàn: file .env chứa mật khẩu và khoá của hộp thư. Không đưa nó lên GitHub, không gửi cho người khác. Dùng một tên miền gửi riêng thay vì tên miền chính của công ty, để nếu có sự cố thì website chính không bị ảnh hưởng.
```

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

```steps
- Tải mã nguồn | git clone repo về máy và vào thư mục
- Cài đặt | tạo môi trường ảo 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
- Chọn tín hiệu và tìm khách | signals rồi discover
- Mở bảng điều khiển | chạy dashboard và run
```

Có hai cách. Cách dễ nhất là nhờ Claude Code cài giúp. Cách còn lại là tự gõ lệnh.

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

Mở terminal (trên Windows là PowerShell, 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 mã nguồn 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õ câu: "set up Sellbird for me". Theo README, file `CLAUDE.md` trong repo biến Claude Code thành người hướng dẫn cài đặt: nó kiểm tra máy bạn, cài phần còn thiếu, hỏi những gì cần và dạy Sellbird về sản phẩm của bạn. Cách này hợp với người mới nhất.

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

Nếu muốn tự làm, vẫn phải ở trong thư mục `sellbird` vừa clone. Chạy:

```bash
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`, bật nó lên, rồi cài Sellbird vào đó. README dặn dùng `python3.13` chứ không dùng `python3`, vì trên macOS `python3` trần là bản 3.9 và sẽ không đủ. Lệnh `source .venv/bin/activate` là cú pháp của macOS/Linux. README chưa ghi lệnh bật môi trường ảo cho Windows. Nếu bạn dùng Windows, cách chắc ăn là chọn cách để Claude cài giúp ở trên, hoặc xem thư mục `docs/` trong repo.

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

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

Lệnh đầu sao chép file mẫu thành `.env`. Lệnh sau mở file đó để bạn sửa (`$EDITOR` là trình soạn thảo mặc định trên máy). README nói mỗi biến đều có chú thích ngay trong file. Nếu không quen terminal, bạn cứ mở file `.env` bằng Notepad hay VS Code để điền.

### 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ủa bạn. Sellbird đọc trang web để hiểu bạn bán gì, rồi ghi kết quả vào file `sellbird.local.yaml`. Đây là file riêng của bạn, git không đụng tới.

### Xác nhậ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. Lệnh sau đi tìm doanh nghiệp. Nguồn mặc định 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          # prints a private link to http://127.0.0.1:5555
sellbird run
```

Lệnh `sellbird dashboard` in ra một đường link riêng tới địa chỉ trên máy bạn (127.0.0.1:5555). Chỉ máy bạn mở được. Lệnh `sellbird run` khởi động vòng lặp chính. Người mới hay vấp ở chỗ: hai lệnh này nên chạy ở hai cửa sổ terminal khác nhau nếu lệnh đầu vẫn đang chiếm cửa sổ.

Trên Linux, bạn cũng có thể chạy bằng Docker. Repo có sẵn `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

Sau khi chạy `sellbird run`, bạn sẽ thấy màn hình tương tự ví dụ trong README: dòng "Sellbird is online", rồi "Checking pipeline state...", rồi một dòng "Decision" cho biết bước tiếp theo. Cuối chu kỳ có dòng "Cycle complete. Sleeping for 15 minutes." và số email đang chờ bạn duyệt trong Outbox.

Cách kiểm tra đơn giản:

- Lệnh `sellbird dashboard` in ra được link và mở được trong trình duyệt.
- Sau `sellbird discover`, bảng điều khiển hiện danh sách công ty tìm được.
- Sau `sellbird run`, có email nằm trong Outbox chờ duyệt.

Nếu có email xuất hiện trong Outbox mà chưa có gì bị gửi đi, đó là hành vi đúng: mặc định mọi thư đều chờ bạn.

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

### Chủ agency web tìm khách là tiệm nha khoa

Bạn bán dịch vụ đặt lịch online cho nha khoa. Bạn chạy `sellbird train` với website của mình, rồi `sellbird signals --confirm free` để chọn tín hiệu như "chưa có đặt lịch online". Sau đó `sellbird discover` tìm các phòng khám theo nguồn miễn phí. Sellbird đọc website từng phòng khám, tìm chủ phòng, kiểm tra email và viết một chuỗi hai email nhắc đúng chi tiết đó. Kết quả là một hàng email nằm trong Outbox, bạn đọc lại từng thư rồi duyệt.

> Mặc định không có gì được gửi đi nếu bạn chưa bấm duyệt, nên bạn thử thoải mái mà không sợ lỡ tay.
>
> — Ông T

### Nhân viên sales chỉ cần danh sách khách

Công ty bạn đã có công cụ gửi mail (sequencer) riêng. Bạn chỉ muốn Sellbird làm phần tìm và kiểm tra. Hãy chạy pipeline tới bước xác minh, rồi chạy:

```bash
sellbird export
```

Bạn nhận file CSV gồm những gì nó tìm được, dán thẳng vào công cụ đang dùng. Hãy lọc theo nhãn verified để chỉ giữ địa chỉ đáng tin.

### Duyệt thư và xử lý phản hồi hằng ngày

Bạn để `sellbird run` chạy nền. Mỗi vài phút nó kiểm tra lại. Khi khách trả lời, Sellbird phân loại (quan tâm, phản đối…), soạn sẵn câu trả lời và đưa vào Outbox. Bạn mở bảng điều khiển, sửa một chữ ở đây, bấm duyệt ở kia. Thư tự động trả lời bị đặt riêng, người xin ngừng gửi được tôn trọng ngay. Nếu thấy có gì không ổn, chạy `sellbird sending pause` để dừng toàn bộ việc gửi.

### Lập trình viên đang dùng Harvey cần nâng cấp

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

```bash
git pull
pip install -e .        # once, to get the new `sellbird` command
sellbird dashboard
```

Lần chạy đầu, Sellbird tự đổi tên `harvey.local.yaml` thành `sellbird.local.yaml` và đổi tên file dữ liệu. Nó không ghi đè file nào đã có sẵn. Biến `HARVEY_*` vẫn dùng được khi chưa có biến `SELLBIRD_*` tương ứng.

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

### Báo sai phiên bản Python hoặc không cài được

Nếu `python3 --version` ra 3.9 (hay gặp trên macOS), gói sẽ không cài được vì cần 3.11 trở lên. Cài bản mới như README gợi ý (`brew install python@3.13`) rồi tạo lại môi trường ảo bằng `python3.13`.

### Claude hoặc Codex chưa đăng nhập

Sellbird dựa vào CLI của gói bạn đang có. Nếu CLI chưa đăng nhập, nó sẽ không "suy nghĩ" được. Với Claude, chạy `claude login` rồi thử lại. Với Codex, xem tài liệu Codex trong thư mục `docs/`.

### Không thấy email nào được gửi

Thường là bình thường: mặc định mọi email chờ bạn duyệt trong Outbox. Mở bảng điều khiển và duyệt. Ngoài ra, trước khi gửi còn có bước kiểm tra không dùng model: nó loại thư còn sót thẻ chưa điền, cụm từ bị cấm, thư quá dài, quá nhiều link, hoặc địa chỉ không gửi được. Thư bị loại là do bộ lọc này chứ không phải lỗi.

### `git pull` báo "your local changes would be overwritten"

Chuyện này xảy ra khi bạn từng sửa trực tiếp file `harvey.yaml`. Làm 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á dấu xung đột rồi chạy `git stash drop`. Lần sau hãy đặt cài đặt riêng trong `sellbird.local.yaml`.

### Thư vào hộp thư rác

Đây không hẳn lỗi của phần mềm. Hộp thư mới chưa warmup hoặc gửi quá nhiều sẽ bị đánh dấu spam. Hãy warmup hộp thư trước, giữ hạn mức gửi thấp, và đọc tài liệu "Legal and deliverability" trong `docs/` về quy định gửi email và độ tin cậy của hộp thư.

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

**Điểm mạnh.** Bạn không phải trả tiền API model, vì nó dùng gói Claude hoặc ChatGPT sẵn có. Nguồn tìm công ty mặc định miễn phí. Mọi thư chờ bạn duyệt, có bộ lọc trước khi gửi, và có lệnh dừng khẩn. Dữ liệu và cấu hình nằm trên máy bạn. Mã nguồn mở nên bạn đọc và sửa được.

**Giới hạn.** Bạn vẫn cần một hộp thư gửi, nên có thể tốn khoảng 7 đô la một tháng nếu dùng Google Workspace theo README. Warmup cũng là việc bạn phải tự lo. Gói Claude hay ChatGPT có hạn mức riêng, nên Sellbird tự giãn nhịp để chừa chỗ cho việc của bạn. Mỗi công ty tối đa hai người, và chỉ gửi tới một địa chỉ đã xác minh. Với người dùng Windows, tư liệu chưa có hướng dẫn cài riêng. Giấy phép là AGPL-3.0: nếu bạn định sửa và cung cấp nó như một dịch vụ cho người khác, hãy đọc kỹ điều khoản.

**Khi nào 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 được lưu trữ sẵn (đang trong giai đoạn truy cập sớm). Nếu bạn cần dữ liệu liên hệ cho thị trường mà OpenStreetMap ít phủ, hãy kiểm tra trước bằng một lượt `sellbird discover` nhỏ. Và dù dùng công cụ nào, cold email vẫn cần tuân thủ quy định nơi bạn gửi tới. Hãy gửi ít, viết thật và đọc lại từng thư trước khi duyệt.

## 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. Nguồn tìm doanh nghiệp mặc định (OpenStreetMap) miễn phí, và việc đọc website không tốn phí. Bạn vẫn cần gói Claude Pro/Max hoặc ChatGPT có sẵn, và một hộp thư để gửi (README nêu khoảng 7 đô la một tháng cho Google Workspace).

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

Không. README nói Sellbird chạy qua Claude Code CLI trên gói Claude Pro/Max, hoặc qua Codex trên gói ChatGPT. Không có API key model và không tính tiền theo token.

### Cần GPU không?

Tư liệu không yêu cầu GPU. Phần suy nghĩ do Claude hoặc Codex đảm nhiệm qua gói đăng ký của bạn, không chạy model trên máy.

### 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 đặt chỉ ghi cho macOS/Linux, và Docker được nhắc cho Linux. Chưa có hướng dẫn riêng cho Windows trong tư liệu. Bạn có thể nhờ Claude Code cài giúp hoặc xem thư mục docs/ trong repo.

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

Không, mặc định. Mọi email đều chờ trong Outbox cho tới khi bạn duyệt hoặc tự bật chế độ autopilot. Lệnh sellbird sending pause dừng toàn bộ việc gửi ngay lập tức.

### Dữ liệu của tôi nằm ở đâ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 trên máy bạn, và bảng điều khiển chạy ở địa chỉ nội bộ 127.0.0.1. Tư liệu không nói thêm về mức an toàn chi tiết, nên hãy tự bảo vệ file .env và xem SECURITY.md trong repo.

### Khác gì Apollo, ZoomInfo hay Clay?

README nói Sellbird không dùng các công cụ prospecting đó. Nó tự tìm công ty, tìm người quyết định từ trang của chính công ty và xác minh email. Tư liệu không so sánh chi tiết về độ phủ dữ liệu, nên bạn nên thử một lượt nhỏ trước.
