# Sellbird: tìm khách, viết và gửi cold email tự động — 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 quyết định, kiểm tra email, viết và gửi cold email, rồi soạn sẵn câu trả lời khi có phản hồi. Nó dùng gói Claude Pro/Max hoặc ChatGPT (Codex) bạn đang có thay vì API key. Cài không quá khó nếu bạn quen dùng terminal, nhưng phần mailbox và warmup cần chuẩn bị kỹ.

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

Sellbird là một nền tảng mã nguồn mở chạy ngay trên máy bạn, làm trọn chuỗi việc của cold 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ý thư trả lờ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 và cùng lịch sử.

Repo này hợp với chủ doanh nghiệp nhỏ, người làm sales hoặc marketing B2B, và lập trình viên muốn có một “nhân viên” tìm khách hàng mà không phải trả thêm tiền cho nhóm công cụ prospecting đắt đỏ. Hiện repo có khoảng 5.250 sao và 1.127 fork, và vẫn được cập nhật trong 3 tháng gần đây.

Điểm đáng giá nhất có hai ý. Thứ nhất, Sellbird “suy nghĩ” qua 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ần 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 được gửi đi nếu bạn chưa duyệt. Bạn xem video ngắn bên dưới để thấy nó chạy ra sao, rồi quay lại đây làm theo từng bước.

```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 và người ra quyết định, xác minh email, viết cold email cá nhân hoá, gử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 dây chuyền. Bạn có thể chạy hết, hoặc dừng ở bất kỳ bước nào.

- **Tìm công ty.** 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 bằng nguồn trả phí đều hiện chi phí trước khi chạy. Nhờ vậy bạn không lo bị tính tiền bất ngờ.
- **Hiểu vì sao họ sẽ mua.** Nó đọc chính website của từng công ty để tìm các “tín hiệu mua” 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 chi phí. Mỗi công ty chỉ tố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 trên các 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 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. Chỉ địa chỉ gửi được mới được gửi thư. Việc này giúp bạn tránh gửi vào địa chỉ chết làm hỏng uy tín mailbox.
- **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 đó nó gửi từ mailbox 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ý thư trả lời.** Nó đọc mọi phản hồi và soạn sẵn câu trả lời. Thư tự động trả lời được xếp riêng, yêu cầu từ chối nhận thư được thực hiện ngay, còn những việc nó không nên tự trả lời thì chuyển lại cho bạn.

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 sẵn sàng nạp vào công cụ gửi thư khác.

Trước khi gửi, một bước kiểm tra không dùng mô hình sẽ loại các email còn sót thẻ merge chưa điền, chứa cụm từ bị cấm, quá dài, có thêm link hoặc gửi tới địa chỉ không gửi được. Khi bật autopilot, Sellbird vẫn giữ lại email có link tới tên miền không phải của bạn hoặc trích lại chỉ dẫn nội bộ của chính Sellbird.

## 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 có sẵn 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ới Claude Code CLI đã đăng nhập (`claude login`), hoặc **gói ChatGPT có Codex CLI**. Phần Codex có hướng dẫn riêng trong thư mục `docs/`.
- **Một mailbox để gửi thư.** README khuyên dùng Google Workspace trên một tên miền gửi riêng, còn Microsoft 365 và SMTP cũng chạy được. Tài liệu ước tính Google Workspace khoảng 7 USD một tháng.
- **Warmup cho mailbox đó.** README gợi ý TrulyInbox để làm nóng mailbox mới trước khi gửi cold email. Lưu ý đây là link affiliate của tác giả, và bạn không bắt buộc dùng nó.

Trong file `.env.example` có sẵn các biến cho Gmail, SMTP/IMAP, Microsoft 365, các dịch vụ xác minh email và vài dịch vụ khác. Bạn không cần điền hết. Chỉ điền phần liên quan đến mailbox bạn dùng, và README nói mỗi biến đều có chú thích ngay trong file.

Về hệ điều hành, README nhắc rõ thư mục dữ liệu trên macOS, Windows và Linux, và nói “trên Linux bạn cũng có thể chạy bằng Docker”. Repo có sẵn `Dockerfile` và `docker-compose.yml`. Phần lệnh kích hoạt môi trường ảo trong README viết cho macOS/Linux. Nếu bạn dùng Windows, hãy xem thêm thư mục `docs/` (mục Troubleshooting) vì README chưa ghi lệnh riêng cho Windows.

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

```steps
- Lấy mã nguồn | Clone repo về máy và vào thư mục
- Cách nhanh | Mở Claude Code và nhờ nó cài giúp
- Hoặc tự cài | Tạo môi trường ảo, cài gói, điền .env
- 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, rồi chạy discover
- Mở bảng điều khiển | Chạy dashboard và run
```

Có hai đường: để Claude Code hướng dẫn bạn, hoặc tự gõ lệnh. Người mới nên thử đường thứ nhất trước.

### Lấy mã nguồn về máy

Mở terminal (macOS/Linux dùng Terminal; Windows dùng PowerShell hoặc Git Bash), chọn 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.

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

Trong cùng thư mục, gõ:

```bash
claude
```

Khi Claude Code mở, bạn nói: **“set up Sellbird for me”**. File `CLAUDE.md` của repo biến Claude Code thành người hướng dẫn cài đặt: nó kiểm tra máy bạn, 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. Điều kiện là bạn đã cài Claude Code CLI và đăng nhập bằng `claude login`.

### Hoặc tự cài từng lệnh

README đưa ra chuỗi lệnh sau. Hãy chạy từng dòng một và đọc kết quả trước khi chạy dòng kế tiếp:

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

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

# 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

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

Giải thích từng bước:

- **Bước 1** 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ữ `-e` nghĩa là cài ở chế độ chỉnh sửa được, và sau đó lệnh `sellbird` sẽ dùng được. Chỗ dễ vấp: dùng `python3.13` (hoặc bản 3.11 trở lên), đừng dùng `python3` trần vì trên macOS đó là bản 3.9.
- **Bước 2** sao chép file mẫu `.env.example` thành `.env`, rồi mở ra để điền thông tin mailbox và các key bạn có. `$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 thảo thường rồi lưu lại.
- **Bước 3** cho Sellbird đọc website công ty bạn để hiểu bạn bán gì. Nó ghi kết quả vào `sellbird.local.yaml`. Hãy thay `https://your-company.com` bằng website thật của bạn.
- **Bước 4** xác nhận những tín hiệu nào cho thấy một công ty là khách tốt. Tham số `free` là đúng như trong README.
- **Bước 5** đi tìm doanh nghiệp. Nguồn mặc định miễn phí và không cần tài khoản.
- **Bước 6** `sellbird dashboard` in ra một đường link riêng tới `http://127.0.0.1:5555` để bạn mở bảng điều khiển trên trình duyệt. `sellbird run` bắt đầu vòng lặp chạy liên tục.

```note
Mặc định mọi email nằm trong Outbox chờ bạn duyệt, đừng vội bật autopilot. Hãy đọc kỹ vài chục email đầu rồi hãy quyết định. Khi cần dừng ngay mọi thứ, chạy: sellbird sending pause. Tuyệt đối không đưa file .env (chứa mật khẩu và key) lên GitHub hay gửi cho người khác.
```

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

Có vài dấu hiệu để biết bạn cài đúng:

1. Lệnh `python3 --version` (hoặc `python3.13 --version`) cho ra phiên bản 3.11 trở lên.
2. Sau khi cài xong, gõ `sellbird` không báo “command not found”. Nếu báo, nhiều khả năng bạn chưa kích hoạt môi trường ảo `.venv`.
3. `sellbird dashboard` in ra một link riêng tới `http://127.0.0.1:5555`. Mở link đó và thấy bảng điều khiển là xong.
4. `sellbird run` hiện dòng “Sellbird is online” rồi chạy từng chu kỳ. Theo README, mỗi chu kỳ ghi trạng thái, ví dụ quyết định “write_campaign”, các dòng của handler và writer, số email đang chờ bạn duyệt trong outbox, rồi nghỉ 15 phút. Dữ liệu trong README là dữ liệu mẫu bịa ra (công ty “Bookwell”), nên của bạn sẽ khác.

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

### Chủ công ty nhỏ lấy 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 ở một thành phố và muốn có danh sách để gọi điện, không cần gửi email tự động. Bạn chạy `sellbird train` với website của mình, xác nhận tín hiệu bằng `sellbird signals --confirm free`, rồi `sellbird discover`. Khi Sellbird đã tìm và xác minh xong, chạy:

```bash
sellbird export
```

Kết quả là một file CSV các công ty và người liên hệ đã tìm được, sẵn sàng nạp vào công cụ gửi thư khác. Bạn dùng nguồn tìm miễn phí và gần như chỉ tốn thời gian.

> Sellbird chạy bằng gói bạn đã trả sẵn, và mặc định không email nào đi nếu bạn chưa gật đầu.
>
> — Ông T

### Nhân viên sales duyệt và gửi cold email có kiểm soát

Bạn làm sales cho một công ty dịch vụ. Sau khi gắn mailbox Google Workspace ở một tên miền gửi riêng và warmup xong, bạn chạy `sellbird run`. Mỗi chu kỳ, Sellbird viết chuỗi email cho các khách mới, như chuỗi hai email nhắc đến việc công ty đó đang tuyển một vị trí. Bạn mở dashboard, vào Outbox, đọc từng email, sửa nếu cần rồi duyệt. Thư chỉ rời đi sau khi qua bước kiểm tra cuối: không còn thẻ merge, không có link thừa, địa chỉ nhận gửi được. Cách làm này giúp bạn giữ quyền quyết định mà vẫn tiết kiệm phần lớn thời gian viết.

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

Sau vài ngày gửi, hộp thư bắt đầu có phản hồi. Sellbird đọc từng thư, soạn nháp câu trả lời cho khách quan tâm hoặc có phản đối, xếp riêng thư trả lời tự động và thực hiện ngay yêu cầu từ chối nhận thư. Bạn vào dashboard để xem các câu trả lời đã soạn và những thư nó giao lại cho bạn tự xử lý. Với người làm một mình, đây là phần giúp tránh quên trả lời một khách đang nóng.

### Lập trình viên chỉnh playbook và mở rộng

Bạn là dev và muốn Sellbird viết theo phong cách của mình. Repo có thư mục `prompts/` và `skills/` chứa các playbook bán hàng có thể chỉnh sửa, và README ghi rõ các file này “all yours to edit”. Ngoài ra còn có tài liệu về Extensions để thêm route, bước heartbeat hoặc lệnh từ một gói riêng. Bạn nên đọc tài liệu “Skills and sub-agents” trong `docs/` để biết agent nào dùng playbook nào trước khi sửa.

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

**Cài xong nhưng bị lỗi phiên bản Python.** Trên macOS, `python3` trần là bản 3.9 nên không đáp ứng yêu cầu 3.11 trở lên. Cài bản mới bằng `brew install python@3.13` rồi tạo lại môi trường ảo bằng `python3.13 -m venv .venv`.

**Gõ `sellbird` báo không tìm thấy lệnh.** Thường 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 chưa chạy `pip install -e .`. Mở terminal mới, vào thư mục `sellbird`, kích hoạt lại `.venv` rồi thử lại.

**Sellbird không “suy nghĩ” được.** Nó dựa vào Claude Code CLI (hoặc Codex). Nếu CLI chưa đăng nhập, chạy `claude login`. Với gói ChatGPT, làm theo hướng dẫn Codex trong `docs/`.

**Chạy rồi mà không thấy email nào gửi đi.** Đây là hành vi mặc định, không phải lỗi. Email chờ trong Outbox cho đến khi bạn duyệt hoặc tự bật autopilot. Vào dashboard để xem.

**`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 `harvey.yaml`, README hướng dẫn chạy `git stash`, `git pull`, rồi `git stash pop`. Nếu có xung đột, giữ các dòng của bạn, xoá dấu xung đột rồi chạy `git stash drop`. Cách tốt hơn là đặt cài đặt riêng trong `sellbird.local.yaml`, vì git không đụng tới file này.

**Email vào thư rác hoặc tỷ lệ gửi thấp.** Đây là rủi ro chung của cold email, đặc biệt khi mailbox mới chưa warmup. README nhấn mạnh phải warmup và gửi từ tên miền riêng. Hãy đọc mục “Legal and deliverability” trong `docs/` để nắm các quy tắc bạn đang gửi thư dưới đó. Quy định cụ thể ở nước bạn thì bạn nên tự kiểm tra thêm.

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

**Điểm mạnh.** Bạn không phải trả tiền cho API mô hình hay cho bộ công cụ prospecting như Apollo, ZoomInfo, Clearbit hoặc Clay (README nói rõ không dùng các công cụ này). Nguồn tìm mặc định miễn phí và mọi chi phí trả phí đều hiện ra trước khi chạy. Dữ liệu nằm trên máy bạn. Cơ chế duyệt thủ công và bước kiểm tra trước khi gửi giúp bạn yên tâm hơn so với công cụ gửi hàng loạt. Mã nguồn mở và bạn sửa được playbook theo ý mình.

**Giới hạn.** Bạn phải tự lo mailbox, tên miền gửi và warmup, vì đây là phần quyết định thư có vào hộp thư chính hay không. Cần quen terminal ở mức cơ bản. Đoạn cài trong README viết cho macOS/Linux, còn Docker chỉ được nhắc cho Linux. Nguồn tìm miễn phí dựa trên OpenStreetMap nên độ phủ phụ thuộc vào ngành và khu vực của bạn. Tôi chưa có thông tin về chất lượng dữ liệu ở Việt Nam. 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 đóng gói thành dịch vụ cho người khác thì cần đọc kỹ điều khoản. Cold email cũng có luật và quy định riêng, bạn nên tìm hiểu trước khi gửi hàng loạt.

**Khi nên chọn cách khác.** Nếu bạn không muốn tự vận hành, tác giả có bản hosted tại trang chủ dự án (đang trong giai đoạn early access), với tên miền gửi, hộp thư và warmup được lo sẵn. Nếu bạn chỉ cần một danh sách, hãy dừng ở `sellbird export`. Còn nếu đã có công cụ gửi thư quen thuộc, bạn vẫn có thể dùng Sellbird chỉ để tìm và xác minh khách.

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

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

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

### Có cần API key của Claude hay OpenAI 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, 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ư xác minh email có thể cần key riêng, có trong file .env.example.

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

README có nêu thư mục dữ liệu trên Windows (%APPDATA%\sellbird) cho bản cài như gói. Tuy nhiên các lệnh cài đặt trong README viết theo kiểu macOS/Linux, còn Docker chỉ được nhắc cho Linux. Bạn nên xem mục Troubleshooting trong thư mục docs của repo nếu gặp vướng mắc trên Windows.

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

Tư liệu không nêu yêu cầu GPU hay cấu hình phần cứng. Việc suy nghĩ do Claude hoặc Codex đảm nhận qua gói đăng ký của bạn, còn bước đọc website chỉ dùng ba request HTTP mỗi công ty và không gọi mô hình.

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

Mặc định thì không. Mọi email nằm trong Outbox chờ bạn duyệt cho đến 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, và 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 bạn, cấu hình, kiến thức và dữ liệu nằm trong một thư mục riêng (data/ chứa cơ sở dữ liệu, log và token của dashboard). Dashboard mở ở địa chỉ cục bộ 127.0.0.1 với link riêng. Tư liệu không nói gì thêm về các mức bảo mật khác, và bạn nên tự giữ kỹ file .env.

### Tôi đang dùng Harvey thì có phải cài lại không?

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