# 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 tên Harvey) là nền tảng mã nguồn mở viết bằng Python, giúp tìm khách hàng tiềm năng, kiểm tra email, viết và gửi cold email rồi xử lý thư trả lời. Nó chạy bằng gói Claude Pro/Max hoặc ChatGPT có Codex bạn đang có, không cần API key của mô hình. Cài đặt khá gọn nếu bạn đã quen terminal, và mặc định không 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-20 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/sellbird-tu-dong-tim-khach-gui-cold-email-bang-claude-5

Sellbird là một nền tảng mã nguồn mở chạy trên máy của bạn, làm trọn quy trình bán hàng chủ động qua email: tìm công ty phù hợp, tìm người 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 là Harvey, giờ đã đổi tên thành Sellbird. Hiện repo có khoảng 5.250 sao và 1.127 fork.

Người nên xem là chủ doanh nghiệp nhỏ, người làm sale, agency hoặc lập trình viên muốn tự động hoá việc tìm khách mà không trả tiền cho hàng loạt công cụ prospecting. Điểm đáng giá nhất: Sellbird dùng chính gói Claude Pro/Max của bạn (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.

Một điểm nữa khiến mình yên tâm: mặc định không có email nào rời máy bạn nếu bạn chưa bấm duyệt. Bạn có thể xem video ngắn bên dưới để thấy tổng quan, 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 và người ra 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, chạy 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. Bạn có thể chạy từ đầu đến cuối, hoặc dừng ở bất kỳ bước nào.

- **Tìm công ty.** Tìm doanh nghiệp giống khách hà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.** Sellbird đọc 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, 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 gì (README ghi là ba request HTTP cho mỗi công ty).
- **Tìm người quyết định.** Lấy chủ hoặc quản lý được nêu 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.
- **Kiểm tra địa chỉ email.** Sellbird học quy luật email của công ty rồi kiểm tra một địa chỉ. Mỗi địa chỉ được gắn nhãn: verified (đã xác minh), risky (rủi ro), guess (đoán) hoặc invalid (không hợp lệ). Chỉ địa chỉ gửi được mới được gửi thư.
- **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 đượ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ý thư trả lời.** Đọc mọi thư trả lời, soạn sẵn câu đáp, tách thư tự động ra riê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ư nó 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 kiểm tra email và chạy `sellbird export` để có file CSV sẵn sàng đưa vào công cụ gửi mail khác.

Về chi phí, README liệt kê: 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ả ở nguồn trả phí rẻ nhất; đọc website là 0 đồng; gửi thư cần gói thuê bao và một hộp thư (README nêu khoảng 7 USD một tháng cho Google Workspace). Không cần Apollo, ZoomInfo, Clearbit hay Clay.

## 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 Python từ 3.11. 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.
- **Claude Pro hoặc Max** với Claude CLI đã đăng nhập (`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 mail riêng. Microsoft 365 và SMTP cũng dùng được.
- **Warmup (làm nóng) cho hộp thư đó.** Tác giả giới thiệu TrulyInbox. README cũng nói các liên kết TrulyInbox là liên kết affiliate, nghĩa là người duy trì dự án có thể nhận hoa hồng.
- Git, để tải mã nguồn về.

Về hệ điều hành, README có nêu thư mục dữ liệu cho macOS, Windows và Linux. Riêng Docker thì README chỉ nói "trên Linux có thể chạy bằng Docker". Các lệnh tạo môi trường ảo trong README là kiểu macOS/Linux.

```note
Cold email là việc có quy định pháp lý và ảnh hưởng đến uy tín tên miền của bạn. Hãy đọc tài liệu "Legal and deliverability" trong thư mục docs/ của repo trước khi gửi thật. Nên gửi từ một tên miền riêng, đã warmup, không dùng tên miền chính của công ty.
```

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

```steps
- Tải mã nguồn | Clone repo về máy và vào thư mục dự án
- Cài đặt | Tạo môi trường ảo Python và cài Sellbird
- Điền thông tin | Sao chép .env.example thành .env và điền thông tin hộp thư
- Dạy Sellbird về sản phẩm | Chạy sellbird train với website của bạn
- Tìm khách và chạy | Xác nhận tín hiệu, tìm doanh nghiệp, mở dashboard rồi chạy vòng lặp
```

README có hai đường: nhờ Claude cài hộ, hoặc tự làm. Cách đầu dễ hơn cho người mới.

### Cách 1: để Claude cài hộ

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

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

Lệnh `claude` mở Claude Code ngay trong thư mục dự án. Sau đó 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 gì cần hỏi và dạy Sellbird về sản phẩm của bạn. Bạn nên đọc kỹ từng câu nó hỏi, nhất là phần liên quan đến mật khẩu hộp thư.

### Cách 2: tự cài từng bước

Vẫn cần tải mã nguồn và vào thư mục như trên. Sau đó làm theo README. Bước 1 là cài đặt:

```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ột môi trường ảo tên `.venv` (để không lẫn với Python khác trên máy), bật nó lên, rồi cài Sellbird ở chế độ chỉnh sửa được. Sau khi xong, bạn có lệnh `sellbird`. README chỉ ghi lệnh bật môi trường ảo kiểu macOS/Linux (`source .venv/bin/activate`). Nếu bạn dùng Windows, README chưa ghi lệnh tương ứng. Bạn có thể dùng Cách 1 để Claude xử lý, hoặc xem thêm trong thư mục docs/ và phần Troubleshooting của repo.

Bước 2 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 file `.env` thật rồi mở ra để sửa. File `.env.example` liệt kê các biến, chia theo nhóm: Gmail (`GMAIL_CLIENT_ID`, `GMAIL_CLIENT_SECRET`), SMTP/IMAP (`SMTP_HOST`, `SMTP_USERNAME`, `IMAP_HOST`…), Microsoft 365 (`M365_CLIENT_ID`, `M365_TENANT_ID`), các dịch vụ kiểm tra email như Reoon, ZeroBounce, Hunter, và vài dịch vụ khác. Bạn chỉ điền phần mình dùng. Mỗi biến đều có chú thích ngay trong file. Chỗ người mới hay vấp: `.env` chứa mật khẩu và khoá, đừng gửi hay đưa nó lên chỗ công khai.

Bước 3 là 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ủa bạn. Sellbird đọc trang web để hiểu bạn bán gì rồi ghi kết quả vào `sellbird.local.yaml`. File này là của bạn, git không đụng tới.

Bước 4 là xác nhận thế nào là khách tiềm năng tốt:

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

Bước 5 là tìm doanh nghiệp. Nguồn mặc định miễn phí và 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 6 là mở dashboard 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 chính máy bạn. Mở đường dẫn đó trong trình duyệt. `sellbird run` khởi động vòng lặp chính. Lệnh này chạy liên tục, nên hãy mở thêm một cửa sổ terminal nếu cần dùng lệnh khác.

Ghi chú: README nói thêm rằng trên Linux bạn có thể chạy bằng Docker. Repo có sẵn `Dockerfile` và `docker-compose.yml`, và tài liệu Docker nằm trong thư mục docs/. README không ghi chi tiết lệnh Docker ở phần Quick start nên mình không chép ở đây.

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

Khi chạy `sellbird run`, README cho thấy kết quả mẫu trông như thế này: dòng "Sellbird is online", rồi "Checking pipeline state...", một dòng "Decision" cho biết bước tiếp theo (ví dụ viết chiến dịch cho các prospect mới), các dòng cho biết agent nào đang làm gì (viết thư, xử lý thư trả lời), số email đang chờ bạn duyệt, và cuối cùng là "Cycle complete. Sleeping for 15 minutes." Nghĩa là Sellbird chạy theo từng chu kỳ, nghỉ 15 phút rồi lặp lại.

Bạn còn có thể kiểm tra theo các dấu hiệu này:

- Gõ `sellbird dashboard` và mở được đường dẫn tới `http://127.0.0.1:5555`.
- Sau `sellbird discover`, trên dashboard có danh sách công ty.
- Sau một chu kỳ `sellbird run`, có email nằm trong mục Outbox chờ bạn duyệt. Nếu thấy chúng ở đó mà chưa bị gửi đi, hệ thống đang hoạt động đúng.

README cũng có dữ liệu demo hư cấu (công ty "Bookwell" bán phần mềm đặt lịch cho thợ lợp mái, nha khoa, điện lạnh, trên tên miền `.test`). Đây chỉ để minh hoạ, không phải dữ liệu thật.

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

### Chủ doanh nghiệp nhỏ muốn có danh sách khách để gọi điện

Bạn bán phần mềm hoặc dịch vụ cho một ngành cụ thể và chỉ cần danh sách, chưa muốn gửi mail. Chạy đủ các bước tới kiểm tra email, rồi xuất file:

```bash
sellbird train https://website-cua-ban.com
sellbird signals --confirm free
sellbird discover
sellbird export
```

Kết quả là một file CSV các công ty, người quyết định và email đã gắn nhãn verified, risky, guess hoặc invalid, sẵn sàng đưa vào công cụ gửi mail hoặc CRM của bạn. README chưa nói rõ độ phủ dữ liệu OpenStreetMap ở Việt Nam, nên hãy chạy thử với một ngành nhỏ trước khi kỳ vọng nhiều.

### Nhân viên sale muốn gửi chuỗi email có duyệt tay

Bạn đã có hộp thư Google Workspace trên tên miền riêng và đã warmup. Sau khi điền `.env` và `train`, chạy `sellbird run`, rồi mở dashboard. Mỗi email chờ trong Outbox để bạn đọc, sửa và duyệt. Sellbird viết chuỗi ngắn dựa trên điều nó tìm được ở từng công ty, ví dụ "công ty đang tuyển nhân viên điều phối".

> Mặc định không email nào rời máy bạn khi bạn chưa duyệt.
>
> — Ông T

Trước khi thư rời đi còn có một bước kiểm tra không dùng mô hình: loại thư còn sót thẻ merge 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. Bạn duyệt thêm một lớp nữa, nên rủi ro gửi nhầm giảm đáng kể.

### Chủ shop muốn xử lý thư trả lời nhanh hơn

Khi có người trả lời, Sellbird đọc, phân loại (ví dụ quan tâm hoặc phản đối), soạn sẵn câu đáp và đặt thư tự động ra riêng. Ai từ chối nhận thư thì được tôn trọng ngay. Những thư nó không nên tự trả lời sẽ được chuyển cho bạn. Bạn mở dashboard, xem câu trả lời nháp, chỉnh nếu cần rồi duyệt. Người bận rộn đỡ phải đọc từng thư từ đầu.

### Lập trình viên muốn tuỳ biến

Nếu bạn quen code, trong repo có các thư mục `prompts/` và `skills/` chứa các kịch bản bán hàng mà README nói là bạn có thể chỉnh sửa, cùng tài liệu về Extensions để thêm route, bước heartbeat hoặc lệnh mới từ một gói riêng. Cấu hình nằm trong `sellbird.yaml`, còn thiết lập cá nhân của bạn nên để trong `sellbird.local.yaml`.

Khi cần dừng khẩn cấp, chạy:

```bash
sellbird sending pause
```

Theo README, lệnh này dừng mọi việc gửi thư ngay lập tức.

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

### Báo sai phiên bản Python hoặc cài lỗi

Sellbird cần Python 3.11 trở lên. Nếu `python3 --version` hiện 3.9 (thường gặp trên macOS), hãy cài bản mới theo README (`brew install python@3.13`) rồi dùng `python3.13` để tạo môi trường ảo, thay vì gõ `python3` trần.

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

Thường là do bạn chưa bật môi trường ảo hoặc chưa chạy `pip install -e .`. Mở terminal mới trong thư mục dự án, bật lại môi trường ảo rồi thử lại.

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

Sellbird nghĩ qua Claude Code CLI, nên CLI phải đăng nhập sẵn bằng `claude login`. Nếu bạn dùng gói ChatGPT thì phải làm theo hướng dẫn Codex trong thư mục docs/ của repo.

### Chạy rồi mà không thấy email nào gửi đi

Đây là hành vi bình thường. Email phải nằm ở Outbox chờ bạn duyệt, trừ khi bạn tự bật autopilot. Mở dashboard, vào Outbox để duyệt. Cũng nên nhớ gửi mail còn bị giới hạn theo số lượng mỗi ngày và giờ làm việc của người nhận.

### `git pull` báo "your local changes would be overwritten"

Lỗi này gặp khi bạn từng sửa trực tiếp file `harvey.yaml` của bản cũ. README hướng dẫn chạy lần lượt `git stash`, `git pull`, `git stash pop`. Nếu có xung đột thì 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 thiết lập vào `sellbird.local.yaml`, vì git không bao giờ đụng tới file này. Nếu bạn đang dùng Harvey cũ, hãy dừng tiến trình Harvey trước khi nâng cấp.

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

**Điểm mạnh.** Chạy trên máy bạn, dữ liệu nằm trong thư mục của bạn. Không phải trả tiền API mô hình vì dùng gói thuê bao sẵn có. Mặc định cần duyệt tay, có bước kiểm tra trước khi gửi, có lệnh dừng khẩn cấp. Nguồn tìm doanh nghiệp mặc định miễn phí, và mọi lần tìm trả phí đều báo giá trước. Dự án vẫn được cập nhật trong vài tháng gần đây và có tài liệu khá đầy đủ.

**Giới hạn.** Bạn cần tự lo hộp thư gửi, tên miền riêng và warmup. Đây là phần tốn công và có thể tốn tiền. Cài bằng dòng lệnh, nên hơi khó với người chưa từng dùng terminal. README chưa hướng dẫn riêng cho Windows ở phần Quick start. Chất lượng dữ liệu ở thị trường Việt Nam chưa được tư liệu nói tới. Giấy phép là AGPL-3.0, bạn nên đọc kỹ nếu định dùng mã nguồn vào sản phẩm thương mại. README cũng cho biết các bản Harvey cũ tới 0.3.x dùng giấy phép MIT.

**Khi nào 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 chạy sẵn trên sellbird.ai (đang ở giai đoạn truy cập sớm, đã 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 chục thư thủ công mỗi tuần thì công cụ này có thể là quá tay. Và dù dùng cách nào, hãy kiểm tra quy định về email quảng cáo áp dụng cho thị trường của bạn trước khi gửi.

## 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 (OpenStreetMap) và bước đọc website đều không tốn tiền. Bạn vẫn cần gói Claude Pro/Max hoặc ChatGPT có Codex, một hộp thư để gửi (README nêu khoảng 7 USD một tháng cho Google Workspace), và nguồn tìm trả phí nếu bạn chọn dùng.

### Có cần API key của Claude hay OpenAI không?

Không. Theo README, Sellbird nghĩ qua Claude Code CLI trên gói Claude Pro/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ư kiểm tra email có biến khoá riêng trong file .env.example, nhưng bạn chỉ cần điền khi dùng.

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

Tư liệu không nhắc tới yêu cầu GPU. Phần suy luận chạy qua Claude hoặc Codex nên không có dấu hiệu cần phần cứng đặc biệt. Yêu cầu được ghi rõ là Python 3.11 trở lên.

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

README có nêu thư mục dữ liệu cho Windows (%APPDATA%\sellbird), nhưng phần Quick start chỉ ghi lệnh kiểu macOS/Linux và chỉ nói Docker dùng được trên Linux. README chưa ghi lệnh kích hoạt môi trường ảo cho Windows. Bạn có thể dùng cách để Claude Code cài hộ, hoặc xem thư mục docs/ và phần Troubleshooting trong repo.

### Sellbird có tự gửi email mà tôi không kiểm soát không?

Mặc định là không. Mỗi email nằm trong Outbox chờ bạn duyệt cho tới 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 việc gửi ngay lập tức.

### Dữ liệu của tôi lưu ở đâu?

Sellbird chạy trên máy của bạn. Cấu hình, tri thức và dữ liệu nằm trong một thư mục home (thư mục dự án nếu bạn clone, hoặc thư mục dữ liệu người dùng nếu cài bằng pip). Cơ sở dữ liệu, log và token dashboard nằm trong thư mục data/. README không nói gì thêm về việc gửi dữ liệu ra ngoài ngoài các dịch vụ bạn tự cấu hình.

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

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 đều được giữ lại. Bạn chạy git pull, pip install -e . một lần để có lệnh sellbird mới, rồi sellbird dashboard. Lần chạy đầu Sellbird tự đổi tên các file harvey.* sang sellbird.*.
