# 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 là Harvey) là nền tảng outreach mã nguồn mở viết bằng Python, chạy trên máy bạn. 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 và gửi cold email, rồi xử lý thư trả lời. Cài cần Python 3.11 trở lên và một gói Claude Pro/Max hoặc ChatGPT có Codex; mặc định không có 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-05-30 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/sellbird-tu-dong-tim-khach-cold-email-chay-bang-goi-claude-chatgpt

Sellbird là một nền tảng mã nguồn mở giúp bạn làm cả vòng bán hàng qua email lạnh (cold 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 thư riêng cho từng người, gửi đi và xử lý thư trả lời. Tên cũ của dự án là Harvey. Nó chạy ngay trên máy của bạn, viết bằng Python.

Điểm làm mình thấy đáng giá nhất: Sellbird không đòi API key của mô hình AI. Nó dùng Claude Code CLI trên gói Claude Pro hoặc Max của bạn, hoặc Codex trên gói ChatGPT. Tức là bạn không bị tính tiền theo từng token. Thêm nữa, mặc định không có email nào rời đi khi bạn chưa bấm duyệt.

Repo này hợp với chủ doanh nghiệp nhỏ, người làm sales, người làm agency, hoặc lập trình viên muốn tự dựng quy trình tìm khách thay vì trả tiền cho nhiều công cụ prospecting. Hiện repo có khoảng 5250 sao và 1127 fork, giấy phép AGPL-3.0. 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ở tìm công ty và người ra quyết định, kiểm tra email, viết cold email cá nhân hoá, gửi đi và xử lý thư trả lời, chạy trên 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 đường ống (pipeline). Bạn chạy trọn 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 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 muốn nguồn trả phí, bạn tự chọn, 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ờ.

### Đọc website để biết vì sao họ có thể 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 gì. Mỗi công ty chỉ cần ba request HTTP. Những tín hiệu này sau đó giúp email nghe có lý do chứ không chung chung.

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

Nó 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. Cách này giữ danh sách gọn và bám vào thông tin công khai.

### Kiểm tra email

Sellbird học mẫu địa chỉ 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 được gửi thư. Việc này giảm thư bật lại, thứ làm hỏng uy tín tên miền gửi.

### 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 số thư 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. Nó tách thư tự động ra riêng, 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.

Nếu bạn chỉ cần danh sách khách tiềm năng, hãy dừng sau bước kiểm tra email rồi chạy `sellbird export` để lấy file CSV dùng được cho 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 Python >=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** và đã đăng nhập Claude CLI bằng `claude login`. Hoặc **gói ChatGPT có Codex CLI** (README có hướng dẫn riêng cho Codex).
- **Một hộp thư để gửi.** Khuyến nghị là 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) cho hộp thư đó.** README đề xuất TrulyInbox, và Sellbird đọc tỷ lệ vào inbox từ đó để 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ì có thể nhận hoa hồng.

Về chi phí, README nêu: tìm doanh nghiệp là 0 đồng với nguồn mặc định, hoặc khoảng 0,37 USD cho 1.000 kết quả với nguồn trả phí rẻ nhất. Đọc website là 0 đồng. Khoản đáng kể là gói thuê bao AI và hộp thư, ví dụ Google Workspace khoảng 7 USD mỗi tháng.

File `.env.example` có sẵn các biến cho Gmail, SMTP/IMAP, Microsoft 365, các dịch vụ kiểm tra email (Reoon, ZeroBounce, Hunter) và nhiều dịch vụ khác. Bạn không phải điền hết, chỉ điền phần mình dùng. Mỗi biến có chú thích ngay trong file.

Ngoài ra README chỉ nói rõ lệnh cho macOS/Linux. Trên Linux có thể chạy bằng Docker. Với Windows, README chưa có mục cài đặt riêng, chỉ có chỉ ra thư mục dữ liệu `%APPDATA%\sellbird`. Bạn nên xem thư mục docs/ trong repo (có mục Troubleshooting và Docker) trước khi làm trên Windows.

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

```steps
- Lấy mã nguồn | Clone repo về máy rồi cd vào thư mục
- Tạo môi trường và cài | Tạo .venv bằng Python 3.13 và pip install -e .
- Điền thông tin | Copy .env.example thành .env rồi điền key cần dùng
- Dạy Sellbird về sản phẩm | sellbird train với website của bạn, rồi xác nhận tín hiệu
- Tìm khách và chạy | sellbird discover, mở dashboard rồi sellbird run
```

Có 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 nhanh: để Claude hướng dẫn

Mở terminal ở nơi bạn muốn đặt thư mục dự án, rồi chạy:

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

Lệnh `git clone` tải mã nguồn về, `cd sellbird` đi vào thư mục vừa tải, và `claude` mở Claude Code ngay trong thư mục đó. Khi Claude Code mở, bạn gõ **set up Sellbird for me**. File `CLAUDE.md` của repo biến Claude Code thành người hướng dẫn: nó kiểm tra bạn đang ở đâu, cài phần còn thiếu, hỏi những gì cần và huấn luyện Sellbird về sản phẩm của bạn.

Chỗ hay vấp: lệnh `claude` chỉ chạy được nếu bạn đã cài Claude Code CLI và đăng nhập bằng `claude login`.

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

Đã ở trong thư mục `sellbird`, chạy lệnh sau (chép từ 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 bước này bạn có lệnh `sellbird`. Hãy dùng đúng `python3.13` như README dặn, đừng dùng `python3` trần vì trên macOS đó là bản 3.9 quá cũ.

Lệnh `source .venv/bin/activate` dành cho macOS/Linux. Trên Windows PowerShell, cách kích hoạt venv chuẩn của Python là `.venv\Scripts\Activate.ps1`. Đây là cách phổ thông của Python chứ README Sellbird không ghi.

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

```bash
# 2. Add credentials. Every variable is documented inline.
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. 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. Điền thông tin hộp thư gửi (ví dụ Gmail hoặc SMTP) và các key dịch vụ bạn định dùng. Bước tìm khách mặc định không cần tài khoản nào.

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

Thay `https://your-company.com` bằng website thật của bạn. Sellbird đọc trang đó để hiểu bạn bán gì, và ghi kết quả vào `sellbird.local.yaml`. Lệnh `sellbird signals --confirm free` giúp bạn xác nhận những dấu hiệu nào cho thấy một công ty là khách tiềm năng tốt.

### Tìm khách, mở dashboard và chạy vòng lặp

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

`sellbird discover` tìm doanh nghiệp từ nguồn miễn phí. `sellbird dashboard` in ra một đường link riêng tới địa chỉ `http://127.0.0.1:5555`, tức là bảng điều khiển chỉ chạy trên máy bạn. `sellbird run` bật vòng lặp chính. Hãy để một cửa sổ terminal chạy `run`, và mở dashboard bằng link riêng ở cửa sổ khác.

```note
Sellbird gửi email thật từ hộp thư của bạn. Hãy dùng tên miền gửi riêng, warmup hộp thư trước khi gửi, và đọc mục Legal and deliverability trong docs/ để biết quy định gửi thư ở nơi bạn và nơi người nhận. Đừng bật autopilot khi chưa kiểm tra kỹ vài email mẫu trong Outbox.
```

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

Bước đầu tiên là chạy `sellbird run`. README cho thấy màn hình mong đợi trông như sau:

```
$ sellbird run

============================================================
Sellbird is online.
============================================================
Checking pipeline state...
Decision: write_campaign (3 new prospects with no drafts)
  handler   → Elena Park, Harbor Dental Studio     interested, answer drafted
  handler   → Priya Nair, Highline Roofing         objection, answer drafted
  writer    → 2-email sequence: Phoenix HVAC hiring a dispatcher
  outbox    → 5 emails waiting for your approval
Cycle complete. Sleeping for 15 minutes.
```

Đó là dữ liệu mẫu của README, nên số liệu và tên của bạn sẽ khác. Dấu hiệu tốt là bạn thấy dòng **Sellbird is online**, một dòng **Decision**, và cuối cùng là **Cycle complete** cùng thông báo nghỉ 15 phút.

Thứ hai, chạy `sellbird dashboard` và mở link riêng nó in ra. Nếu trang mở được trên máy bạn, phần giao diện đã sẵn sàng. Thứ ba, vào mục Outbox trên dashboard: nếu các email chờ duyệt xuất hiện ở đó thì quy trình viết thư đang chạy. Mặc định chưa có thư nào được gửi khi bạn chưa duyệt.

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

Các tình huống dưới đây bám đúng những gì README mô tả. Các ví dụ về người và ngành là mình tưởng tượng để dễ hình dung.

### Chủ một phần mềm đặt lịch nhỏ tìm khách địa phương

Bạn bán phần mềm đặt lịch online cho doanh nghiệp dịch vụ. README dùng đúng ví dụ này, với công ty giả Bookwell bán cho thợ lợp mái, phòng khám nha và tiệm HVAC. Bạn chạy:

```bash
sellbird train https://website-cua-ban.com
sellbird signals --confirm free
sellbird discover
```

Sellbird học sản phẩm của bạn, bạn xác nhận tín hiệu như 'chưa có đặt lịch online'. Sau đó nó tìm doanh nghiệp từ OpenStreetMap, đọc website từng nơi để tìm tín hiệu đó. Kết quả là một danh sách khách có lý do cụ thể để liên hệ, chứ không phải danh sách mù.

> Nó làm hết từ tìm khách đến trả lời thư, nhưng không có email nào đi nếu bạn chưa gật đầu.
>
> — Ông T

### Người làm sales chỉ cần danh sách sạch

Bạn đã có công cụ gửi thư riêng (sequencer) và chỉ cần danh sách khách đã kiểm tra email. Bạn chạy các bước tìm, bổ sung và kiểm tra, rồi dừng lại và chạy:

```bash
sellbird export
```

Lệnh này xuất file CSV dùng được ngay cho sequencer, gồm mọi thứ Sellbird tìm được. Mỗi địa chỉ có nhãn verified, risky, guess hoặc invalid, nên bạn lọc bỏ địa chỉ rủi ro trước khi nạp vào công cụ khác. Cách này giúp bạn dùng Sellbird như máy tìm khách mà không cần cho nó gửi thư.

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

Bạn để `sellbird run` chạy nền. Sáng ra, bạn mở dashboard và vào Outbox, nơi các email chờ duyệt. Bạn đọc từng bản nháp, sửa nếu cần, rồi duyệt. Trước khi gửi, bước kiểm tra tự động (không dùng mô hình AI) sẽ chặn thư còn sót merge tag 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.

Kết quả: bạn vẫn kiểm soát nội dung nhưng không phải tự viết từng thư. Nếu cần dừng gấp, một lệnh dừng tất cả:

```bash
sellbird sending pause
```

### Xử lý thư trả lời mà không bỏ sót

Khi khách trả lời, Sellbird đọc từng thư, phân loại (như interested hay objection trong ví dụ README) và soạn sẵn câu đáp. Thư tự động trả lời được tách riêng, yêu cầu từ chối nhận thư được thực hiện ngay, và những thư nó không nên tự trả lời sẽ được chuyển cho bạn. Bạn mở dashboard, xem câu đáp nháp, chỉnh rồi gửi. Người làm một mình sẽ đỡ bị sót khách đang quan tâm giữa đống thư.

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

### Lệnh `sellbird` không được nhận

Thường là do bạn chưa kích hoạt môi trường `.venv` trong cửa sổ terminal đang mở, hoặc bước `pip install -e .` chưa chạy xong. Hãy kích hoạt lại `.venv` rồi chạy lại `pip install -e .` trong thư mục `sellbird`. Mỗi lần mở terminal mới bạn đều phải kích hoạt lại.

### Python quá cũ

Sellbird cần Python 3.11 trở lên. Nếu `python3 --version` báo 3.9 (rất hay gặp trên macOS), hãy cài bản mới như README gợi ý (`brew install python@3.13`) rồi tạo lại `.venv` bằng `python3.13`. Nếu từng tạo `.venv` bằng bản cũ, hãy xoá thư mục `.venv` và tạo lại.

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

Sellbird nghĩ qua Claude Code CLI hoặc Codex trên gói thuê bao của bạn. Nếu chưa đăng nhập, vòng lặp sẽ không viết được thư. Hãy chạy `claude login` (với Claude) rồi chạy lại `sellbird run`. Với ChatGPT, xem mục Using a ChatGPT plan (Codex) trong docs/.

### Nâng cấp từ Harvey bị chặn khi git pull

Nếu bạn từng sửa trực tiếp file `harvey.yaml`, `git pull` sẽ dừng với báo lỗi 'your local changes would be overwritten'. README hướng dẫn chạy `git stash`, `git pull`, rồi `git stash pop`. Nếu có xung đột thì giữ các dòng của bạn, xoá dấu xung đột và chạy `git stash drop`. Về lâu dài, hãy để cài đặt riêng trong `sellbird.local.yaml` vì git không đụng tới file này.

### Thư bật lại hoặc vào spam

Đây là rủi ro chung của cold email, không riêng gì công cụ này. Hãy gửi từ tên miền riêng, warmup hộp thư trước, đừng nâng số thư mỗi ngày quá nhanh và chỉ gửi tới địa chỉ có nhãn verified. Xem thêm mục Legal and deliverability trong docs/. Khi nghi ngờ, chạy `sellbird sending pause` để dừng lại và kiểm tra.

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

**Điểm mạnh.** Không cần API key mô hình, không tính tiền theo token, vì dùng gói Claude hoặc ChatGPT bạn đã có. Dữ liệu và cấu hình nằm trên máy bạn. Mặc định phải duyệt tay trước khi gửi, có bước kiểm tra tự động chặn lỗi hay gặp, có lệnh dừng khẩn cấp. Bạn chỉ dùng được phần nào cần: chỉ lấy danh sách, hoặc chạy trọn bộ. Giấy phép AGPL-3.0 và mã nguồn mở nên bạn đọc được nó làm gì.

**Giới hạn.** Bạn phải tự lo hộp thư gửi, tên miền riêng và warmup. Cài đặt đòi bạn quen terminal. README mới có lệnh rõ cho macOS/Linux, còn Windows thì bạn nên đọc docs/ kỹ hơn. Nguồn tìm khách miễn phí là OpenStreetMap, nên phù hợp nhất với doanh nghiệp địa phương có trên bản đồ. Nếu khách của bạn là các công ty công nghệ, bạn có thể cần nguồn trả phí. Gói thuê bao cũng có hạn mức, và Sellbird tự giảm tốc để chừa chỗ cho việc của bạn. Mình chưa có thông tin về hiệu quả (tỷ lệ phản hồi) ngoài những gì README nói.

**Lưu ý pháp lý.** Cold email chịu quy định riêng theo từng nước. Bạn phải tự chịu trách nhiệm về việc gửi thư, kể cả quy định chống thư rác nơi người nhận sống.

**Khi nào chọn cách khác.** Nếu bạn không muốn tự vận hành, dự án có bản trả phí tại sellbird.ai (README nói đang ở giai đoạn early access, đã lo sẵn tên miền gửi, hộp thư và warmup). Nếu bạn chỉ gửi vài thư thủ công mỗi tuần, tự viết sẽ nhanh hơn cài cả hệ thống này. Nếu bạn muốn một công cụ bấm là chạy, không đụng terminal, thì Sellbird chưa phải lựa chọn nhẹ nhàng.

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

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

Bản mã nguồn mở là miễn phí, dùng giấy phép AGPL-3.0. Nguồn tìm doanh nghiệp mặc định (OpenStreetMap) miễn phí, nguồn trả phí rẻ nhất khoảng 0,37 USD cho 1.000 kết quả theo README. 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 USD mỗi tháng.

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

Không. Theo README, Sellbird dùng Claude Code CLI trên gói Claude Pro hoặc Max, 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ụ phụ như kiểm tra email (Reoon, ZeroBounce, Hunter) có biến key riêng trong .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 nghĩ được làm qua Claude hoặc Codex trên gói thuê bao của bạn, nên theo README không có mô hình nào chạy cục bộ.

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

README chưa có hướng dẫn cài đặt riêng cho Windows. Nó chỉ nhắc thư mục dữ liệu trên Windows là %APPDATA%\sellbird, và các lệnh trong README viết cho macOS/Linux. Bạn nên xem thư mục docs/ (mục Docker và Troubleshooting) trước khi thử.

### Sellbird có tự gửi email lung tung không?

Không theo mặc định. Mọi email gửi đi nằm trong Outbox chờ bạn duyệt cho tới khi bạn tự bật autopilot. Trước khi gửi còn có bước kiểm tra không dùng mô hình AI, chặn merge tag chưa điền, cụm từ bị cấm, thư quá dài, thừa link và địa chỉ không gửi được. Lệnh sellbird sending pause dừng mọi thứ ngay.

### 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òn cấu hình, kiến thức và dữ liệu nằm trong một thư mục home riêng. Dashboard chạy ở địa chỉ 127.0.0.1 với link riêng. Tuy nhiên, nội dung bạn đưa cho Claude hoặc ChatGPT vẫn đi qua các dịch vụ đó. Tư liệu chưa nói chi tiết hơn về chính sách dữ liệu của họ.

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

README nói Sellbird không cần các công cụ prospecting như Apollo, ZoomInfo, Clearbit hay Clay. Nó tự tìm công ty, tìm người ra quyết định từ chính các trang của công ty và kiểm tra email. Tư liệu chưa có so sánh chi tiết về độ phủ dữ liệu giữa các công cụ.
