Sellbird: tự 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
Bài này là một góc nhìn khác về ethanplusai/sellbird — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: 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 →

Tóm tắt nhanh
Sellbird (trước đây tên Harvey) là ứng dụng Python mã nguồn mở giúp làm outreach: tìm công ty hợp với khách hàng của bạn, tìm người quyết định, xác minh email, viết cold email và xử lý thư trả lời. Nó dùng Claude Code CLI (gói Pro/Max) hoặc Codex (gói ChatGPT) nên không cần API key của mô hình. Cài đặt gồm vài lệnh, hoặc bạn có thể để Claude Code tự hướng dẫn cài.
Sellbird là một nền tảng outreach mã nguồn mở, chạy ngay trên máy của bạn. Nó làm cả chuỗi việc của người bán hàng B2B: tìm công ty cần thứ bạn bán, 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ý phản hồi. Tên cũ của dự án là Harvey.
Điểm đáng giá nhất: Sellbird “suy nghĩ” qua Claude Code CLI trên gói Claude Pro/Max bạn đang có, hoặc qua Codex trên gói ChatGPT. Bạn không cần API key của mô hình và không bị tính tiền theo token. Thêm nữa, mặc định không có email nào được gửi đi nếu bạn chưa duyệt.
Bạn nên đọc bài này nếu bạn làm kinh doanh, sales, hoặc là lập trình viên mới và muốn tự động hoá việc tìm khách. Hiện repo có khoảng 5.250 sao và 1.127 fork, giấy phép AGPL-3.0. Xem video ngắn bên dưới để thấy nó chạy, rồi quay lại làm theo từng bước.
ethanplusai/sellbird
Sellbird là 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 thư cá nhân hoá, gửi và xử lý phản hồi.
I.Sellbird làm được gì
Sellbird là một dây chuyền. Bạn có thể chạy hết từ đầu đến cuối, hoặc dừng ở bước nào cũng được.
- 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í. 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ờ.
- Tìm lý do họ sẽ mua. Nó đọ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, 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 gì (theo README, 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 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. Nó học cách đặt email của công ty và xác minh một địa chỉ. Mỗi địa chỉ được đánh dấu verified, risky, guess hoặc invalid. Chỉ địa chỉ gửi được mới được dùng để gửi.
- 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 đó gửi từ hộp thư Gmail, Microsoft 365 hoặc SMTP của bạn, trong giới hạn gửi mỗi ngày và giờ làm việc của người nhận.
- Xử lý phản hồi. Nó đọc mọi thư trả lời, soạn sẵn câu trả lời, gạt thư tự động sang một bên, tôn trọng yêu cầu từ chối nhận thư ngay lập tức, và giao lại 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 rồi chạy sellbird export để có file CSV dùng được cho công cụ gửi thư khác.
Một điểm an toàn nữa: mọi email đi ra đều nằm trong Outbox chờ bạn duyệt, cho đến khi chính bạn bật autopilot. Trước khi gửi còn có bước kiểm tra không dùng mô hình, loại các thư còn sót merge tag chưa điền, cụm từ bị cấm, thư quá dài, thừa link hoặc địa chỉ không gửi được.
II.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. Trên macOS, máy thường có sẵn Python 3.9, nên nếu
python3 --versionbáo 3.9 thì chạybrew install python@3.13trước. - Một trong hai gói: Claude Pro hoặc Max với CLI đã đăng nhập (
claude login), hoặc gói ChatGPT kèm 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 (làm nóng) hộp thư. README gợi ý TrulyInbox, và Sellbird đọc tỷ lệ vào inbox từ đó để báo khi nào bạn 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ề chi phí, README nêu: tìm doanh nghiệp là 0 đô trên nguồn mặc định, hoặc khoảng 0,37 đô cho 1.000 kết quả trên nguồn trả phí rẻ nhất. Đọc website là 0 đô. Hộp thư Google Workspace khoảng 7 đô một tháng. Không cần Apollo, ZoomInfo, Clearbit hay Clay.
README không nói riêng về phần cứng. Máy cần đủ để chạy Python và Claude/Codex CLI. README cũng nói Docker dùng được trên Linux.
Cold email là việc nhạy cảm: gửi sai cách có thể làm hỏng tên miền gửi của bạn và vướng quy định pháp lý. Hãy dùng tên miền gửi riêng, warmup hộp thư và đọc tài liệu “Legal and deliverability” trong thư mục docs/ của repo trước khi bật gửi thật.
III.Cài đặt từng bước
- Tải repoClone mã nguồn về máy và vào thư mục
- Cài đặtTạo môi trường ảo và cài gói sellbird
- Điền khoáSao chép .env.example thành .env và điền thông tin
- Dạy sản phẩmCho Sellbird đọc website của bạn
- Tìm kháchXác nhận tín hiệu và chạy discover
- ChạyMở dashboard và bắt đầu vòng lặp
A.Cách nhanh: để Claude Code cài giúp
README có sẵn cách dễ nhất cho người mới. Bạn mở terminal (Terminal trên macOS/Linux, PowerShell hoặc Git Bash trên Windows), rồi chạy:
git clone https://github.com/ethanplusai/sellbird.git
cd sellbird
claudeSau khi Claude Code mở, bạn gõ “set up Sellbird for me”. 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 phần 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. Nếu bạn thấy rối với các bước dưới, cứ dùng cách này.
B.Tải repo về máy
Nếu muốn tự làm, bước đầu vẫn là clone repo và đi vào thư mục. Điều hay vấp: bạn phải đứng trong thư mục sellbird thì các lệnh sau mới chạy đúng.
git clone https://github.com/ethanplusai/sellbird.git
cd sellbirdC.Cài đặt gói
Lệnh dưới tạo môi trường ảo .venv, kích hoạt nó rồi cài Sellbird. README dặn dùng python3.13 chứ không dùng python3 trần, vì trên macOS python3 có thể là bản 3.9 quá cũ.
python3.13 -m venv .venv && source .venv/bin/activate && pip install -e .Lệnh source .venv/bin/activate là cú pháp cho macOS/Linux. README chưa ghi lệnh kích hoạt riêng cho Windows. Nếu bạn dùng Windows, cách đơn giản nhất là làm theo cách “để Claude Code cài” ở trên, hoặc xem thư mục docs/ trong repo (có Docker và Troubleshooting).
D.Điền thông tin đăng nhập
Sao chép file mẫu thành .env rồi mở ra sửa. README nói mọi biến đều có chú thích ngay trong file.
cp .env.example .env && $EDITOR .envTrong file mẫu có các nhóm biến như Gmail (GMAIL_CLIENT_ID, GMAIL_CLIENT_SECRET), SMTP/IMAP, Microsoft 365, và các dịch vụ kiểm tra email như Reoon, ZeroBounce, Hunter. Bạn chỉ điền phần mình dùng, không cần điền hết. Chỗ hay vấp: file .env chứa mật khẩu và khoá, tuyệt đối không đưa lên GitHub hay gửi cho người khác.
E.Dạy Sellbird về sản phẩm của bạn
Lệnh dưới cho Sellbird đọc website công ty bạn và ghi kết quả vào file sellbird.local.yaml. Hãy thay địa chỉ bằng website thật của bạn.
sellbird train https://your-company.comF.Xác nhận tín hiệu và tìm doanh nghiệp
Lệnh đầu xác nhận thế nào là một khách hàng tốt. Lệnh sau tìm doanh nghiệp; nguồn mặc định miễn phí và không cần tài khoản.
sellbird signals --confirm free
sellbird discoverG.Mở dashboard và chạy
Dashboard in ra một đường link riêng tư tới http://127.0.0.1:5555, tức là chỉ mở được trên chính máy bạn. Sau đó bạn bật vòng lặp chạy.
sellbird dashboard
sellbird runNếu bạn dùng Linux, README nói bạn có thể chạy bằng Docker. Repo có sẵn Dockerfile và docker-compose.yml, chi tiết xem tài liệu Docker trong docs/.
IV.Kiểm tra đã chạy được chưa
Cách kiểm tra đơn giản nhất là chạy sellbird run. README cho thấy màn hình thành công có dạng như sau:
Sellbird is online.
Checking pipeline state...
Decision: write_campaign (3 new prospects with no drafts)
...
outbox → 5 emails waiting for your approval
Cycle complete. Sleeping for 15 minutes.Nghĩa là nó đã kiểm tra trạng thái, soạn thư và để chúng chờ trong Outbox. Sau đó nó nghỉ 15 phút rồi lặp lại. Bạn cũng nên mở link dashboard mà sellbird dashboard in ra và xem Outbox có thư nào chờ duyệt không. Nếu thấy, nghĩa là mọi thứ đã thông.
Sẽ có dữ liệu demo hư cấu trong README (công ty “Bookwell” bán phần mềm đặt lịch cho thợ lợp mái, nha khoa, điều hoà). Đừng nhầm đó là kết quả thật của bạn.
V.Dùng vào việc thật
A.Chủ doanh nghiệp dịch vụ nhỏ cần danh sách khách
Bạn bán phần mềm đặt lịch hoặc dịch vụ cho các cửa hàng địa phương, và chưa muốn gửi thư ngay. Bạn chỉ cần một danh sách để gọi điện hoặc nhập vào công cụ khác. Cách làm: chạy sellbird train với website của bạn, sellbird signals --confirm free, rồi sellbird discover. Cuối cùng chạy:
sellbird exportKết quả là một file CSV với các công ty, người quyết định và địa chỉ đã được đánh dấu verified, risky, guess hoặc invalid, sẵn sàng đưa vào công cụ gửi thư. Bạn nên ưu tiên các địa chỉ verified.
B.Chạy cả chuỗi nhưng vẫn kiểm soát từng thư
Bạn là nhân viên kinh doanh muốn tiết kiệm thời gian viết thư. Sau khi cài xong và nối hộp thư, bạn chạy sellbird run và mở dashboard. Sellbird viết chuỗi email dựa trên tín hiệu tìm được, chẳng hạn một công ty đang tuyển người điều phối. Thư xuất hiện trong Outbox.
Không có email nào rời máy bạn nếu bạn chưa bấm duyệt.
Ông T
Bạn đọc từng thư, sửa nếu cần rồi mới duyệt. Khi đã tin tưởng, bạn mới tự bật autopilot. Ngay cả khi đó, Sellbird vẫn giữ lại thư có link tới tên miền không phải của bạn.
C.Xử lý thư trả lời mà không bị ngập
Sau vài ngày gửi, hộp thư bắt đầu có người hỏi giá, người từ chối, người tự động trả lời vắng mặt. 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, gạt thư tự động sang một bên và tôn trọng yêu cầu từ chối ngay. Việc của bạn là mở dashboard, xem những thư nó giao lại và quyết định. Kết quả: bạn chỉ tập trung vào những người thật sự quan tâm.
D.Dev muốn chỉnh theo cách bán của mình
Nếu bạn là lập trình viên, hãy xem thư mục prompts/ và skills/. README nói đây là các kịch bản bán hàng có thể sửa, và bản cài bằng pip sẽ không ghi đè chỉnh sửa của bạn khi nâng cấp. Bạn sửa giọng văn, quy tắc viết thư, rồi chạy lại để xem kết quả khác thế nào. Dự án cũng có tài liệu về Extensions để thêm route, bước heartbeat và lệnh từ một gói riêng.
VI.Lỗi hay gặp và cách xử lý
python3 --versionbáo 3.9 hoặc thấp hơn 3.11. Cài Python mới hơn (README gợi ýbrew install python@3.13trên macOS) và tạo môi trường ảo bằngpython3.13, không dùngpython3trần.- Lệnh
sellbirdkhông được nhận ra. Rất có thể bạn chưa kích hoạt môi trường ảo hoặc chưa chạypip install -e .trong thư mục repo. Kích hoạt lại.venvrồi cài lại. - Claude hoặc Codex chưa đăng nhập. Sellbird cần Claude Code CLI đã đăng nhập (
claude login) hoặc Codex CLI. Hãy đăng nhập trước khi chạy. - Thư không được gửi dù đã chạy. Đây thường là chủ ý: mặc định mọi thư chờ trong Outbox cho đến khi bạn duyệt. Ngoài ra bước kiểm tra trước khi gửi có thể loại thư vì còn merge tag chưa điền, quá dài hoặc địa chỉ không gửi được. Hãy xem lý do trong dashboard.
- Muốn dừng ngay mọi thứ. Chạy
sellbird sending pauseđể dừng toàn bộ việc gửi. - Nâng cấp từ Harvey bị báo “your local changes would be overwritten”. Làm theo README:
git stash,git pull, rồigit stash pop. Nếu có xung đột, giữ các dòng của bạn và xoá dấu xung đột. Tốt hơn là đặt cài đặt riêng vàosellbird.local.yaml, file mà git không đụng tới.
Với các lỗi khác, README trỏ tới tài liệu Troubleshooting trong thư mục docs/.
VII.Có nên dùng không
Điểm mạnh. Bạn chạy được cả chuỗi tìm khách đến trả lời thư mà không cần API key mô hình và không trả phí theo token. Dữ liệu và cấu hình nằm trên máy bạn. Mặc định phải duyệt thủ công, có bước kiểm tra trước khi gửi, và có nút dừng khẩn cấp. Bạn có thể dừng ở bước xuất danh sách nếu chưa muốn gửi.
Giới hạn. Bạn vẫn cần một hộp thư gửi, tên miền riêng và warmup, và README khuyên bạn tự làm những việc này. Nguồn dữ liệu mặc định là OpenStreetMap nên độ phủ phụ thuộc vào ngành và khu vực của bạn. README chưa nói gì về độ phủ ở Việt Nam, bạn nên thử với một nhóm nhỏ trước. Dự án mới đổi tên từ Harvey, và giấy phép là AGPL-3.0, nên hãy đọc kỹ nếu định dùng hoặc sửa nó cho 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 tự vận hành, tác giả có bản hosted ở trang chủ sellbird.ai (đang ở giai đoạn early access, 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 gửi thư hàng loạt đơn giản, một công cụ gửi thư thông thường có thể đủ. Cuối cùng, hãy luôn đọc phần pháp lý trong docs/ trước khi gửi cold email thật.
Câu hỏi thường gặp
Sellbird có miễn phí không?
Bản mã nguồn mở miễn phí, giấy phép AGPL-3.0. Tuy nhiên bạn cần gói Claude Pro/Max hoặc gói ChatGPT kèm Codex, cùng một hộp thư gửi (README nêu Google Workspace khoảng 7 đô một tháng). Nguồn tìm doanh nghiệp mặc định là miễn phí.
Sellbird có cần API key của Claude hay OpenAI không?
Không. Theo README, Sellbird dùng Claude Code CLI trên gói 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ụ phụ như kiểm tra email có biến API key riêng trong .env.example.
Có cần GPU hay máy cấu hình mạnh không?
README không nêu yêu cầu GPU hay phần cứng. Phần suy nghĩ chạy qua Claude hoặc Codex, bạn chỉ cần Python 3.11 trở lên và máy chạy được các CLI đó.
Sellbird có chạy được trên Windows không?
README có nêu thư mục dữ liệu trên Windows (%APPDATA%\sellbird), nhưng các lệnh cài đặt trong README viết cho macOS/Linux và Docker được nói là dùng trên Linux. README chưa có hướng dẫn cài riêng cho Windows; bạn có thể nhờ Claude Code cài giúp hoặc xem thư mục docs/.
Sellbird có tự gửi email mà tôi không biết không?
Không. Mặc định mọi email nằm trong Outbox chờ bạn duyệt cho đến khi chính bạn bật autopilot. Có thêm bước kiểm tra trước khi gửi, và lệnh sellbird sending pause để dừng ngay mọi việc gửi.
Dữ liệu của tôi có an toàn không?
README nói Sellbird chạy trên máy của bạn, và cấu hình, dữ liệu nằm trong một thư mục home riêng. Dashboard mở ở địa chỉ 127.0.0.1. Chi tiết bảo mật khác chưa có trong tư liệu; nếu phát hiện lỗ hổng, repo yêu cầu làm theo SECURITY.md.
Tôi đang dùng Harvey thì nâng cấp thế nào?
Harvey đã đổ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 giữ lại. Bạn chạy git pull, pip install -e . rồi sellbird dashboard. Lệnh harvey cũ vẫn chạy tạm thời nhưng sẽ bị bỏ ở bản sau.


