# Sellbird: tự tìm khách, viết và gửi cold email — 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 xử lý thư trả lời, dùng gói Claude hoặc ChatGPT bạn đang có. Cài bằng vài lệnh, nhưng cần hộp thư gửi riêng và nên khởi động (warmup) hộp thư trước khi gửi.

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

Sellbird là một nền tảng outreach mã nguồn mở chạy ngay trên máy bạn. Nó làm trọn chuỗi việc của người đi chào hàng qua 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ư cá nhân hoá, gửi đi và xử lý thư trả lời. Dự án trước đây tên Harvey, nay đổi tên thành Sellbird, vẫn giữ nguyên lịch sử.

Người nên xem là chủ doanh nghiệp nhỏ, người làm sales, người làm dịch vụ B2B (bán cho doanh nghiệp), hoặc lập trình viên muốn tự động hoá khâu tìm khách. Điểm đáng giá nhất: Sellbird không dùng API tính tiền theo token. Nó "suy nghĩ" qua Claude Code CLI trên gói Claude Pro/Max, hoặc qua Codex trên gói ChatGPT. Bạn dùng gói đã trả, không phát sinh hoá đơn model. Hiện repo có khoảng 5.250 sao và 1.127 fork.

Điểm đáng giá thứ hai là tính an toàn: theo mặc định, không có email nào rời máy bạn nếu bạn chưa duyệt. Xem video ngắn bên dưới để thấy cách nó chạy, 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 quyết định, kiểm tra email, viết cold email cá nhân hoá, gửi và xử lý phản hồ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 chạy trọn chuỗi, hoặc dừng ở bước nào cũng được.

- **Tìm công ty.** 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í. 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. Bạn không bị trừ tiền bất ngờ.
- **Hiểu vì sao họ sẽ mua.** Đọc chính website của từng công ty để tìm các tín hiệu mua hàng 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 model, không tốn tiền. Mỗi công ty chỉ tốn ba yêu cầu HTTP.
- **Tìm người quyết định.** Tìm chủ hoặc quản lý được nêu tên trên trang của công ty, tối đa hai người mỗi công ty.
- **Kiểm tra địa chỉ.** 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 thư trả về và giữ uy tín tên miền gửi.
- **Viết và gửi.** Viết một chuỗi email ngắn cho từng người dựa trên những gì đã tìm thấy. Thư gửi từ hộp thư Gmail, Microsoft 365 hoặc SMTP của bạn, trong giới hạn mỗi ngày và theo giờ làm việc của người nhận.
- **Xử lý phản hồi.** Đọc mọi thư trả lời, soạn sẵn câu đáp, để riêng các thư tự động trả lời, tôn trọng yêu cầu từ chối nhận ngay lập tức. Những thứ nó không nên tự trả lời thì chuyển cho bạn.

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

Về an toàn, mọi email gửi đi nằm chờ trong Outbox cho bạn duyệt, cho đến khi bạn tự bật chế độ autopilot. Trước khi gửi còn có một lượt kiểm tra không dùng model: chặn thẻ merge chưa điền, cụm từ bị cấm, email quá dài, thừa link và địa chỉ không gửi được. Ngay cả khi bật autopilot, email có link sang 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 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ì cài thêm bản mới bằng `brew install python@3.13`.
- **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 dùng được.
- **Warmup cho hộp thư đó.** Tác giả gợi ý TrulyInbox để khởi động hộp thư mới trước khi gửi cold email. Lưu ý link TrulyInbox trong dự án là link affiliate. Đây chỉ là gợi ý, bạn tự cân nhắc.

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 đô la cho 1.000 kết quả với nguồn trả phí rẻ nhất. Đọc website là 0 đồng. Hộp thư Google Workspace khoảng 7 đô la mỗi tháng. Không cần Apollo, ZoomInfo, Clearbit hay Clay.

File `.env.example` liệt kê các biến cấu hình tuỳ chọn như khoá của các dịch vụ kiểm tra email (Reoon, ZeroBounce, Hunter) hay thông tin Gmail, SMTP, IMAP, Microsoft 365. Bạn chỉ cần điền phần mình dùng. Mỗi biến đều có giải thích ngay trong file.

README chỉ nêu cách cài chi tiết cho macOS và Linux (có hỗ trợ Docker trên Linux). Với Windows, README chỉ cho biết thư mục dữ liệu nằm ở `%APPDATA%\sellbird`. Lệnh kích hoạt môi trường ảo trong README viết cho macOS/Linux, nên người dùng Windows hãy xem thêm tài liệu trong thư mục `docs/` của repo.

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

```steps
- Chuẩn bị | Có Python 3.11+, Claude Code CLI đã đăng nhập, một hộp thư gửi
- Tải mã nguồn | git clone repo rồi cd vào thư mục
- Cài gói | Tạo môi trường ảo và pip install -e .
- Điền thông tin | Sao chép .env.example thành .env rồi sửa
- Dạy Sellbird | Chạy sellbird train với website của bạn
- Tìm khách và chạy | discover, mở dashboard, rồi run
```

Có hai cách: nhờ Claude Code cài giúp, hoặc tự gõ lệnh. Người mới nên thử cách đầu.

### Để Claude Code dẫn bạn cài

Mở terminal (macOS: Terminal; Windows: PowerShell hoặc Git Bash), gõ ba lệnh sau. Lệnh đầu tải mã nguồn về máy, lệnh thứ hai vào thư mục vừa tải, lệnh thứ 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ở, 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: nó kiểm tra bạn đang ở đâu, cài những gì còn thiếu, hỏi những thứ cần hỏi và huấn luyện Sellbird về sản phẩm của bạn. Chỗ dễ vấp: phải đứng trong thư mục `sellbird` rồi mới gõ `claude`, nếu không Claude không đọc được `CLAUDE.md`.

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

Nếu bạn muốn tự làm, vẫn tải mã nguồn như trên. Sau đó chạy lệnh dưới đây trong thư mục `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 .
```

Lệnh này tạo một môi trường ảo tên `.venv` (không làm rối Python của máy), kích hoạt nó, rồi cài Sellbird ở chế độ chỉnh sửa được để có lệnh `sellbird`. Chỗ hay vấp: trên macOS hãy gõ `python3.13` chứ không phải `python3`, vì `python3` có thể là bản 3.9 quá cũ.

### Điền thông tin truy cậ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 để bạn sửa. Mỗi biến đều có chú thích ngay trong file. Điền thông tin hộp thư gửi và khoá của dịch vụ bạn dùng. Phần nào bạn chưa dùng thì để nguyên.

```note
.env chứa mật khẩu và khoá truy cập. Đừng gửi file này cho ai, đừng đưa lên GitHub hay dán vào nhóm chat. Nên dùng một hộp thư riêng trên tên miền gửi riêng, không dùng hộp thư công ty chính.
```

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

Lệnh `train` đọc website của bạn để hiểu bạn bán gì, rồi ghi kết quả vào file `sellbird.local.yaml`. Hãy thay `https://your-company.com` bằng website thật của bạn. Lệnh `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 doanh nghiệp, mở bảng điều khiển và chạy

```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í mặc định, không cần tài khoản. `sellbird dashboard` in ra một đường link riêng tới `http://127.0.0.1:5555`, tức bảng điều khiển chạy ngay trên máy bạn. `sellbird run` khởi động vòng lặp chính. Trên Linux bạn cũng có thể chạy bằng Docker. Repo có sẵn `Dockerfile` và `docker-compose.yml`, và README có trang Docker riêng.

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

Sau khi chạy `sellbird run`, bạn sẽ thấy màn hình như README minh hoạ: dòng "Sellbird is online", rồi dòng "Checking pipeline state...", một dòng "Decision" cho biết bước nó định làm, các dòng của handler (xử lý thư trả lời) và writer (viết thư), và cuối cùng "Cycle complete. Sleeping for 15 minutes." Một dòng như "outbox → 5 emails waiting for your approval" cho biết thư đang chờ bạn duyệt chứ chưa gửi.

Cách kiểm tra thứ hai: chạy `sellbird dashboard`, mở link nó in ra, và xem trong bảng điều khiển có danh sách doanh nghiệp tìm được và mục Outbox hay không. README cũng có dữ liệu mẫu giả (công ty "Bookwell" bán đặt lịch online cho thợ lợp mái, nha khoa, điện lạnh, trên tên miền `.test`) để bạn làm quen giao diện.

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

README mô tả Sellbird theo hướng một dây chuyền bạn kiểm soát. Dưới đây là vài tình huống bám đúng khả năng đó.

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

Chị Hà có một công ty làm phần mềm đặt lịch cho tiệm làm đẹp và phòng khám nhỏ. Chị chạy `sellbird train` với website công ty, rồi `sellbird signals --confirm free` để xác nhận dấu hiệu khách tốt, ví dụ website chưa có đặt lịch online. Sau đó chị chạy `sellbird discover` để tìm doanh nghiệp từ nguồn miễn phí. Kết quả là danh sách công ty kèm lý do họ có thể cần sản phẩm, không tốn phí model.

> Sellbird chỉ gửi thứ bạn đã duyệt, trừ khi bạn tự bật autopilot.
>
> — Ông T

### Nhân viên sales chỉ cần danh sách để gửi bằng công cụ riêng

Anh Nam đã có công cụ gửi thư hàng loạt và không muốn Sellbird gửi thay. Anh chạy các bước tìm công ty, tìm người quyết định, kiểm tra email, rồi dùng:

```bash
sellbird export
```

Lệnh này xuất file CSV các liên hệ đã tìm thấy, sẵn sàng đưa vào công cụ gửi thư. Mỗi địa chỉ đã được gắn nhãn verified, risky, guess hoặc invalid, nên anh có thể loại những địa chỉ không đáng tin trước khi gửi.

### Chạy cả chuỗi với bước duyệt thủ công

Chị Lan muốn thử gửi thật nhưng không dám giao hẳn cho phần mềm. Chị chạy `sellbird run` và để nó viết các chuỗi email ngắn, mỗi chuỗi dựa trên điều tìm được về từng công ty (ví dụ công ty đang tuyển người điều phối). Chị mở bảng điều khiển bằng `sellbird dashboard`, đọc từng thư trong Outbox, sửa nếu cần rồi mới duyệt. Khi khách trả lời, Sellbird soạn sẵn câu đáp và chị là người bấm gửi.

### Dừng khẩn cấp khi có chuyện lạ

Nếu bạn thấy kết quả không như ý, hoặc cần dừng mọi thứ ngay, chỉ cần chạy:

```bash
sellbird sending pause
```

README nói lệnh này dừng toàn bộ việc gửi cùng lúc. Nên nhớ lệnh này, nhất là sau khi bạn bật autopilot.

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

**Báo Python quá cũ hoặc cài lỗi ngay bước đầu.** Trên macOS, `python3` thường là bản 3.9, thấp hơn mức 3.11 repo yêu cầu. Cài bản mới bằng `brew install python@3.13` rồi tạo môi trường ảo bằng `python3.13` như README hướng dẫn.

**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 `.venv` trong cửa sổ terminal đó, hoặc chưa chạy `pip install -e .`. Mở lại terminal ở đúng thư mục `sellbird`, kích hoạt môi trường rồi thử lại.

**Claude Code chưa đăng nhập.** Sellbird dùng Claude Code CLI để "suy nghĩ". Nếu CLI chưa đăng nhập, nó không chạy được. Chạy `claude login` trước. Nếu bạn dùng ChatGPT thì xem hướng dẫn Codex trong tài liệu của repo.

**Thư không gửi đi hoặc không thấy thư nào.** Có hai nguyên nhân thường gặp. Thứ nhất, thư đang nằm trong Outbox chờ bạn duyệt, đây là hành vi mặc định. Thứ hai, thư bị chặn bởi bước kiểm tra trước khi gửi (địa chỉ không gửi được, thẻ merge chưa điền, quá dài, thừa link). Hãy mở bảng điều khiển để xem lý do thay vì tắt các lớp bảo vệ.

**Lỗi khi nâng cấp từ Harvey.** Nếu bạn từng sửa trực tiếp file `harvey.yaml`, `git pull` có thể báo "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ữ phần của bạn, xoá dấu xung đột, rồi `git stash drop`. Lần sau hãy đặt cấu hình riêng trong `sellbird.local.yaml` để git không đụng tới.

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

**Điểm mạnh.** Bạn dùng gói Claude hoặc ChatGPT đã có nên không có hoá đơn model riêng. Mã nguồn mở, chạy trên máy bạn, dữ liệu nằm trong thư mục của bạn. Mặc định nó chờ bạn duyệt trước khi gửi, có lớp kiểm tra trước khi gửi và có lệnh dừng khẩn. Bạn có thể dừng ở bất kỳ bước nào, chẳng hạn chỉ lấy danh sách.

**Giới hạn.** Bạn phải tự lo hộp thư gửi, nên có tên miền riêng và warmup. Đây là phần tốn công và tốn tiền nhất, và nó quyết định thư có vào hộp thư chính hay vào spam. Các ví dụ trong README thiên về doanh nghiệp địa phương và thị trường nước ngoài. Tôi chưa thấy tư liệu nói về độ phủ dữ liệu doanh nghiệp Việt Nam trên nguồn miễn phí, nên bạn nên chạy thử `sellbird discover` để tự đánh giá. Hướng dẫn cài đặt trong README viết cho macOS và Linux, người dùng Windows có thể sẽ phải đọc thêm tài liệu.

**Lưu ý pháp lý.** Gửi cold email chịu quy định của từng nước. README có trang Legal and deliverability nói về luật và độ gửi tới được hộp thư. Hãy đọc trước khi gửi hàng loạt. Giấy phép là AGPL-3.0, nên nếu bạn định sửa đổi rồi cung cấp thành dịch vụ cho người khác, hãy đọc kỹ điều khoản.

**Khi nào 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 chạy sẵn trên 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ỉ cần gửi vài thư thủ công cho khách quen, một công cụ gửi thư thông thường là đủ.

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

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

Phần mềm là mã nguồn mở theo giấy phép AGPL-3.0 nên dùng được miễn phí. Nguồn tìm doanh nghiệp mặc định cũng miễn phí. 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 nêu Google Workspace khoảng 7 đô la một tháng).

### 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 model và không tính tiền theo token. Một số dịch vụ tuỳ chọn khác như kiểm tra email có biến khoá riêng trong file .env.example.

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

Tư liệu không nhắc tới yêu cầu GPU hay cấu hình máy. Việc suy nghĩ do Claude hoặc Codex thực hiện, còn Sellbird chạy bằng Python 3.11 trở lên.

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

Không, theo mặc định. Mọi email chờ trong Outbox cho đến khi bạn duyệt, trừ khi bạn tự bật autopilot. Ngay cả khi bật autopilot, email có link tới tên miền không phải của bạn vẫn bị giữ lại. Bạn có thể dừng mọi thứ bằng sellbird sending pause.

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

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

### 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, bảng điều khiển chạy tại địa chỉ 127.0.0.1 trên máy bạn. Tuy vậy việc suy nghĩ vẫn đi qua Claude hoặc Codex, nên bạn nên xem chính sách của các dịch vụ đó. File .env chứa mật khẩu, hãy giữ kín.

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

Không. Harvey đã đổi tên thành Sellbird từ bản 0.4.0. Bạn chạy git pull, rồi pip install -e . một lần để có lệnh sellbird. Cấu hình, dữ liệu và đăng nhập bảng điều khiển được chuyển tự động. Lệnh harvey cũ vẫn chạy tạm thời nhưng sẽ bị bỏ ở bản sau.
