# Sellbird: tự tìm khách, viết và gửi cold email bằng gói Claude/ChatGPT — 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 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 cold email cá nhân hoá, gửi đ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 quen dùng terminal, và README còn có cách để Claude Code hướng dẫn cài giúp.

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

Sellbird là một nền tảng outreach mã nguồn mở, chạy ngay trên máy của bạn. Nó lo cả chuỗi việc bán hàng chủ động: 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ý phản hồi. Trước đây dự án tên là Harvey, nay đã đổi tên thành Sellbird.

Ai nên quan tâm? Chủ doanh nghiệp nhỏ, người làm sales hoặc marketing, hay lập trình viên muốn có một "nhân viên prospecting" chạy tự động mà không phải trả tiền cho hàng loạt công cụ riêng lẻ. README nói rõ Sellbird không dùng Apollo, ZoomInfo, Clearbit hay Clay.

Điểm đáng giá nhất là hai thứ. Thứ nhất, phần "suy nghĩ" của Sellbird chạy 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. Bạn không cần API key của mô hình và không bị tính tiền theo token. Thứ hai, mặc định không có email nào được gửi đi nếu bạn chưa duyệt. Repo hiện 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.

```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, kiểm tra email, viết và gửi cold email, xử lý phản hồi bằng gói Claude hoặc ChatGPT.
- 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 từ đầu đến cuối, hoặc dừng ở bất kỳ bước nào.

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

Nó tìm các doanh nghiệp giống khách hà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í. Mỗi lần tìm trả phí đều hiện chi phí trước khi chạy, nên khó bị tính tiền bất ngờ.

### Đọc tín 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 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. Nhờ vậy email sau này có lý do cụ thể để viết, không phải thư gửi đại trà.

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

Nó tìm chủ hoặc quản lý được nêu 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 phải ngồi lục LinkedIn từng nơi.

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

Sellbird học mẫu email của công ty rồi kiểm tra một địa chỉ. Mỗi địa chỉ được gắn nhãn: verified (đã xác minh), risky (rủi ro), guess (đoán) hoặc invalid (không hợp lệ). Chỉ địa chỉ gửi được mới được dùng để gửi. Điều này bảo vệ danh tiếng tên miền gửi của bạn.

### 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. 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ý phản hồi

Sellbird đọc mọi phản hồi và soạn sẵn câu trả lời. Nó tách email trả lời tự động ra riêng, tôn trọng yêu cầu từ chối nhận mail ngay lập tức, và chuyển cho bạn những trường hợp không nên tự trả lời. Có một bảng điều khiển (dashboard) để bạn theo dõi.

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ệnh này xuất file CSV để nạp vào 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 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ì phải cài bản mới trước 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** (repo có tài liệu riêng cho cách này).
- **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 và có nói đây là link affiliate của người duy trì dự án. Sellbird đọc được tỉ lệ vào inbox từ TrulyInbox để báo khi nào bạn sẵn sàng gửi.

Các khoá bên thứ ba như Reoon, ZeroBounce, Hunter, DataForSEO hay Instantly chỉ là tuỳ chọn. Chúng nằm trong file `.env.example` dưới dạng biến cấu hình. Tư liệu không nói bạn bắt buộc phải có chúng để chạy bản mặc định miễn phí.

Về chi phí, README ghi: tìm doanh nghiệp là 0 đồng trên nguồn mặc định, hoặc khoảng 0,37 USD cho 1.000 doanh nghiệp trên nguồn trả phí rẻ nhất. Hộp thư Google Workspace khoảng 7 USD mỗi tháng.

Về hệ điều hành, README nêu rõ macOS và Linux (Docker chạy trên Linux). README cũng có chỗ nói đường dẫn thư mục dữ liệu trên Windows. Tuy vậy các lệnh cài trong README viết theo kiểu macOS/Linux, và tư liệu không ghi lệnh kích hoạt môi trường ảo riêng cho Windows.

```note
Sellbird gửi email thật từ hộp thư của bạn. Hãy dùng một tên miền gửi riêng, không dùng tên miền chính của công ty. Giữ nguyên chế độ duyệt tay trong Outbox cho đến khi bạn đã đọc kỹ các email đầu tiên. Đọc luôn tài liệu "Legal and deliverability" trong thư mục docs/ của repo để biết các quy định khi gửi cold email.
```

## 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 đặt | Tạo môi trường ảo Python 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
- 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 và chạy sellbird discover
- Mở bảng điều khiển | Chạy sellbird dashboard rồi sellbird run
```

Có hai đường. Đường dễ nhất cho người mới là nhờ Claude Code cài giúp. Đường thứ hai là tự gõ từng lệnh.

### Cách 1: để Claude Code hướng dẫn cài

Mở terminal (macOS: ứng dụng Terminal; Windows: PowerShell hoặc Git Bash), rồi chạy:

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

Ba lệnh này tải mã nguồn về, đi vào thư mục vừa tải, rồi mở Claude Code ngay trong thư mục đó. Bạn phải đứng trong thư mục `sellbird` thì Claude mới đọc được file hướng dẫn của repo. Khi Claude mở ra, gõ: **"set up Sellbird for me"**.

File `CLAUDE.md` trong repo biến Claude Code thành người hướng dẫn cài đặt. Theo README, nó kiểm tra bạn đang ở đâu, cài những gì 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. Nhớ là bạn phải đã đăng nhập `claude login` từ trước.

### Cách 2: tự cài bằng lệnh

Sau khi đã `git clone` và `cd sellbird` như trên, chạy bước cài đặt:

```bash
# 1. Cài đặt. Dùng python3.13, không dùng python3: trên macOS, python3 trần là bản 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 ảo tên `.venv`, kích hoạt nó, rồi cài Sellbird vào đó. Sau khi cài xong, bạn có lệnh `sellbird`. Chỗ hay vấp: nếu máy bạn có nhiều bản Python, hãy dùng đúng bản từ 3.11 trở lên. Dòng `source .venv/bin/activate` là cú pháp của macOS/Linux. README không ghi lệnh tương đương cho Windows, nên người dùng Windows hãy xem docs/ trong repo hoặc nhờ Claude Code (Cách 1).

```bash
# 2. Thêm thông tin đăng nhập. Mỗi biến đều có chú thích ngay trong file.
cp .env.example .env && $EDITOR .env
```

Lệnh này sao chép file mẫu thành `.env` rồi mở ra để bạn điền. Trong file có các nhóm biến như Gmail, SMTP/IMAP, Microsoft 365, các dịch vụ kiểm tra email và TrulyInbox. Hãy điền theo hộp thư bạn thật sự dùng. File `.env` chứa mật khẩu và khoá, tuyệt đối đừng đưa nó lên GitHub hay gửi cho ai.

```bash
# 3. Dạy Sellbird về sản phẩm từ website của bạn (ghi ra sellbird.local.yaml).
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`. Đây là file cấu hình riêng của bạn, git không đụng tới.

```bash
# 4. Xác nhận thế nào là một khách hàng tốt.
sellbird signals --confirm free
```

Bước này chọn các tín hiệu (signal) cho biết một công ty có khả năng cần sản phẩm của bạn. Theo tài liệu của repo có tất cả 29 tín hiệu. Mục `--confirm free` trong README là cách xác nhận kèm nguồn miễn phí.

```bash
# 5. Tìm doanh nghiệp. Nguồn mặc định miễn phí và không cần tài khoản.
sellbird discover
```

Sellbird bắt đầu tìm công ty phù hợp trên nguồn mặc định.

```bash
# 6. Mở bảng điều khiển và chạy vòng lặp.
sellbird dashboard          # in ra một link riêng tới http://127.0.0.1:5555
sellbird run
```

`sellbird dashboard` in ra một đường link riêng trỏ tới địa chỉ trên máy bạn (`127.0.0.1:5555`). Mở link đó trong trình duyệt để xem Outbox và các màn hình khác. `sellbird run` khởi động vòng lặp chính. Hai lệnh nên chạy ở hai cửa sổ terminal khác nhau, vì cả hai đều giữ terminal bận.

Trên Linux bạn cũng có thể chạy bằng Docker. Repo có `Dockerfile` và `docker-compose.yml`, và README có tài liệu Docker riêng trong docs/. Phần này README chính chỉ nhắc ngắn, nên hãy đọc tài liệu đó trước khi làm.

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

Cách dễ nhất là xem kết quả của `sellbird run`. README cho thấy một lần chạy thành công in ra thông báo kiểu "Sellbird is online", rồi "Checking pipeline state...". Sau đó nó nêu quyết định của vòng này (ví dụ viết chiến dịch cho các prospect mới chưa có bản nháp). Cuối cùng là các dòng cho biết bộ xử lý phản hồi, bộ viết email và Outbox đang làm gì, rồi "Cycle complete. Sleeping for 15 minutes."

Nếu bạn thấy nhịp chạy như vậy và Outbox có email đang chờ duyệt, tức là mọi thứ đã nối với nhau. Bạn cũng nên kiểm tra:

- `sellbird dashboard` in ra được link và mở được trong trình duyệt.
- Sau `sellbird discover`, danh sách công ty xuất hiện trong dashboard.
- Email đầu tiên nằm chờ trong Outbox chứ không tự gửi đi. Đây là hành vi đúng.

Dữ liệu mẫu trong repo là dữ liệu bịa: công ty "Bookwell" bán dịch vụ đặt lịch online cho thợ lợp mái, phòng nha và tiệm điều hoà, trên các tên miền `.test`.

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

Phần này bám theo những gì README mô tả. Tình huống là ví dụ minh hoạ của mình, kết quả thực tế sẽ tuỳ sản phẩm và danh sách khách của bạn.

### Chủ doanh nghiệp nhỏ muốn có danh sách khách tiềm năng

Bạn bán phần mềm đặt lịch cho 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" bằng `sellbird signals --confirm free`, rồi chạy `sellbird discover`. Sellbird tìm các phòng khám trên nguồn miễn phí, đọc website của họ để xem có đặt lịch hay chưa và tìm tên chủ phòng khám.

Bạn chưa muốn gửi gì cả, nên dừng sau bước kiểm tra email và chạy:

```bash
sellbird export
```

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

### Nhân viên sales muốn cold email cá nhân hoá mà vẫn kiểm soát

Bạn đã có hộp thư Google Workspace trên tên miền gửi riêng và đã warmup. Bạn điền thông tin vào `.env`, chạy `sellbird run` và để nó lặp mỗi 15 phút. Mỗi chu kỳ, Sellbird viết chuỗi email cho các prospect mới và đưa vào Outbox. Bạn mở dashboard, đọc từng email, sửa nếu cần và duyệt.

Người làm việc văn phòng sẽ thấy tiện ở chỗ: máy tự làm phần nặng nhọc là tìm và viết, bạn chỉ còn việc đọc và bấm duyệt.

> Sellbird làm hết phần việc nhọc, còn việc bấm gửi vẫn nằm trong tay bạn.
>
> — Ông T

### Xử lý phản hồi mà không sót khách

Sau khi gửi một thời gian, hộp thư bắt đầu có người trả lời. Sellbird đọc từng phản hồi, soạn sẵn câu trả lời cho người quan tâm hoặc người phản đối, và đặt riêng các thư trả lời tự động. Ai xin ngừng nhận mail sẽ được tôn trọng ngay. Phản hồi nào Sellbird không nên tự xử lý thì được chuyển cho bạn. Ví dụ trong README, email đáp lại một chủ phòng khám quan tâm đã có bản nháp sẵn. Bạn chỉ cần mở dashboard để xem và quyết định.

### Lập trình viên muốn tuỳ biến cho đội của mình

Sellbird để các playbook bán hàng và prompt trong thư mục `skills/` và `prompts/`, bạn sửa được tuỳ ý. Dự án còn có cơ chế Extensions để thêm route, bước trong vòng lặp hoặc lệnh mới từ một gói riêng. Nếu bạn đã thạo Python, đây là chỗ để chỉnh giọng văn, quy tắc kiểm tra và cách phân loại phản hồi theo ngành của mình. Nên chạy bộ test trong thư mục `tests/` trước khi sửa lớn. README chưa ghi lệnh chạy test cụ thể ở phần chính, nên hãy xem CONTRIBUTING.md.

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

### `python3 --version` báo 3.9 hoặc lệnh pip cài báo lỗi phiên bản

Đây chính là lỗi README cảnh báo trên macOS. Cài bản mới bằng `brew install python@3.13`, rồi tạo môi trường ảo bằng `python3.13` chứ không dùng `python3`. Sau đó cài lại bằng `pip install -e .`.

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

Thường là do bạn chưa kích hoạt môi trường ảo trong cửa sổ terminal hiện tại, hoặc bước `pip install -e .` chưa chạy xong. Mở terminal mới trong thư mục `sellbird`, kích hoạt lại môi trường ảo rồi thử lại. Với người dùng Windows, hãy xem tài liệu Troubleshooting trong docs/ nếu vẫn lỗi.

### Claude Code không phản hồi hoặc báo chưa đăng nhập

Sellbird dựa vào Claude Code CLI trên gói Pro hoặc Max của bạn. Chạy `claude login` và đăng nhập trước khi `sellbird run`. Nếu bạn dùng ChatGPT, hãy làm theo tài liệu "Using a ChatGPT plan (Codex)" của repo thay vì cố dùng Claude.

### Email nằm mãi trong Outbox, không thấy gửi đi

Đây là thiết kế chứ không phải lỗi. Mặc định mọi email chờ bạn duyệt cho đến khi bạn tự bật chế độ autopilot. Ngoài ra, bộ kiểm tra trước khi gửi (không dùng mô hình) sẽ chặn email còn sót thẻ merge chưa điền, có cụm từ bị cấm, quá dài, có link thừa hoặc gửi tới địa chỉ không gửi được. Hãy sửa email theo lý do bị chặn rồi duyệt lại. Cần dừng tất cả ngay thì dùng `sellbird sending pause`.

### `git pull` báo "your local changes would be overwritten" (khi nâng cấp từ Harvey)

Nếu bạn từng sửa trực tiếp file `harvey.yaml` thì sẽ gặp lỗi này. README hướng dẫn chạy lần lượt `git stash`, `git pull`, rồi `git stash pop`. Nếu có xung đột trong `sellbird.yaml`, 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`, vì git không đụng tới file này.

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

**Điểm mạnh.** Chạy trên máy của bạn, dữ liệu nằm trong thư mục home của dự án. Không tốn tiền API mô hình, vì dùng gói Claude hoặc ChatGPT bạn đã có. Nguồn tìm công ty miễn phí dùng được ngay. Mặc định mọi email phải qua bạn duyệt, có bộ kiểm tra trước khi gửi và lệnh dừng khẩn cấp. Mã nguồn mở, và bạn sửa được các prompt và playbook.

**Giới hạn.** Cài đặt vẫn cần quen terminal, nhất là khi tự làm từng lệnh. Bạn phải tự lo hộp thư gửi, tên miền gửi riêng và warmup, vì không có thứ này thì cold email dễ vào spam. README chưa ghi rõ cách làm trên Windows ở phần chính. Giấy phép là AGPL-3.0, bạn cần đọc kỹ nếu định dùng nó trong sản phẩm thương mại hoặc cung cấp thành dịch vụ cho người khác. Gửi cold email còn chịu các quy định pháp lý ở từng nước, và README có tài liệu riêng về chuyện này. Hãy đọc nó trước khi gửi mail thật.

**Khi nào nên chọn cách khác.** Nếu bạn không muốn tự vận hành, README nhắc tới bản hosted tại sellbird.ai (đang ở 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 khách mỗi tháng, một bảng tính và việc viết tay có thể đủ. Còn nếu bạn cần tìm khách ở quy mô rất lớn trên nhiều quốc gia, hãy tự thử bản miễn phí trước để xem danh sách có đủ dày cho ngành và thị trường của bạn hay không, vì tư liệu chưa nói rõ độ phủ ở Việt Nam.

Lời khuyên của mình: cài thử, chạy tới `sellbird export` hoặc chỉ xem Outbox trước. Khi các email nháp đọc ổn và hộp thư đã warmup, hãy gửi một lượng nhỏ rồi mới tăng dần.

## 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. Bạn cần có gói Claude Pro/Max hoặc gói ChatGPT có Codex, cùng một hộp thư để gửi (README nêu 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 doanh nghiệp.

### 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 Pro/Max của bạn, 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ụ tuỳ chọn khác như kiểm tra email thì có biến khoá riêng trong file .env.example.

### Cần GPU hay máy mạnh không?

Tư liệu không nhắc tới yêu cầu GPU hay cấu hình phần cứng. Phần suy nghĩ chạy qua Claude hoặc ChatGPT của bạn, không chạy mô hình cục bộ. Yêu cầu chính được ghi là Python 3.11 trở lên.

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

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

### Sellbird có tự gửi email lung tung 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. Bộ kiểm tra trước khi gửi chặn email lỗi hoặc gửi tới địa chỉ không gửi được, và lệnh sellbird sending pause dừng mọi thứ ngay.

### Dữ liệu của tôi nằm ở đâu, 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 home, còn database và log nằm ở thư mục data/. README không nói gì thêm về mã hoá hay chính sách bảo mật nâng cao, nên bạn hãy tự giữ kỹ file .env và xem SECURITY.md trong repo.

### Tôi đang dùng Harvey thì sao?

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