# Sellbird: tự tìm khách, viết và gửi cold email bằng gói Claude — hướng dẫn cài đặt và dùng

> Sellbird (trước đây là Harvey) là nền tảng mã nguồn mở viết bằng Python, giúp bạn làm outreach: tìm công ty, tìm người ra quyết định, xác minh email, viết cold email và xử lý thư trả lời. Nó chạy trên máy bạn, dùng gói Claude Pro/Max hoặc ChatGPT (Codex) sẵn có nên không cần API key mô hình. Cài bằng vài lệnh, hoặc nhờ Claude Code cài giúp; mặc định không có email nào được gửi đi khi bạn chưa duyệt.

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

Sellbird là một nền tảng mã nguồn mở để làm outreach (tiếp cận khách hàng mới bằng email). Nó tìm các công ty có thể cần thứ bạn bán, tìm người quyết định, kiểm tra địa chỉ email, viết cho mỗi người một thư riêng, gửi đi và xử lý thư trả lời. Dự án trước đây tên là Harvey, nay đổi tên thành Sellbird, vẫn cùng lịch sử và cùng tác giả.

Bạn nên xem qua repo này nếu bạn là chủ doanh nghiệp nhỏ, người làm sales hoặc marketing, hay freelancer đang cần tìm khách mới mà không muốn trả tiền cho cả bộ công cụ như Apollo, ZoomInfo, Clearbit hay Clay. Theo README, Sellbird không dùng các công cụ đó. Repo hiện có khoảng 5.249 sao và 1.127 fork, và vẫn được cập nhật trong vài tháng gần đây.

Điểm đáng giá nhất là hai thứ. Thứ nhất, nó “nghĩ” bằ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. Thứ hai, mặc định không có email nào rời máy bạn nếu bạn chưa duyệt. Bạn có thể xem video ngắn bên dưới để hình dung trước, rồi quay lại đọc phần cài đặt.

```repo
- repo | ethanplusai/sellbird
- kind | Ứng dụng
- desc | Sellbird tự tìm công ty hợp khách hàng, tìm người quyết định, kiểm tra email, viết thư cá nhân hoá, gửi đi và xử lý thư trả lời, chạy trên gói Claude hoặc ChatGPT của bạn.
- stars | 5.2k
- 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 gồm nhiều bước. Bạn có thể chạy trọn vẹn hoặc dừng ở bất kỳ bước nào.

- **Tìm công ty.** 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. 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. Nhờ vậy bạn không bị “cháy túi” bất ngờ.
- **Hiểu vì sao 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, hay đ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 tiền. README nói mỗi công ty chỉ cần ba request HTTP.
- **Tìm người quyết định.** Nó tìm chủ hoặc quản lý được nêu tên ngay trên 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 gửi thư đại trà vào hộp thư chung.
- **Kiểm tra địa chỉ email.** Nó học quy luậ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, và chỉ địa chỉ gửi được mới được dùng để gửi. Việc này giúp bạn giảm thư bị trả lại, vốn 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 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. Thư chỉ gửi trong giới hạn mỗi ngày và trong 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 đáp, tách riêng thư tự độ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ứ không nên tự trả lời.

Nếu bạn chỉ cần danh sách khách, hãy dừng sau bước xác minh và chạy `sellbird export` để lấy file CSV dùng được ngay với các công cụ gửi thư hàng loạt.

Có thêm một lớp an toàn đáng chú ý. Trước khi gửi, một bước kiểm tra không dùng mô hình sẽ chặn thư còn sót merge tag chưa điền, cụm từ bị cấm, thư quá dài, thư có thêm link, và địa chỉ không gửi được. Ngay cả khi bạn bật autopilot, thư có link tới tên miền không phải của bạn vẫn bị giữ lại.

## 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 mặc định đ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.
- **Gói Claude Pro hoặc Max** và đã đăng nhập Claude Code 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.** 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 chạy được. Chi phí tham khảo trong README là khoảng 7 USD mỗi tháng cho Google Workspace.
- **Warmup (làm nóng) hộp thư.** README khuyên dùng TrulyInbox để làm nóng hộp thư mới trước khi gửi cold email. Sellbird đọc tỷ lệ inbox của TrulyInbox để báo bạn khi nào sẵn sàng. Lưu ý: link TrulyInbox trong dự án là link affiliate, tác giả có thể nhận hoa hồng.

Về hệ điều hành, README chỉ nói rõ lệnh mẫu cho macOS và Linux, kèm đường dẫn thư mục dữ liệu cho cả macOS, Windows và Linux. Docker được ghi là chạy trên Linux. Nếu bạn dùng Windows, hãy xem thêm trong thư mục `docs/` của repo trước khi bắt đầu.

File `.env.example` liệt kê nhiều biến cấu hình, chẳng hạn cho Gmail, SMTP/IMAP, Microsoft 365, Instantly, các dịch vụ xác minh email như Reoon, ZeroBounce, Hunter, cùng TrulyInbox. Bạn không phải điền hết, chỉ điền phần ứng với dịch vụ bạn thật sự dùng.

```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 chứ không dùng tên miền chính của công ty, và đọc phần “Legal and deliverability” trong thư mục docs/ về quy định gửi thư. Quy định về email quảng cáo khác nhau theo từng nước, nên bạn tự kiểm tra trước khi gửi cho khách thật.
```

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

```steps
- Lấy mã nguồn | Clone repo về máy và vào thư mục dự án
- Cài gói Python | Tạo môi trường ảo và cài Sellbird
- Điền thông tin đăng nhập | 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
- Xác nhận khách lý tưởng | Chạy sellbird signals và sellbird discover
- Mở bảng điều khiển | Chạy sellbird dashboard rồi sellbird run
```

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

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

Mở terminal (trên Windows là PowerShell hoặc Git Bash, trên macOS là Terminal), rồi chạy ba lệnh sau. Lệnh đầu tải mã nguồn về, lệnh hai vào thư mục vừa tải, lệnh ba mở Claude Code ngay trong thư mục đó.

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

Khi Claude Code mở ra, bạn gõ **“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 đặt: kiểm tra máy của bạn, cài những gì còn thiếu, hỏi những thông tin cần thiết và dạy 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` khi gõ `claude`, nếu không Claude sẽ không đọc được `CLAUDE.md` của dự án.

### Cài bằng tay: tạo môi trường và cài gói

Nếu muốn tự làm, hãy chạy lệnh sau trong thư mục `sellbird`. Lệnh này tạo môi trường ảo `.venv`, kích hoạt nó rồi cài Sellbird.

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

README dặn dùng `python3.13` chứ không dùng `python3`, vì trên macOS `python3` trần là bản 3.9 quá cũ. Dòng `source .venv/bin/activate` là cú pháp của macOS và Linux. README chưa ghi lệnh kích hoạt cho Windows, nên người dùng Windows hãy xem thư mục `docs/` hoặc phần Troubleshooting trong repo.

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

Sao chép file mẫu thành `.env`, rồi mở ra để điền. README nói mọi biến đều có chú thích ngay trong file.

```bash
# 2. Add credentials. Every variable is documented inline.
cp .env.example .env && $EDITOR .env
```

`$EDITOR` là trình soạn thảo mặc định của terminal. Nếu bạn không quen, cứ mở file `.env` bằng trình soạn văn bản quen thuộc rồi lưu lại. Đừng gửi file `.env` cho người khác hay đưa lên GitHub, vì trong đó có mật khẩu hộp thư.

### Dạy Sellbird về sản phẩm của bạn

Lệnh dưới đây cho Sellbird đọc website của công ty bạn để hiểu bạn bán gì, bán cho ai. Kết quả được ghi vào file `sellbird.local.yaml`.

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

Hãy thay `https://your-company.com` bằng địa chỉ website thật của bạn.

### Xác nhận khách lý tưởng và tìm doanh nghiệp

Hai lệnh tiếp theo xác nhận thế nào là khách tiềm năng tốt, rồi tìm doanh nghiệp. Nguồn mặc định miễn phí và không cần tài khoản.

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

### Mở bảng điều khiển và chạy vòng lặp

Lệnh `sellbird dashboard` in ra một đường link riêng tư tới `http://127.0.0.1:5555`. Đây là địa chỉ chỉ mở được trên máy bạn. Sau đó `sellbird run` khởi động vòng lặp chính.

```bash
# 6. Open the dashboard and start the loop.
sellbird dashboard          # prints a private link to http://127.0.0.1:5555
sellbird run
```

Nếu bạn dùng 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.

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

Có ba dấu hiệu để biết mọi thứ ổn.

Trước hết, chạy `python3 --version` (hoặc `python3.13 --version`) và xác nhận số phiên bản từ 3.11 trở lên. Sau đó chạy `sellbird dashboard`. Nếu lệnh `sellbird` được nhận ra và in ra một link riêng tư tới `http://127.0.0.1:5555`, tức là gói đã cài xong. Mở link đó trên trình duyệt của máy bạn để xem bảng điều khiển.

Cuối cùng, chạy `sellbird run`. Theo README, bạn sẽ thấy dòng “Sellbird is online”, rồi các dòng kiểu “Checking pipeline state…”, “Decision: …” và “Cycle complete. Sleeping for 15 minutes.” Giữa đó là các dòng cho biết agent nào đang làm gì (handler, writer, outbox). Ví dụ trong README có dòng “outbox → 5 emails waiting for your approval”, nghĩa là các thư đang chờ bạn duyệt chứ chưa gửi.

Nếu `sellbird` báo không tìm thấy lệnh, hãy kiểm tra bạn đã kích hoạt môi trường ảo `.venv` trong cửa sổ terminal hiện tại chưa.

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

### Chủ công ty dịch vụ nhỏ cần danh sách khách

Bạn bán phần mềm đặt lịch cho phòng khám nha khoa và tiệm sửa điều hoà, và chưa muốn gửi thư tự động. Bạn chạy `sellbird train` với website của mình, `sellbird signals --confirm free`, rồi `sellbird discover`. Sau khi bước xác minh xong, bạn chạy:

```bash
sellbird export
```

Bạn nhận được một file CSV gồm các công ty, người quyết định và địa chỉ đã xác minh, dùng được ngay trong công cụ gửi thư bạn đang có. Bạn tận dụng được phần tìm khách mà không phải để Sellbird gửi thay mình.

> Công cụ tốt nhất là công cụ cho bạn quyền bấm “duyệt” trước khi thư rời máy.
>
> — Ông T

### Nhân viên sales duyệt thư mỗi sáng

Bạn để `sellbird run` chạy nền. Mỗi sáng bạn mở bảng điều khiển bằng `sellbird dashboard`, vào mục Outbox và đọc từng thư mà agent đã viết. Mỗi thư dựa trên những gì tìm thấy trên website của công ty đó, ví dụ họ đang tuyển nhân viên điều phối. Bạn sửa vài chữ, bấm duyệt, và Sellbird gửi trong giới hạn mỗi ngày cùng giờ làm việc của người nhận. Kết quả là bạn dành vài phút duyệt thay vì cả buổi viết thư tay.

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

Sau vài ngày có người trả lời. Sellbird đọc từng thư, phân loại (ví dụ quan tâm, phản đối), soạn sẵn câu trả lời và tách thư tự động ra riêng. Ai yêu cầu ngừng nhận thư thì được ghi nhận ngay. Những thư Sellbird không nên tự trả lời sẽ được chuyển cho bạn. Bạn chỉ cần xem lại phần được đánh dấu cần bạn quyết định.

### Cần dừng khẩn cấp

Bạn thấy nội dung thư chưa ổn, hoặc muốn kiểm tra lại cấu hình. Chạy lệnh sau để dừng mọi việc gửi thư ngay lập tức:

```bash
sellbird sending pause
```

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

**1. Cài đặt báo lỗi vì Python quá cũ.** Gói yêu cầu Python 3.11 trở lên. Trên macOS, `python3` trần thường là 3.9. Hãy cài bản mới (`brew install python@3.13`) rồi tạo lại môi trường ảo bằng `python3.13`, đúng như README dặn.

**2. Sellbird không “nghĩ” được vì chưa đăng nhập Claude.** Vì không dùng API key, Sellbird cần Claude Code CLI đã đăng nhập gói Pro hoặc Max. Chạy `claude login` và làm theo hướng dẫn. Nếu bạn dùng ChatGPT, hãy làm theo hướng dẫn Codex trong thư mục `docs/`.

**3. Thư vào spam hoặc bị trả lại.** Hộp thư mới chưa được làm nóng rất dễ bị đánh dấu spam. Hãy làm warmup trước khi gửi hàng loạt, dùng tên miền gửi riêng, và chỉ gửi tới địa chỉ có nhãn deliverable như Sellbird đã lọc. Đừng tự ép gửi tới các địa chỉ nhãn guess hoặc invalid.

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

**5. Lệnh `harvey` cũ vẫn chạy nhưng có cảnh báo.** Lệnh `harvey` và `python -m harvey` vẫn chạy tạm thời và thông báo đã chuyển sang `sellbird`. Hãy chuyển sang lệnh mới, vì README nói các lệnh cũ sẽ bị gỡ ở bản sau. Nếu bạn đang chạy một tiến trình Harvey trong thư mục đó, hãy dừng nó trước.

Nếu gặp lỗi khác, repo có tài liệu Troubleshooting trong thư mục `docs/` và file `SUPPORT.md`.

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

**Điểm mạnh.** Bạn không phải trả tiền API mô hình, vì nó chạy trên gói Claude hoặc ChatGPT sẵn có. Nguồn tìm khách mặc định miễn phí. Mọi thứ chạy trên máy bạn và dữ liệu nằm trong một thư mục của bạn. Mặc định không gửi gì khi chưa duyệt, và có bước kiểm tra trước khi gửi không dùng mô hình. Đây là cách làm khá thận trọng cho một công cụ gửi email tự động.

**Giới hạn.** Cold email dễ vướng quy định về thư quảng cáo và rất dễ làm hỏng uy tín tên miền nếu làm ẩu. Công cụ không thay được việc bạn tự đọc lại thư và hiểu luật. Bạn cũng cần một hộp thư gửi riêng và thời gian warmup. Về cài đặt, README viết sẵn cho macOS và Linux, người dùng Windows sẽ phải tự tìm thêm trong tài liệu. 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 thương mại, hãy đọc kỹ giấy phép.

**Khi nào chọn cách khác.** Nếu bạn không muốn tự chạy và quản lý hộp thư, README nhắc tới bản trả phí sellbird.ai, có sẵn tên miền gửi, hộp thư và warmup, hiện ở giai đoạn early access. Nếu bạn chỉ cần danh sách khách mà không cần gửi thư, hãy dừng sau bước xác minh và dùng `sellbird export`. Nếu bạn cần tìm khách ở quy mô rất lớn với dữ liệu liên hệ phong phú, bạn sẽ phải xem nguồn trả phí và tự cân nhắc chi phí.

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

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

Mã nguồn miễn phí, giấy phép AGPL-3.0. Nguồn tìm doanh nghiệp mặc định (OpenStreetMap) không tốn tiền, và đọc website cũng không tốn tiền. Bạn vẫn cần gói Claude Pro/Max hoặc gói ChatGPT có Codex, cùng một hộp thư để gửi (README nhắc khoảng 7 USD mỗi tháng cho Google Workspace).

### 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 khác như xác minh email có thể cần key riêng, xem file .env.example.

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

Tư liệu không nhắc tới yêu cầu GPU. Phần suy nghĩ do Claude hoặc Codex đảm nhiệm, nên máy của bạn chủ yếu cần Python 3.11 trở lên và kết nối mạng.

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

README ghi đường dẫn thư mục dữ liệu cho Windows, nhưng các lệnh mẫu viết cho macOS và Linux, và Docker được ghi là cho Linux. Tư liệu chưa nói rõ hướng dẫn cài trên Windows, nên bạn hãy xem thư mục docs/ và phần Troubleshooting trong repo.

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

Mặc định thì không. Mỗi email chờ trong Outbox cho tới khi bạn duyệt, trừ khi chính bạn bật autopilot. 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 nằm ở đâu?

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, là thư mục dự án nếu bạn clone repo, hoặc thư mục dữ liệu người dùng nếu cài như một gói. Tư liệu không nói thêm về việc dữ liệu có đi đâu khác khi dùng các dịch vụ bên thứ ba bạn tự bật.

### Tôi đang dùng Harvey thì nâng cấp thế nào?

Harvey đã đổi tên thành Sellbird ở bản 0.4.0, cấu hình và dữ liệu của bạn được giữ lại. Chạy git pull, rồi pip install -e . và sellbird dashboard. Các biến HARVEY_* vẫn dùng được khi chưa có biến SELLBIRD_* tương ứng.
