# 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. Nó tìm công ty phù hợp, tìm người ra quyết định, kiểm tra email, viết và gửi cold email rồi xử lý thư trả lời, dùng gói Claude hoặc ChatGPT bạn đang có thay vì API key. Cài bằng Python 3.11 trở lên, khá dễ nếu bạn quen terminal; mặc định mọi email đều chờ bạn duyệt mới gửi.

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

Sellbird là một nền tảng mã nguồn mở chạy trên máy của bạn, giúp làm trọn quy trình gửi 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. Trước đây dự án tên là Harvey, nay đổi tên thành Sellbird, vẫn là cùng một dự án và cùng lịch sử.

Repo này hợp với chủ shop, người làm kinh doanh, nhân viên sales nhỏ lẻ hoặc lập trình viên muốn tự động hoá việc tìm khách B2B mà không phải trả thêm tiền cho các công cụ prospecting như Apollo, ZoomInfo, Clearbit hay Clay. Theo README, Sellbird không dùng các công cụ đó.

Điểm đáng giá nhất có hai ý. Một: nó chạy bằng gói Claude Pro/Max (qua Claude Code CLI) hoặc gói ChatGPT (qua Codex), nên không có API key mô hình và không bị tính tiền theo token. 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, giấy phép AGPL-3.0. Bạn có thể xem video ngắn bên dưới để thấy nó chạy ra sao.

```repo
- repo | ethanplusai/sellbird
- kind | Ứng dụng
- desc | Sellbird là nền tảng mã nguồn mở tự tìm công ty và người 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.
- 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 hết từ đầu đến cuối, hoặc dừng ở bất kỳ bước nào.

- **Tìm công ty.** Nó tìm các doanh nghiệp khớp với khách hàng lý tưở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 có trả phí đều hiện chi phí trước khi chạy. Lợi ích: bạn không bị bất ngờ về tiền.
- **Tìm lý do họ sẽ mua.** Nó đọ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ì. Lợi ích: thư của bạn có lý do cụ thể để liên hệ, không phải thư chung chung.
- **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 mỗi công ty.
- **Kiểm tra địa chỉ email.** Nó học cách đặt email của công ty và xác minh một địa chỉ. Mỗi địa chỉ được gắn nhãn verified, risky, guess hoặc invalid, và chỉ địa chỉ gửi được mới được gửi thư. Lợi ích: giảm thư bị trả về, bảo vệ uy tín hộp thư gửi.
- **Viết và gửi.** Nó viết một chuỗi thư 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, trong giới hạn gửi mỗi ngày và giờ làm việc của người nhận.
- **Xử lý thư trả lời.** Nó đọc mọi thư trả lời, soạn sẵn câu trả lời, 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.

Nếu bạn chỉ cần danh sách, hãy dừng sau bước kiểm tra email và chạy `sellbird export` để có file CSV sẵn cho công cụ gửi thư khác.

Về chi phí, README nêu: 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 kết quả trên nguồn trả phí rẻ nhất. Đọc website là 0 đồng (ba request HTTP mỗi công ty, không gọi mô hình). Phần viết và gửi dùng gói đăng ký của bạn và một hộp thư (README nói Google Workspace khoảng 7 USD một tháng).

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

Theo README và file cấu hình của repo, bạn cần:

- **Python 3.11 trở lên.** 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.
- **Một trong hai gói AI:** Claude Pro hoặc Max với Claude Code CLI đã đăng nhập 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 dùng được.
- **Warmup (làm nóng) hộp thư đó.** README giới thiệu TrulyInbox cho việc này. Lưu ý: các liên kết TrulyInbox trong dự án là liên kết affiliate, người duy trì có thể nhận hoa hồng. Đây không phải điều bắt buộc, nhưng README nhấn mạnh cần có warmup.

File `.env.example` liệt kê các biến cấu hình tuỳ chọn. Bạn chỉ điền cái nào mình dùng: thông tin Gmail (`GMAIL_CLIENT_ID`, `GMAIL_CLIENT_SECRET`), SMTP/IMAP, Microsoft 365, và các dịch vụ kiểm tra email như Reoon, ZeroBounce, Hunter. README nói mỗi biến đều có chú thích ngay trong file.

Về hệ điều hành: README nhắc tới macOS, Linux và Windows (khi nói về thư mục dữ liệu), và nói thêm trên Linux có thể chạy bằng Docker. README chưa ghi lệnh kích hoạt môi trường ảo riêng cho Windows, bạn cần tự xem cách của Python.

```note
Bạn sẽ điền mật khẩu hộp thư, key dịch vụ vào file .env. Đừng đưa file này lên GitHub hay gửi cho người khác. Nên dùng tên miền và hộp thư gửi riêng, không dùng hộp thư chính của công ty.
```

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

Có hai cách: để Claude Code dẫn bạn cài, hoặc tự gõ lệnh. Với người mới, cách đầu thường dễ hơn.

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

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

Mở terminal (PowerShell hoặc Terminal), đi tới thư mục bạn muốn đặt dự án rồi chạy:

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

Lệnh đầu tải mã nguồn 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 quên.

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

Trong thư mục `sellbird`, chạy:

```bash
claude
```

Rồi nhắn: **“set up Sellbird for me”**. Theo README, file `CLAUDE.md` của repo biến Claude Code thành người hướng dẫn cài: nó kiểm tra bạn đang ở đâu, cài những gì còn thiếu, hỏi thông tin cần thiết và huấn luyện Sellbird về sản phẩm của bạn. Nếu cách này ổn thì bạn có thể bỏ qua các bước tự làm bên dưới.

### Cách tự làm: cài gói

```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ôi trường ảo `.venv`, kích hoạt nó, rồi cài Sellbird vào đó. Dòng `source .venv/bin/activate` dùng cho macOS/Linux. README chưa ghi lệnh tương đương cho Windows. Nếu bạn dùng Windows, hãy xem tài liệu Python về môi trường ảo, hoặc dùng cách để Claude Code cài giúp ở trên.

### Đ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 sao chép file mẫu thành `.env` rồi mở ra để sửa. Điền thông tin hộp thư gửi và các key dịch vụ bạn định dùng. Biến nào không dùng thì cứ để nguyên.

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

Thay địa chỉ bằng website công ty bạn. Sellbird đọc site để hiểu bạn bán gì, rồi ghi kết quả vào `sellbird.local.yaml`. File này git không đụng tới, nên bạn có thể chỉnh sửa thoải mái.

### Chọn tín hiệu và tìm khách

```bash
# 4. Confirm what makes a good prospect.
sellbird signals --confirm free

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

Lệnh đầu xác nhận những dấu hiệu cho thấy một công ty là khách tiềm năng tốt. Lệnh thứ hai tìm doanh nghiệp bằng 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
# 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 dẫn riêng tới địa chỉ `http://127.0.0.1:5555` trên máy bạn. Mở link đó bằng trình duyệt. Sau đó `sellbird run` khởi động vòng lặp làm việc.

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

Khi chạy `sellbird run`, README cho thấy kết quả mẫu 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.
```

Bạn sẽ thấy dòng “Sellbird is online”, rồi các bước xử lý, và cuối cùng là các email đang chờ duyệt trong Outbox. Dữ liệu trong ví dụ là dữ liệu giả của README. Của bạn sẽ khác.

Một dấu hiệu nữa là mở được bảng điều khiển ở `http://127.0.0.1:5555` bằng link riêng mà lệnh `sellbird dashboard` in ra. Nếu thấy hàng đợi email trong Outbox thì bạn đã cài thành công. README cũng nói Sellbird đọc tỷ lệ inbox từ TrulyInbox để cho bạn biết khi nào hộp thư đã sẵn sàng gửi, nhưng chỉ khi bạn dùng dịch vụ đó.

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

Phần nào cũng nên bắt đầu bằng việc duyệt tay trong Outbox. Dưới đây là vài tình huống bám đúng khả năng README mô tả.

### Chủ công ty dịch vụ nhỏ tìm khách địa phươ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, 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 phòng khám trên 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 thư ngắn nhắc đúng điều nó thấy trên site họ. Kết quả: một hàng đợi thư cá nhân hoá đang chờ bạn duyệt, thay vì danh sách chung chung.

> Không có email nào ra khỏi máy bạn nếu bạn chưa bấm duyệt.
>
> — Ông T

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

Bạn đã có công cụ gửi thư riêng và chỉ cần một danh sách khách tiềm năng đã được kiểm tra. Bạn chạy từ `sellbird discover` đến bước kiểm tra email, rồi dừng và chạy:

```bash
sellbird export
```

Kết quả là file CSV sẵn để đưa vào công cụ gửi thư của bạn. Mỗi địa chỉ đã có nhãn verified, risky, guess hoặc invalid, nên bạn lọc được địa chỉ đáng gửi.

### Người làm một mình, cần trả lời thư nhanh

Sau khi gửi, khách trả lời “quan tâm” hoặc “giá hơi cao”. Sellbird đọc từng thư, soạn sẵn câu trả lời, bỏ riêng thư tự động trả lời, và xử lý ngay yêu cầu từ chối nhận thư. Những thư nó không nên tự trả lời sẽ được chuyển cho bạn trên bảng điều khiển. Kết quả: bạn chỉ phải đọc và duyệt thay vì viết từ đầu.

### Lập trình viên muốn tuỳ biến cách viết thư

Theo README, thư mục `prompts/` và `skills/` là các kịch bản bán hàng có thể chỉnh sửa. Bạn sửa chúng để đổi giọng văn hoặc cách tiếp cận. Chi tiết nằm ở tài liệu Skills and sub-agents trong thư mục `docs/` của repo.

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

- **`python3 --version` báo 3.9 (thường trên macOS).** README nói rõ cần Python 3.11 trở lên. Cài bản mới bằng `brew install python@3.13` rồi dùng `python3.13` khi tạo môi trường ảo.
- **Gõ `sellbird` báo không tìm thấy lệnh.** Rất có thể bạn chưa kích hoạt môi trường ảo hoặc chưa chạy `pip install -e .`. Hãy đảm bảo bạn đang ở thư mục `sellbird` và môi trường ảo đã bật, rồi cài lại.
- **Thiếu đăng nhập Claude hoặc Codex.** Sellbird dùng Claude Code CLI hoặc Codex trên gói của bạn. Hãy chạy `claude login` để đăng nhập trước. Với Codex, xem tài liệu Using a ChatGPT plan (Codex) trong repo.
- **Dùng Docker trên máy không phải Linux.** README chỉ nói Docker dùng được trên Linux. Nếu bạn dùng Windows hoặc macOS, nên cài theo cách Python ở trên.
- **`git pull` báo “your local changes would be overwritten” khi nâng cấp từ Harvey.** Đây là lỗi 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`, `git stash pop`. Tốt hơn, hãy để thiết lập của bạn trong `sellbird.local.yaml`, file mà git không đụng tới.

Nếu gặp lỗi khác, xem tài liệu Troubleshooting trong thư mục `docs/` của repo. Muốn dừng ngay mọi thứ, chạy `sellbird sending pause`.

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

**Điểm mạnh.** Chạy trên máy của bạn, dùng gói Claude hoặc ChatGPT sẵn có, không có hoá đơn API mô hình. Nguồn tìm khách mặc định miễn phí. Mọi thư chờ bạn duyệt trước khi gửi, và trước khi gửi còn có bước kiểm tra không dùng mô hình: chặn thẻ ghép chưa điền, cụm từ bị cấm, thư quá dài, thêm link và địa chỉ không gửi được. Ngay cả khi bạn bật chế độ tự động (autopilot), nó vẫn giữ lại thư có link tới tên miền không phải của bạn.

**Giới hạn.** Bạn vẫn cần một hộp thư gửi tốt, nên có tên miền riêng và warmup, nếu không thư dễ rơi vào spam. Cài đặt cần quen terminal, và README chưa ghi lệnh kích hoạt môi trường ảo cho Windows. Giấy phép là AGPL-3.0 (các bản Harvey đến 0.3.x dùng MIT), nên nếu bạn định tích hợp vào sản phẩm của mình hãy đọc kỹ điều khoản. Ngoài ra, cold email có quy định pháp lý riêng, README có tài liệu Legal and deliverability để bạn đọc trước khi gửi.

**Khi nào chọn cách khác.** Nếu bạn không muốn tự vận hành, README nói có bản hosted tại sellbird.ai (đ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 email thủ công mỗi tuần, một công cụ đơn giản hơn có lẽ là đủ.

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

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

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

### 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/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ụ tuỳ chọn như kiểm tra email có biến key riêng trong file .env.example.

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

Tư liệu không nhắc đến yêu cầu GPU. Phần suy nghĩ do Claude hoặc Codex đảm nhận qua gói đăng ký của bạn, và yêu cầu nêu rõ chỉ là Python 3.11 trở lên.

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

README có nhắc thư mục dữ liệu trên Windows (%APPDATA%\sellbird), nhưng chưa ghi lệnh kích hoạt môi trường ảo cho Windows. Docker được nói là dùng được trên Linux. Cách an toàn là để Claude Code dẫn cài hoặc xem thêm các tài liệu trong thư mục docs/ của repo.

### Email có tự gửi đi 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 mọi thứ ngay lập tức.

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

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 home. Bảng điều khiển chạy ở địa chỉ 127.0.0.1 trên máy bạn. Tư liệu chưa nêu chi tiết hơn về bảo mật, nên hãy xem SECURITY.md trong repo.

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

Cấu hình, dữ liệu và đăng nhập bảng điều khiển của bạn được giữ lại. Chạy git pull, rồi pip install -e . một lần để có lệnh sellbird mới. Lệnh harvey vẫn dùng được tạm thời nhưng sẽ bị gỡ ở bản sau.
