# Sellbird: tự tìm khách, viết và gửi cold email bằng gói Claude/ChatGPT — 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ìm khách hàng tiềm năng, xác minh email, viết và gửi cold email rồi xử lý thư trả lời. Nó dùng Claude Code CLI hoặc Codex nên không cần API key của mô hình. Cài bằng vài lệnh, mặc định không email nào được gửi khi bạn chưa duyệt.

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

Sellbird là một nền tảng mã nguồn mở chạy trên máy của bạn, làm trọn quy trình bán hàng qua email lạnh (cold email). Nó 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 đị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.

Bạn nên xem qua nếu bạn bán dịch vụ cho doanh nghiệp nhỏ (phòng khám, tiệm sửa chữa, công ty xây dựng…) và đang tốn nhiều giờ lập danh sách khách, viết thư tay. Dev mới cũng dùng được, vì repo có sẵn hướng dẫn để Claude Code dẫn bạn cài từng bước. Hiện repo có khoảng 5.250 sao và 1.127 fork, và vẫn được cập nhật trong 3 tháng gần đây.

Điểm đáng giá nhất là hai thứ. Thứ nhất, Sellbird dùng gói Claude Pro/Max (qua Claude Code CLI) hoặc gói ChatGPT (qua Codex) bạn đang trả, nên không có hoá đơn API theo từng token. Thứ hai, mặc định không có 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 ra sao, rồi quay lại đọc phần cài đặt.

```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 và gửi cold email cá nhân hoá, chạy trên 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. Bạn có thể chạy hết từ đầu đến cuối, hoặc dừng ở bước nào cũng được.

### 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. Nếu bạn chọn nguồn trả phí, mỗi lần tìm đều hiện chi phí trước khi chạy, nên không lo 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ì. Theo README, mỗi công ty chỉ cần ba request HTTP.

Lợi ích thực tế: thư của bạn có lý do để gửi, thay vì thư đại trà "xin chào, bên mình có dịch vụ".

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

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

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

Sellbird học cấu trúc email của công ty rồi xác minh một địa chỉ. Mỗi địa chỉ được gắn nhãn: đã xác minh, rủi ro, đoán, hoặc không hợp lệ. Chỉ địa chỉ có thể nhận thư mới được gửi tới. Việc này giúp bạn tránh gửi vào địa chỉ chết, thứ làm hỏng uy tín tên miền gửi thư.

### 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, rồi gửi từ hộp thư Gmail, Microsoft 365 hoặc SMTP của bạn. Việc gửi nằm trong giới hạn 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 và soạn sẵn câu đáp. Thư tự động trả lời được đặt riêng ra. Yêu cầu từ chối nhận thư được thực hiện ngay. Trường hợp nó không nên tự trả lời, nó chuyển cho bạn.

### Chỉ muốn lấy danh sách?

Dừng sau bước xác minh và chạy `sellbird export` để có file CSV sẵn sàng đư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 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 **một gói ChatGPT có Codex CLI** (repo có hướng dẫn riêng cho Codex).
- **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 thư riêng. Microsoft 365 và SMTP cũng chạy được.
- **Warmup (làm nóng) hộp thư đó.** README giới thiệu TrulyInbox cho việc này; Sellbird đọc tỉ lệ vào hộp thư chính của nó để báo bạn khi nào sẵn sàng. Lưu ý: link TrulyInbox trong dự án là link affiliate, người duy trì dự án có thể nhận hoa hồng.

Về chi phí, README liệt kê: tìm doanh nghiệp là 0 đô trên nguồn mặc định, hoặc khoảng 0,37 đô cho 1.000 kết quả trên nguồn trả phí rẻ nhất. Đọc website là 0 đô. Hộp thư Google Workspace khoảng 7 đô một tháng.

File `.env.example` còn liệt kê nhiều biến tuỳ chọn (Gmail, SMTP, IMAP, Microsoft 365, Instantly, Hunter, ZeroBounce, Reoon, TrulyInbox…). Bạn chỉ điền những gì mình thực sự dùng.

Về hệ điều hành: README viết các lệnh cho macOS/Linux và nói Docker chạy được trên Linux. Phần thư mục dữ liệu có nhắc cả Windows (`%APPDATA%\sellbird`), nhưng README chưa ghi riêng các bước cài trên Windows.

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

```steps
- Tải mã nguồn | Clone repo về máy rồi vào thư mục sellbird
- Cài đặt | Tạo môi trường ảo Python 3.13 và cài gói bằng pip
- Điền thông tin | Sao chép .env.example thành .env rồi điền credentials
- Dạy Sellbird | Cho nó đọc website của bạn và xác nhận tín hiệu khách hàng tốt
- Tìm khách | Chạy discover để tìm doanh nghiệp
- Chạy | Mở dashboard và bật vòng lặp chính
```

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

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

Mở terminal (Terminal trên macOS, hoặc cửa sổ dòng lệnh bạn quen dùng) và 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 đó. Điều quan trọng: phải chạy `claude` bên trong thư mục `sellbird`, vì file `CLAUDE.md` của repo mới được nạp.

Khi Claude Code mở, bạn gõ:

```
set up Sellbird for me
```

Theo README, `CLAUDE.md` biến Claude Code thành người hướng dẫn: nó kiểm tra bạn đang ở đâu, cài những thứ 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.

### Cách 2: tự cài, bước 1 — tạo môi trường và cài gói

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

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

Lệnh này tạo môi trường ảo tên `.venv`, kích hoạt nó, rồi cài Sellbird ở chế độ chỉnh sửa được. README nhấn mạnh 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 đáp ứng yêu cầu. Dòng `source .venv/bin/activate` là cú pháp macOS/Linux. README chưa ghi lệnh kích hoạt cho Windows, bạn nên xem thêm trong thư mục `docs/` của repo.

### Bước 2 — thêm 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 đó để sửa (`$EDITOR` là trình soạn thảo mặc định của máy bạn). README nói mỗi biến đều có giải thích ngay trong file. Chỗ người mới hay vấp: bạn chỉ cần điền phần của hộp thư mình dùng, ví dụ nhóm SMTP nếu bạn gửi qua SMTP. Đừng chia sẻ file `.env` cho ai.

### Bước 3 — dạy Sellbird về sản phẩm

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

Thay địa chỉ bằng website công ty bạn. Sellbird đọc trang đó để hiểu bạn bán gì, rồi ghi kết quả vào file `sellbird.local.yaml`.

### Bước 4 — xác nhận thế nào là khách tốt

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

Bước này chốt các tín hiệu cho thấy một doanh nghiệp đáng tiếp cận. Dùng đúng cờ `--confirm free` như README.

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

```bash
sellbird discover
```

Nguồn mặc định miễn phí và không cần tài khoản.

### Bước 6 — mở dashboard và chạy

```bash
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 địa chỉ trên máy bạn (127.0.0.1:5555). Đây là nơi bạn xem và duyệt email. `sellbird run` bật vòng lặp chính. Nên mở dashboard trước để thấy Outbox khi nó bắt đầu có thư chờ duyệt.

```note
Mặc định mọi email nằm chờ trong Outbox cho đến khi bạn duyệt. Đừng bật autopilot khi chưa kiểm tra kỹ nội dung và chưa warmup xong hộp thư. Cần dừng khẩn cấp thì chạy sellbird sending pause.
```

Ngoài ra, trên Linux bạn có thể chạy bằng Docker. Repo có sẵn Dockerfile và docker-compose.yml, chi tiết xem trong thư mục `docs/`.

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

Sau `sellbird run`, bạn sẽ thấy dòng thông báo tương tự ví dụ trong README:

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

Những dấu hiệu cho thấy ổn:

- Terminal hiện "Sellbird is online" và kết thúc một chu kỳ rồi chờ 15 phút cho vòng sau.
- Dòng `outbox` cho biết có bao nhiêu email đang chờ bạn duyệt.
- Mở link do `sellbird dashboard` in ra, bạn thấy giao diện và các email chờ duyệt.

Số liệu trong ví dụ là dữ liệu mẫu, của công ty giả "Bookwell" bán phần mềm đặt lịch cho thợ lợp mái, phòng nha và tiệm điều hoà, chạy trên tên miền `.test`. Dữ liệu thật của bạn sẽ khác.

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

Bám theo những gì README mô tả, dưới đây là vài tình huống thực tế.

### Chủ công ty phần mềm tìm khách là phòng khám

Bạn bán phần mềm đặt lịch hẹn và muốn tiếp cận các phòng khám nha khoa. Bạn chạy `sellbird train` với website của mình, xác nhận tín hiệu "chưa có đặt lịch online", rồi `sellbird discover`. Sellbird tìm các phòng khám, đọc website của họ để xem có tín hiệu đó không, tìm tên chủ phòng khám và kiểm tra email. Kết quả là một danh sách khách có lý do rõ ràng để liên hệ, và một chuỗi email ngắn riêng cho từng người.

> Công cụ này không thay bạn quyết định gửi gì, nó thay bạn làm phần việc nhàm chán trước khi bạn bấm duyệt.
>
> — Ông T

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

Công ty bạn đã có phần mềm gửi email riêng và chỉ thiếu danh sách khách đã kiểm tra. Bạn dừng pipeline sau bước xác minh rồi chạy:

```bash
sellbird export
```

Bạn nhận file CSV sẵn sàng đưa vào công cụ gửi thư. Phù hợp khi bạn không muốn Sellbird tự gửi.

### Duyệt thư và xử lý trả lời mỗi buổi sáng

Bạn để `sellbird run` chạy, rồi mỗi sáng mở dashboard. Trong Outbox có các email chờ duyệt; bạn đọc, sửa nếu cần rồi cho gửi. Khi có người trả lời, Sellbird đã soạn sẵn câu đáp cho trường hợp quan tâm hoặc phản đối, đồng thời tách riêng thư tự động trả lời. Nếu có việc gấp hoặc thấy có gì lạ, bạn chạy `sellbird sending pause` để dừng mọi việc gửi.

Trước khi gửi, một bước kiểm tra không dùng mô hình sẽ loại các thư còn sót merge tag chưa điền, chứa cụm từ bị cấm, quá dài, có thừa link hoặc gửi tới địa chỉ không nhận được thư. Nhờ vậy bạn đỡ phải soi từng lỗi nhỏ.

### Dev tuỳ biến theo ngành của mình

Nếu bạn là lập trình viên, các file `prompts/` và `skills/` là những kịch bản bán hàng có thể chỉnh sửa. Settings riêng nên đặt trong `sellbird.local.yaml`, vì git không đụng tới file này khi bạn cập nhật. Repo cũng có tài liệu về Extensions để thêm route, bước trong vòng lặp hoặc lệnh từ một gói riêng.

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

### Cài xong nhưng báo sai phiên bản Python

Trên macOS, `python3` trần thường là bản 3.9, thấp hơn yêu cầu 3.11. Chạy `brew install python@3.13`, rồi tạo môi trường ảo bằng `python3.13` đúng như README, đừng dùng `python3`.

### Gõ `sellbird` báo không tìm thấy lệnh

Thường là môi trường ảo chưa được kích hoạt trong cửa sổ terminal hiện tại, hoặc bước `pip install -e .` chưa chạy xong. Mỗi lần mở terminal mới, hãy vào thư mục `sellbird` và kích hoạt lại `.venv`. README không có mục riêng cho lỗi này, nên nếu vẫn lỗi hãy xem tài liệu Troubleshooting trong `docs/`.

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

Sellbird dựa vào Claude Code CLI đã đăng nhập. Nếu bạn chưa đăng nhập, hãy chạy `claude login`. Nếu dùng ChatGPT thì làm theo hướng dẫn Codex trong `docs/`.

### `git pull` báo thay đổi cục bộ sẽ bị ghi đè (người dùng Harvey cũ)

Lỗi này xảy ra nếu bạn từng sửa trực tiếp file `harvey.yaml`. README hướng dẫn: chạy `git stash`, `git pull`, rồi `git stash pop`. Git sẽ chuyển các chỉnh sửa của bạn sang `sellbird.yaml`. Nếu có 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`. Về lâu dài, hãy để cài đặt trong `sellbird.local.yaml`.

### Thư vào spam hoặc tỉ lệ vào hộp thư chính thấp

Đây là rủi ro chung của cold email, không riêng Sellbird. Nguyên nhân thường gặp là hộp thư mới chưa warmup hoặc dùng luôn tên miền chính. Hãy dùng tên miền gửi thư riêng, warmup trước khi gửi, giữ giới hạn gửi mỗi ngày thấp, và đọc tài liệu Legal and deliverability trong repo.

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

**Điểm mạnh.** Bạn không phải trả tiền API mô hình riêng, chỉ dùng gói đang có. Chạy trên máy bạn, dữ liệu nằm trong thư mục của bạn. Mặc định nó chờ bạn duyệt, có bước kiểm tra trước khi gửi và lệnh dừng tức thì. Các bước tìm và đọc website có thể chạy miễn phí. Giấy phép AGPL-3.0, mã mở nên bạn đọc được nó làm gì.

**Giới hạn.** Cài đặt cần dùng terminal và Python 3.11 trở lên. README chưa có hướng dẫn riêng cho Windows. Nguồn tìm miễn phí là OpenStreetMap, nên độ phủ với doanh nghiệp tại Việt Nam chưa được tư liệu nói tới; mình khuyên bạn thử một đợt nhỏ trước. Cold email còn chịu các quy định pháp lý và yêu cầu về uy tín gửi thư. Bạn cần tự đọc kỹ phần Legal and deliverability và luật nơi người nhận sinh sống. Sellbird cũng dùng hạn mức gói của bạn, dù nó tự giảm tốc để chừa chỗ cho việc của bạn.

**Khi nào nên chọn cách khác.** Nếu bạn không muốn tự vận hành, dự án có bản hosted tại sellbird.ai (đang trong giai đoạn early access), đã lo sẵn tên miền gửi, hộp thư và warmup. Nếu bạn chỉ cần gửi vài thư cho khách quen, một công cụ email thông thường là đủ. Và nếu bạn mới bắt đầu, hãy chạy thử trên danh sách nhỏ, giữ chế độ duyệt tay, rồi mới tính chuyện tự động hoá.

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

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

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

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

Không. Sellbird chạy 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ó key và không tính tiền theo token. Một số nguồn tuỳ chọn như xác minh email hay tìm kiếm trả phí có biến API key riêng trong file .env.example, bạn chỉ điền khi dùng.

### Cần GPU không?

Tư liệu không nhắc tới yêu cầu GPU. Phần suy luận chạy qua Claude Code hoặc Codex với gói thuê bao của bạn, không chạy mô hình trên máy.

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

README viết lệnh cho macOS/Linux và nói Docker chạy trên Linux. Tài liệu có nhắc thư mục dữ liệu trên Windows là %APPDATA%\sellbird, nhưng chưa ghi các bước cài riêng cho Windows. Bạn nên xem thư mục docs/ trong repo trước khi thử.

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

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

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

Sellbird chạy trên máy bạn, cấu hình, kiến thức và dữ liệu nằm trong một thư mục riêng. Tư liệu chưa nói chi tiết về bảo mật ngoài việc có file SECURITY.md để báo lỗi bảo mật. Hãy giữ file .env riêng tư. Nội dung bạn xử lý vẫn đi qua Claude hoặc Codex mà bạn dùng.

### Tôi đang dùng Harvey, có phải cài lại không?

Không. Harvey được đổi tên thành Sellbird từ bản 0.4.0, cấu hình và dữ liệu được giữ lại. Bạn chạy git pull, pip install -e . một lần để có lệnh sellbird mới, rồi sellbird dashboard. Các biến HARVEY_* vẫn đọc được khi chưa đặt biến SELLBIRD_* tương ứng.
