# 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 là Harvey) là nền tảng mã nguồn mở viết bằng Python, giúp bạn tìm khách hàng tiềm năng, kiểm tra email, viết và gửi cold email, rồi xử lý thư trả lời. Nó dùng gói Claude Pro/Max hoặc ChatGPT (Codex) bạn đang có, không cần API key của mô hình. Cài bằng vài lệnh, nhưng cần thêm hộp thư gửi riêng và bước khởi động (warmup) cho hộp thư đó.

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

Sellbird là một nền tảng mã nguồn mở chạy ngay trên máy của bạn, làm trọn chuỗi việc bán hàng chủ động qua email: 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 từng email riêng cho từng người, gửi đi và xử lý thư trả lời. Dự án trước đây tên là Harvey, nay đổi tên thành Sellbird. Hiện có khoảng 5.249 sao và 1.127 fork trên GitHub.

Bạn nên xem qua nếu đang làm kinh doanh nhỏ, làm sale, làm agency hoặc tự bán dịch vụ, và muốn tiếp cận khách mới mà không phải trả tiền cho cả bộ công cụ như Apollo, ZoomInfo, Clearbit hay Clay. README nói rõ Sellbird không dùng các công cụ đó.

Điểm đáng giá nhất là chuyện chi phí mô hình AI. Sellbird "suy nghĩ" thông qua Claude Code CLI trên gói Claude Pro hoặc Max của bạn, hoặc qua Codex trên gói ChatGPT. Không có API key mô hình, không tính tiền theo token. Điểm thứ hai là mặc định không có email nào được gửi đi nếu bạn chưa duyệt. Bạn có thể xem video ngắn bên dưới để thấy nó chạy trước khi bắt tay cài.

```repo
- repo | ethanplusai/sellbird
- kind | Ứng dụng
- desc | Sellbird tìm công ty và người ra quyết định, kiểm tra email, viết cold email cá nhân hoá rồi gửi và xử lý thư trả lời, chạy bằng gói Claude hoặc ChatGPT.
- stars | 5.2k
- 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. Bạn có thể chạy hết từ đầu đến cuối, 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 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. Nhờ vậ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, 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, chỉ gửi ba yêu cầu HTTP cho mỗi công ty. README nói có 29 tín hiệu.
- **Tìm người quyết định.** Tìm chủ hoặc quản lý được nêu tên trên chính trang web của công ty, tối đa hai người mỗi công ty. Email của bạn nhờ vậy gửi đúng người thay vì một hộp thư chung.
- **Kiểm tra địa chỉ email.** Sellbird học kiểu địa chỉ 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. Chỉ địa chỉ gửi được mới được dùng để gửi. Việc này giúp hạn chế thư 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ì nó 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 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 từ chối 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.
- **Xuất danh sách.** 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` để có file CSV dùng được ngay với công cụ gửi mail khác.

Ngoài ra có một bảng điều khiển (dashboard) chạy trên máy bạn, và có hộp Outbox để duyệt từng email trước khi gửi.

## 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 từ 3.11. README lưu ý macOS đi kèm 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**, đã đă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 chạy được.
- **Khởi động (warmup) hộp thư đó.** README giới thiệu TrulyInbox để làm nóng hộp thư mới trước khi gửi cold email. Đây là liên kết tiếp thị liên kết, tác giả có thể nhận hoa hồng. Sellbird đọc tỷ lệ vào hộp thư đến từ TrulyInbox để báo bạn khi nào đã sẵn sàng.
- **Git**, để tải mã nguồn về.

Về phần cứng, tư liệu không nêu yêu cầu cụ thể, và không thấy nhắc đến GPU vì phần suy nghĩ chạy qua gói Claude hoặc ChatGPT của bạn. Về hệ điều hành, README có bảng thư mục dữ liệu cho macOS, Windows và Linux. Docker thì README chỉ nói dùng được trên 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, không dùng hộp thư chính của công ty. Đừng dán mật khẩu hay key vào chỗ nào ngoài file .env trên máy bạn.
```

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

Có hai đường: nhờ Claude Code hướng dẫn cài, hoặc tự gõ lệnh. Bạn chọn một.

```steps
- Tải mã nguồn | Dùng git clone rồi cd vào thư mục sellbird
- Cài đặt | Tạo môi trường ảo Python và chạy 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 về sản phẩm | Chạy sellbird train với địa chỉ website của bạn
- Tìm khách | Xác nhận tín hiệu rồi chạy sellbird discover
- Mở bảng điều khiển | Chạy sellbird dashboard và sellbird run
```

### Tải mã nguồn về máy

Mở terminal (trên Windows là PowerShell hoặc Git Bash) ở thư mục bạn muốn lưu dự án, rồi chạy:

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

Lệnh đầu tải mã về, lệnh thứ hai đi vào thư mục vừa tải. Mọi lệnh sau đều phải chạy trong thư mục `sellbird` này. Đây là chỗ người mới hay vấp nhất: mở terminal mới là về lại thư mục khác.

### Cách 1: để Claude Code cài giúp

Nếu bạn đã có Claude Code, chỉ cần chạy tiếp:

```bash
claude
```

Rồi gõ câu: **"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 bạn, cài những gì còn thiếu, hỏi thông tin cần thiết và dạy Sellbird về sản phẩm của bạn. Với người mới, đây là cách dễ nhất.

### Cách 2: tự cài, bước 1 và 2 — cài đặt và điền thông tin

Đây là các lệnh nguyên văn trong 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 .

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

Lệnh đầu tạo một môi trường ảo tên `.venv` (một "hộp" riêng cho gói Python), bật nó lên, rồi cài Sellbird vào đó. Lệnh `source .venv/bin/activate` là cú pháp của macOS và Linux. README chưa ghi lệnh bật môi trường ảo riêng cho Windows, nên nếu dùng Windows bạn có thể tham khảo mục Troubleshooting trong thư mục `docs/` hoặc cách 1 ở trên.

Lệnh thứ hai chép file mẫu `.env.example` thành `.env` rồi mở ra để bạn sửa. File này chứa các biến như `GMAIL_CLIENT_ID`, `SMTP_HOST`, `REOON_API_KEY`, `HUNTER_API_KEY`, `TRULYINBOX_API_KEY`. README nói mỗi biến đều có giải thích ngay trong file. Bạn chỉ cần điền phần mình dùng, ví dụ thông tin hộp thư gửi. Các key của dịch vụ trả phí là tuỳ chọn, bạn có thể bỏ trống nếu không dùng.

### Bước 3 và 4 — 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 `sellbird 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ỉ trang web thật của bạn. Lệnh `sellbird signals --confirm free` để bạn xác nhận thế nào là một khách tiềm năng tốt. Hãy làm kỹ bước này vì các tín hiệu mua hàng quyết định danh sách khách sau đó.

### Bước 5 — tìm doanh nghiệp

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

Nguồn mặc định miễn phí và không cần tài khoản. Lệnh này tìm các doanh nghiệp hợp với khách hàng bạn đã mô tả.

### Bước 6 — mở bảng điều khiển 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ới `http://127.0.0.1:5555`. Địa chỉ này chỉ mở được trên máy bạn. `sellbird run` bật vòng lặp làm việc. Mỗi chu kỳ nó kiểm tra trạng thái, viết email, soạn câu trả lời, rồi nghỉ 15 phút theo ví dụ trong README. Bạn nên mở hai cửa sổ terminal, một cho dashboard và một cho run.

Nếu dùng Linux, README nói bạn cũng có thể chạy bằng Docker. Repo có `Dockerfile` và `docker-compose.yml`, còn hướng dẫn chi tiết nằm trong tài liệu Docker của repo.

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

Có ba dấu hiệu để biết cài thành công:

1. `python3 --version` (hoặc `python3.13 --version`) báo từ 3.11 trở lên.
2. Sau `pip install -e .`, lệnh `sellbird` có thể gọi được trong terminal.
3. `sellbird dashboard` in ra link riêng và bạn mở được trang ở `http://127.0.0.1:5555`.

Khi chạy `sellbird run`, README mô tả màn hình sẽ hiện dòng "Sellbird is online", rồi "Checking pipeline state...", sau đó là một quyết định như `write_campaign`, và cuối cùng là "Cycle complete. Sleeping for 15 minutes." Dòng `outbox → 5 emails waiting for your approval` nghĩa là email đã được viết và đang chờ bạn duyệt. Chưa có gì bị gửi đi.

Với dữ liệu thật, bạn sẽ thấy các công ty và người liên hệ xuất hiện trong dashboard sau khi chạy `sellbird discover`.

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

Bạn có thể dùng Sellbird theo nhiều cách. Dưới đây là bốn tình huống bám đúng khả năng của repo.

### Chủ một dịch vụ địa phương muốn tìm khách mới

Chị Hà có một xưởng làm phần mềm đặt lịch cho tiệm làm đẹp và phòng khám nhỏ. Chị chạy `sellbird train` với địa chỉ website của mình để Sellbird hiểu sản phẩm. Sau đó chị xác nhận các tín hiệu như "chưa có đặt lịch online" bằng `sellbird signals --confirm free`, rồi chạy `sellbird discover`. Kết quả là một danh sách doanh nghiệp phù hợp, kèm lý do vì sao họ có thể cần sản phẩm. README lấy ví dụ tương tự: bản demo bán phần mềm đặt lịch cho thợ lợp mái, phòng nha và tiệm điều hoà.

Lưu ý README mô tả nguồn mặc định là OpenStreetMap. Độ phủ dữ liệu ở Việt Nam thế nào thì tư liệu chưa nói, nên bạn hãy thử với một nhóm nhỏ trước.

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

Anh Nam làm sale cho một công ty B2B và đã có sẵn công cụ gửi mail. Anh không muốn Sellbird gửi gì cả. Anh chạy các bước tìm công ty, tìm người quyết định và kiểm tra email, rồi dùng:

```bash
sellbird export
```

Lệnh này xuất file CSV có đủ những gì Sellbird tìm được, sẵn sàng đưa vào công cụ gửi mail của anh. Mỗi địa chỉ đã có nhãn verified, risky, guess hoặc invalid, nên anh có thể lọc bỏ địa chỉ không đáng tin trước khi gửi.

> Mặc định, không có email nào rời máy bạn nếu bạn chưa bấm duyệt.
>
> — Ông T

### Chủ shop muốn duyệt từng email trước khi gửi

Chị Lan bán sỉ vật tư và chưa tin hẳn vào email do AI viết. Chị mở `sellbird dashboard`, vào hộp Outbox và đọc từng email đang chờ. Mỗi email đều đã qua bước kiểm tra trước khi gửi, không dùng mô hình, loại bỏ các trường 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. Chị đọc, sửa nếu cần rồi mới duyệt. Chỉ khi chị tự bật chế độ autopilot thì Sellbird mới gửi mà không cần duyệt. Ngay cả khi đó, nó vẫn giữ lại email có link tới tên miền không phải của chị.

Nếu có chuyện bất ngờ, một lệnh sau đây dừng toàn bộ việc gửi:

```bash
sellbird sending pause
```

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

Một lập trình viên đã chạy Harvey từ trước chỉ cần cập nhật. Cấu hình, dữ liệu và đăng nhập dashboard đều được giữ nguyên:

```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à `data/harvey.db` thành `data/sellbird.*`. Các biến `HARVEY_*` vẫn dùng được khi chưa có biến `SELLBIRD_*` tương ứng. Nếu bạn từng sửa trực tiếp file `harvey.yaml` thì `git pull` sẽ báo lỗi, xem phần lỗi bên dưới.

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

### Báo Python 3.9 hoặc không cài được

Trên macOS, `python3` trần thường là bản 3.9, thấp hơn mức 3.11 mà dự án yêu cầu. Hãy chạy `brew install python@3.13`, rồi dùng đúng `python3.13` khi tạo môi trường ảo, như README dặn. Kiểm tra lại bằng `python3.13 --version`.

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

Sellbird không có API key mô hình, nó dựa vào CLI đã đăng nhập. Nếu Claude Code chưa đăng nhập, bạn chạy `claude login` rồi thử lại. Nếu dùng ChatGPT, hãy làm theo hướng dẫn "Using a ChatGPT plan (Codex)" trong thư mục `docs/` của repo.

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

Lỗi này xảy ra khi bạn từng sửa trực tiếp `harvey.yaml` rồi nâng cấp. README hướng dẫn chạy `git stash`, `git pull`, rồi `git stash pop`. Git sẽ chuyển chỉnh sửa của bạn sang `sellbird.yaml`. Nếu báo xung đột, giữ các dòng của bạn, xoá các dấu xung đột, rồi chạy `git stash drop`. Cách tốt hơn là đặt thiết lập riêng vào `sellbird.local.yaml`, file mà git không đụng tới.

### Email không được gửi dù đã viết xong

Có thể do email chưa được duyệt trong Outbox, hoặc địa chỉ người nhận bị đánh dấu risky, guess hoặc invalid. Sellbird chỉ gửi đến địa chỉ gửi được. Hãy mở dashboard, xem Outbox và nhãn của từng địa chỉ. Đừng ép gửi tới địa chỉ không đáng tin vì sẽ làm hỏng uy tín hộp thư.

### Đổi tên từ Harvey nhưng tiến trình cũ vẫn chạy

README cho biết Sellbird sẽ chờ nếu vẫn còn một tiến trình Harvey đang chạy từ thư mục đó. Hãy dừng tiến trình cũ trước, rồi chạy lại. Nếu dùng Docker, tên dịch vụ nay là `sellbird`: chạy `docker compose down`, `git pull`, `docker compose build`, rồi `docker compose up -d`.

Với các lỗi khác, README trỏ tới tài liệu Troubleshooting trong thư mục `docs/` của repo.

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

**Điểm mạnh.** Không tốn tiền API mô hình vì dùng gói bạn đang có. Bước tìm công ty mặc định miễn phí, bước đọc website cũng miễn phí. Mọi thứ chạy trên máy bạn, dữ liệu nằm trong một thư mục của bạn. Cơ chế an toàn khá rõ: mặc định phải duyệt, có kiểm tra trước khi gửi, có lệnh dừng khẩn cấp. Repo vẫn được cập nhật trong 3 tháng gần đây.

**Giới hạn.** Bạn vẫn phải có hộp thư gửi, nên có tên miền riêng, và phải warmup trước khi gửi. README nói rõ điều này, còn chi phí hộp thư theo README khoảng 7 đô la mỗi tháng cho Google Workspace. Việc tìm doanh nghiệp, tìm người quyết định và tín hiệu mua hàng đều dựa vào dữ liệu công khai, nên chất lượng sẽ khác nhau theo ngành và theo nước. Tư liệu không nói gì cụ thể về độ phủ ở thị trường Việt Nam. 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.

**Pháp lý.** Gửi cold email chịu ràng buộc theo luật ở nơi bạn và người nhận. README có tài liệu "Legal and deliverability" nói về quy tắc gửi mail, bạn nên đọc trước khi bật chế độ tự động.

**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 chạy sẵn trên sellbird.ai, hiện đang trong giai đoạn truy cập sớm. Nếu bạn chỉ gửi vài email mỗi tuần thì cài cả hệ thống này có thể là quá nhiều. Nếu bạn không dùng Python hay terminal, hãy bắt đầu bằng cách 1, để Claude Code dẫn từng bước.

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

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

Mã nguồn miễn phí, theo giấy phép AGPL-3.0. Bạn vẫn cần gói Claude Pro/Max hoặc ChatGPT có Codex, và một hộp thư để gửi, ví dụ Google Workspace khoảng 7 đô la mỗi tháng theo README. Nguồn tìm doanh nghiệp mặc định là miễn phí, nguồn trả phí sẽ hiện chi phí trước khi chạy.

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

Không. README nói Sellbird dùng Claude Code CLI trên gói Claude Pro hoặc Max, hoặc Codex trên gói ChatGPT, không có API key và không tính tiền theo token. Bạn chỉ cần đăng nhập CLI (`claude login`).

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

Tư liệu không nhắc đến yêu cầu GPU. Phần suy nghĩ chạy qua gói Claude hoặc ChatGPT của bạn, nên không có mô hình nào chạy trên máy bạn.

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

README có ghi thư mục dữ liệu cho Windows (`%APPDATA%\sellbird`), nhưng lệnh bật môi trường ảo trong README viết cho macOS và Linux. Docker chỉ được nhắc cho Linux. Bạn có thể cho Claude Code hướng dẫn cài (cách 1) hoặc xem tài liệu Troubleshooting trong 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 chờ trong Outbox cho đến khi bạn duyệt, trừ khi bạn tự bật 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 có an toàn không?

README nói Sellbird chạy trên máy của bạn, cấu hình, kiến thức và dữ liệu nằm trong một thư mục riêng, và dashboard chỉ mở ở địa chỉ 127.0.0.1. Tư liệu không nói thêm về các chi tiết bảo mật khác, nên bạn nên xem tệp SECURITY.md trong repo.

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

README nói Sellbird không dùng các công cụ prospecting như Apollo, ZoomInfo, Clearbit hay Clay, và tự tìm công ty, người liên hệ và kiểm tra email trong cùng một dây chuyền. Tư liệu không có so sánh chi tiết về chất lượng dữ liệu giữa các công cụ.
