# Sellbird: 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 doanh nghiệp phù hợp, tìm người quyết định, kiểm tra email, viết thư 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 terminal, và 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-18 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/sellbird-tu-dong-tim-khach-gui-cold-email-bang-claude-4

Sellbird là một công cụ mã nguồn mở chạy ngay trên máy bạn, làm trọn quy trình bán hàng chủ động bằng email: tìm công ty cần thứ bạn bán, tìm người ra 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ý phản hồi. Trước đây dự án tên là Harvey, nay đổi tên thành Sellbird nhưng vẫn là cùng một dự án, cùng lịch sử.

Người nên xem là chủ doanh nghiệp nhỏ, người làm sales hoặc marketing, freelancer và lập trình viên muốn có danh sách khách tiềm năng mà không phải trả tiền cho các công cụ prospecting đắt đỏ. Repo hiện có khoảng 5250 sao và 1127 fork, và vẫn được cập nhật trong vài tháng gần đây.

Điểm đáng giá nhất là Sellbird không dùng API key của mô hình AI. Nó 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, nên bạn không bị tính tiền theo token. Thêm nữa, mặc định không có email nào rời máy bạn cho đến khi bạn 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 vào 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 nhiều bước. Bạn có thể chạy hết, 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í. 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, nên không lo bị trừ tiền bất ngờ.

### Hiểu 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 chi phí, mỗi công ty chỉ cần ba request HTTP. Nhờ vậy bức thư sau này có chi tiết thật để nói, không phải lời chào chung chung.

### Tìm người 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. Bạn không phải mua cơ sở dữ liệu liên hệ.

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

Sellbird học quy luật đặt 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ư. Điều này giúp bảo vệ uy tín hộp thư của bạn, vì gửi nhiều thư bị trả lại là cách nhanh nhất để vào spam.

### 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 tuân theo giới hạn mỗi ngày và giờ làm việc của người nhận.

### Xử lý phản hồi

Sellbird đọc từng phản hồi và soạn sẵn câu trả lời. Nó tách thư trả lời tự động sang một bên, tôn trọng yêu cầu ngừng nhận thư ngay lập tức, và chuyển cho bạn những thứ 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 rồi chạy `sellbird export` để có file CSV đưa thẳng 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 bản này. README lưu ý macOS đi kèm Python 3.9, nên nếu `python3 --version` báo bản cũ thì chạy `brew install python@3.13` trước.
- **Gói Claude Pro hoặc Max** đã đăng nhập 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 dùng được.
- **Warmup (làm nóng) hộp thư đó.** README giới thiệu TrulyInbox cho việc này. Lưu ý đây là liên kết affiliate của tác giả. Bạn không bắt buộc phải dùng nó theo tư liệu, nhưng cần có cách warmup nào đó.

Về chi phí, README nói 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. Phần còn lại là gói AI bạn đang có và một hộp thư (README ước tính khoảng 7 USD mỗi tháng cho Google Workspace).

Về hệ điều hành, README chỉ nói rõ thư mục dữ liệu cho macOS, Windows và Linux. Phần Docker được ghi là cho Linux. Các lệnh cài trong README viết kiểu macOS/Linux. README không nói gì về yêu cầu phần cứng hay GPU.

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

```steps
- Tải mã nguồn | Dùng git clone rồi vào thư mục sellbird
- Cài đặt | Tạo môi trường ảo và cài bằng pip install -e .
- Điền thông tin | Sao chép .env.example thành .env và điền
- Dạy Sellbird về bạn | Chạy sellbird train với website của bạn
- Tìm khách | Xác nhận tín hiệu rồi chạy sellbird discover
- Chạy | Mở dashboard và chạy sellbird run
```

README đưa ra hai cách: nhờ Claude cài hộ, hoặc tự cài. Mình khuyên người mới thử cách đầu.

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

Mở terminal (Terminal trên macOS, hoặc cửa sổ dòng lệnh bạn quen dùng), rồi chạy:

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

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

Chỗ dễ vấp: bạn phải đứng đúng trong thư mục `sellbird` trước khi gõ `claude`. Nếu chưa có Claude CLI hoặc chưa đăng nhập, hãy chạy `claude login` trước.

### Cách 2: Tự cài

Bước đầu là tạo môi trường ảo và cài gói. README nhấn mạnh dùng `python3.13`, không dùng `python3` trần vì trên macOS đó là bản 3.9.

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

Dòng 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. Sau bước này bạn sẽ có lệnh `sellbird`. Lưu ý: `source .venv/bin/activate` là cú pháp macOS/Linux. README không viết lệnh kích hoạt cho Windows. Nếu dùng Windows, bạn cần cách kích hoạt môi trường ảo Python theo chuẩn của Windows, hoặc nhờ Claude cài theo cách 1.

Bước hai là đ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 này sao chép file mẫu thành `.env` rồi mở ra để sửa. File mẫu có các biến cho Gmail (`GMAIL_CLIENT_ID`, `GMAIL_CLIENT_SECRET`), SMTP/IMAP, Microsoft 365, cùng một số dịch vụ kiểm tra email như Reoon, ZeroBounce, Hunter. Mỗi biến có chú thích ngay trong file. Bạn chỉ điền phần mình dùng, ví dụ hộp thư gửi.

```note
File .env chứa mật khẩu và khoá truy cập hộp thư. Đừng gửi nó cho ai, đừng đưa lên GitHub hay chụp màn hình có lộ nội dung.
```

Bước ba là dạy Sellbird về sản phẩm của bạn từ website.

```bash
# 3. Learn your product from your website (writes sellbird.local.yaml).
sellbird train https://your-company.com
```

Thay địa chỉ bằng website thật của bạn. Lệnh này ghi kết quả vào file `sellbird.local.yaml`.

Bước bốn là xác nhận thế nào là khách tốt.

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

Bước năm là tìm doanh nghiệp. Nguồn mặc định miễn phí, không cần tài khoản.

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

Bước sáu là mở bảng điều khiển và khởi động 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 link riêng tới địa chỉ trên máy bạn (127.0.0.1:5555). Link này chỉ mở được trên máy của bạn. Còn `sellbird run` bắt đầu vòng lặp làm việc.

Trên Linux, README nói bạn cũng có thể chạy bằng Docker. Repo có sẵn `Dockerfile` và `docker-compose.yml`, và chi tiết nằm trong tài liệu Docker của repo (thư mục `docs/`).

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

Sau khi cài, lệnh `sellbird` phải gọi được trong terminal. Dấu hiệu rõ nhất là khi chạy `sellbird run`, bạn thấy một màn hình tương tự ví dụ trong README:

```
$ 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, một quyết định của vòng lặp, rồi các email xếp hàng chờ duyệt ở Outbox, và cuối cùng là thông báo nghỉ 15 phút. Dữ liệu trong ví dụ của README là bịa (công ty Bookwell bán đặt lịch cho thợ lợp mái, nha khoa, điều hoà), nên kết quả thật của bạn sẽ khác.

Bạn cũng nên mở link do `sellbird dashboard` in ra để xem các màn hình. Nếu dashboard mở được và thấy công ty vừa tìm, nghĩa là phần lõi đã chạy.

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

Cả ba tình huống dưới đây đều dùng đúng các lệnh có trong README. Nội dung tình huống là ví dụ của mình để bạn hình dung.

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

Bạn bán phần mềm đặt lịch cho các cửa hàng nhỏ. Bạn chạy `sellbird train` với website của mình để Sellbird hiểu bạn bán gì. Sau đó `sellbird signals --confirm free` để xác nhận tín hiệu cần tìm, ví dụ cửa hàng chưa có đặt lịch online. Rồi `sellbird discover` để tìm trên nguồn miễn phí. Kết quả là danh sách doanh nghiệp kèm lý do họ có thể cần bạn, để bạn mở dashboard xem từng cái.

> Nó tìm khách, viết thư và soạn câu trả lời, nhưng không có email nào đi ra 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ỉ muốn nguồn khách. Hãy 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 lại và chạy:

```bash
sellbird export
```

Lệnh này xuất file CSV sẵn để đưa vào công cụ gửi thư (sequencer) của bạn. Mỗi địa chỉ đã được gắn nhãn verified, risky, guess hoặc invalid, nên bạn lọc được theo độ tin cậy.

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

Bạn để `sellbird run` chạy, vòng lặp nghỉ 15 phút giữa các lượt. Mỗi sáng bạn mở dashboard, vào Outbox, đọc các email đang chờ rồi duyệt cái nào ổn. Khi có phản hồi, Sellbird đã soạn sẵn câu trả lời cho các thư quan tâm hoặc phản đối, bạn chỉ đọc lại. Thư nào nó không nên tự trả lời sẽ được chuyển cho bạn. Nếu thấy có gì không ổn, một lệnh dừng tất cả:

```bash
sellbird sending pause
```

### Người dùng Harvey cũ nâng cấp

Nếu bạn đang chạy Harvey, README nói cấu hình, dữ liệu và đăng nhập dashboard được giữ nguyên. Bạn chạy:

```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à đổi tên file dữ liệu tương ứng. Nó không ghi đè file đã có tên mới. Nếu bạn từng sửa trực tiếp file `harvey.yaml` thì `git pull` có thể báo lỗi, và README có hướng dẫn dùng `git stash`. 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.

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

### Python quá cũ, cài không được

Trên macOS, `python3` thường là bản 3.9, trong khi Sellbird cần 3.11 trở lên. Hãy chạy `python3 --version` kiểm tra. Nếu thấy bản cũ, cài bản mới theo README bằng `brew install python@3.13` rồi dùng `python3.13` để tạo môi trường ảo.

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

Thường là bạn chưa kích hoạt môi trường ảo, hoặc mở terminal mới nên môi trường ảo không còn hiệu lực. Vào lại thư mục `sellbird`, kích hoạt `.venv` rồi thử lại. Nếu vẫn lỗi, chạy lại `pip install -e .` trong môi trường đó.

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

Sellbird dựa vào Claude Code CLI đã đăng nhập. Nếu chưa, hãy chạy `claude login` rồi thử lại. Nếu dùng ChatGPT, bạn cần Codex CLI, và README có hướng dẫn riêng cho Codex trong thư mục `docs/`.

### Dashboard không mở được

Dashboard chạy tại địa chỉ trên máy bạn và dùng link riêng do `sellbird dashboard` in ra. Hãy dùng đúng link đó, không tự gõ địa chỉ. Nếu vẫn không được, xem tài liệu Troubleshooting trong repo.

### Thư rơi vào spam hoặc bị trả lại

Đây là rủi ro của mọi công cụ cold email. README khuyên dùng tên miền gửi riêng, có warmup cho hộp thư, và chỉ gửi tới địa chỉ đã được xác minh. Đừng bỏ qua bước warmup, và đừng tắt các kiểm tra trước khi gửi. Hãy đọc tài liệu Legal and deliverability trong repo về các quy tắc bạn phải tuân thủ.

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

**Điểm mạnh.** Chạy trên máy bạn nên bạn kiểm soát dữ liệu. Không tốn tiền API mô hình vì dùng gói bạn đã có. Các bước tìm kiếm cơ bản miễn phí. Mặc định mọi email chờ bạn duyệt, kèm bước kiểm tra tự động không dùng mô hình để chặn thẻ chưa điền, cụm từ bị cấm, thư quá dài, quá nhiều link và địa chỉ không gửi được. Giấy phép AGPL-3.0 và có thể chỉnh sửa prompt, kỹ năng bán hàng.

**Giới hạn.** Bạn vẫn phải có hộp thư gửi, tên miền và warmup. Các lệnh cài đặt trong README viết cho macOS/Linux, người dùng Windows sẽ phải tự xoay xở thêm hoặc nhờ Claude. Nguồn tìm miễn phí dựa trên OpenStreetMap, nên độ phủ phụ thuộc vào dữ liệu có ở đó. Tôi cũng không thấy README nói gì về độ phủ doanh nghiệp tại Việt Nam, bạn nên thử với một ngành nhỏ trước. Giấy phép AGPL cũng đáng đọc kỹ nếu bạn định tích hợp vào sản phẩm thương mại.

**Khi nào chọn cách khác.** Nếu bạn không muốn đụng đến terminal hay cấu hình, README có nhắc bản hosted tại trang chủ dự án, ở giai đoạn truy cập sớm, với tên miền gửi, hộp thư và warmup được thiết lập sẵn. Nếu bạn chỉ cần vài chục khách và muốn tự viết thư thì công cụ này có thể là quá nhiều. Cuối cùng, gửi thư lạnh có quy định pháp lý ở từng nơi, vì vậy hãy tự kiểm tra luật áp dụng cho bạn trước khi bật chế độ tự động.

## 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. Nguồn tìm doanh nghiệp mặc định và bước đọc website đều miễn phí 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 (README ước tính Google Workspace khoảng 7 USD mỗi tháng).

### Có cần API key của mô hình AI không?

Không. Theo README, 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. Không có API key mô hình và không tính tiền theo token. Một số dịch vụ kiểm tra email hay nguồn tìm trả phí thì có biến API key riêng trong file .env, nhưng chúng là tuỳ chọn.

### Cần GPU hoặc máy mạnh không?

README không nêu yêu cầu phần cứng nào, và phần xử lý AI chạy qua gói đăng ký của bạn nên chưa có thông tin về cấu hình tối thiểu. Yêu cầu rõ ràng duy nhất là Python 3.11 trở lên.

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

README có ghi thư mục dữ liệu cho Windows, nên có hỗ trợ ở mức đó. Nhưng các lệnh cài đặt trong README viết theo kiểu macOS/Linux, và phần Docker được ghi là cho Linux. Người dùng Windows nên nhờ Claude cài theo cách 1 hoặc xem tài liệu trong thư mục docs/.

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

Không, trừ khi bạn tự bật autopilot. Mặc định mọi email nằm ở Outbox chờ bạn duyệt. Có kiểm tra trước khi gửi, và lệnh sellbird sending pause dừng mọi việc gửi ngay lập tức.

### Dữ liệu của tôi lưu ở đâ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 chung trên máy, gồm database, log và token của dashboard. README không nói gì thêm về mức độ bảo mật ngoài việc chạy nội bộ, nên hãy tự bảo vệ file .env.

### Khác gì Harvey?

Sellbird chính là Harvey đã đổi tên, cùng dự án và cùng lịch sử. Cấu hình và dữ liệu cũ được chuyển sang tên mới khi chạy lần đầu. Lệnh harvey cũ vẫn dùng được tạm thời nhưng sẽ bị gỡ ở bản sau.
