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à 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, xác minh email, viết và gửi cold email rồi xử lý thư trả lời. Nó dùng Claude Code CLI hoặc Codex nên không cần API key của mô hình. Cài bằng vài lệnh, mặc định không email nào được gửi khi bạn chưa duyệt.
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 qua email lạnh (cold email). Nó tìm công ty hợp với khách hàng của bạn, tìm người quyết định, kiểm tra địa chỉ email, viết thư riêng cho từng người, gửi đi rồi xử lý thư trả lời. Trước đây dự án tên là Harvey, nay đã đổi tên thành Sellbird.
Bạn nên xem qua nếu bạn bán dịch vụ cho doanh nghiệp nhỏ (phòng khám, tiệm sửa chữa, công ty xây dựng…) và đang tốn nhiều giờ lập danh sách khách, viết thư tay. Dev mới cũng dùng được, vì repo có sẵn hướng dẫn để Claude Code dẫn bạn cài từng bước. 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 là hai thứ. Thứ nhất, Sellbird dùng gói Claude Pro/Max (qua Claude Code CLI) hoặc gói ChatGPT (qua Codex) bạn đang trả, nên không có hoá đơn API theo từng token. Thứ hai, mặc định không có email nào rời máy bạn khi bạn chưa bấm duyệt. Bạn có thể xem video ngắn bên dưới để thấy nó chạy ra sao, rồi quay lại đọc phần cài đặt.
ethanplusai/sellbird
Sellbird tìm công ty và người ra quyết định, kiểm tra email, viết và gửi cold email cá nhân hoá, chạy trên gói Claude hoặc ChatGPT bạn đang có.
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.
A.Tìm công ty phù hợp
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. Nếu bạn chọn nguồn trả phí, mỗi lần tìm đều hiện chi phí trước khi chạy, nên không lo bị trừ tiền bất ngờ.
B.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 mà 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.
Lợi ích thực tế: thư của bạn có lý do để gửi, thay vì thư đại trà "xin chào, bên mình có dịch vụ".
C.Tìm người quyết định
Nó tìm chủ hoặc quản lý được nêu tên ngay trên trang của công ty, tối đa hai người cho mỗi công ty. Bạn không phải mua thêm công cụ tìm kiếm liên hệ. README nói rõ không cần Apollo, ZoomInfo, Clearbit hay Clay.
D.Kiểm tra địa chỉ email
Sellbird học cấu trúc email của công ty rồi xác minh một địa chỉ. Mỗi địa chỉ được gắn nhãn: đã xác minh, rủi ro, đoán, hoặc không hợp lệ. Chỉ địa chỉ có thể nhận thư mới được gửi tới. Việc này giúp bạn tránh gửi vào địa chỉ chết, thứ làm hỏng uy tín tên miền gửi thư.
E.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, rồi gửi từ hộp thư Gmail, Microsoft 365 hoặc SMTP của bạn. Việc gửi nằm trong giới hạn mỗi ngày và theo giờ làm việc của người nhận.
F.Xử lý thư trả lời
Sellbird đọc mọi thư trả lời và soạn sẵn câu đáp. Thư tự động trả lời được đặt riêng ra. Yêu cầu từ chối nhận thư được thực hiện ngay. Trường hợp nó không nên tự trả lời, nó chuyển cho bạn.
G.Chỉ muốn lấy danh sách?
Dừng sau bước xác minh và chạy sellbird export để có file CSV sẵn sàng đưa vào công cụ gửi thư khá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
>=3.11. README lưu ý macOS đi kèm Python 3.9, nên nếupython3 --versionbáo 3.9 thì chạybrew install python@3.13trước. - Claude Pro hoặc Max, đã đăng nhập Claude Code CLI bằng
claude login. Hoặc một gói ChatGPT có Codex CLI (repo có hướng dẫn riêng cho Codex). - Một hộp thư để gửi đi. README khuyên dùng Google Workspace trên một tên miền gửi thư riêng. Microsoft 365 và SMTP cũng chạy được.
- Warmup (làm nóng) hộp thư đó. README giới thiệu TrulyInbox cho việc này; Sellbird đọc tỉ lệ vào hộp thư chính của nó để báo bạn khi nào sẵn sàng. Lưu ý: link TrulyInbox trong dự án là link affiliate, người duy trì dự án có thể nhận hoa hồng.
Về chi phí, README liệt kê: 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.
File .env.example còn liệt kê nhiều biến tuỳ chọn (Gmail, SMTP, IMAP, Microsoft 365, Instantly, Hunter, ZeroBounce, Reoon, TrulyInbox…). Bạn chỉ điền những gì mình thực sự dùng.
Về hệ điều hành: README viết các lệnh cho macOS/Linux và nói Docker chạy được trên Linux. Phần thư mục dữ liệu có nhắc cả Windows (%APPDATA%\sellbird), nhưng README chưa ghi riêng các bước cài trên Windows.
III.Cài đặt từng bước
- Tải mã nguồnClone repo về máy rồi vào thư mục sellbird
- Cài đặtTạo môi trường ảo Python 3.13 và cài gói bằng pip
- Điền thông tinSao chép .env.example thành .env rồi điền credentials
- Dạy SellbirdCho nó đọc website của bạn và xác nhận tín hiệu khách hàng tốt
- Tìm kháchChạy discover để tìm doanh nghiệp
- ChạyMở dashboard và bật vòng lặp chính
README cho hai cách: để Claude cài giúp, hoặc tự làm. Người mới nên thử cách thứ nhất trước.
A.Cách 1: để Claude Code cài giúp
Mở terminal (Terminal trên macOS, hoặc cửa sổ dòng lệnh bạn quen dùng) và chạy:
git clone https://github.com/ethanplusai/sellbird.git
cd sellbird
claudeLệnh đầu tải mã nguồn về. Lệnh thứ hai đi vào thư mục vừa tải. Lệnh claude mở Claude Code ngay trong thư mục đó. Điều quan trọng: phải chạy claude bên trong thư mục sellbird, vì file CLAUDE.md của repo mới được nạp.
Khi Claude Code mở, bạn gõ:
set up Sellbird for meTheo README, CLAUDE.md biến Claude Code thành người hướng dẫn: nó kiểm tra bạn đang ở đâu, cài những thứ 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.Cách 2: tự cài, bước 1 — tạo môi trường và cài gói
Sau khi đã git clone và cd sellbird như trên, chạy:
python3.13 -m venv .venv && source .venv/bin/activate && pip install -e .Lệnh này tạo môi trường ảo tên .venv, kích hoạt nó, rồi cài Sellbird ở chế độ chỉnh sửa được. README nhấn mạnh dùng python3.13 chứ không dùng python3, vì trên macOS python3 trần là bản 3.9 và sẽ không đáp ứng yêu cầu. Dòng source .venv/bin/activate là cú pháp macOS/Linux. README chưa ghi lệnh kích hoạt cho Windows, bạn nên xem thêm trong thư mục docs/ của repo.
C.Bước 2 — thêm thông tin đăng nhập
cp .env.example .env && $EDITOR .envLệnh đầu sao chép file mẫu thành .env. Lệnh sau mở file đó để sửa ($EDITOR là trình soạn thảo mặc định của máy bạn). README nói mỗi biến đều có giải thích ngay trong file. Chỗ người mới hay vấp: bạn chỉ cần điền phần của hộp thư mình dùng, ví dụ nhóm SMTP nếu bạn gửi qua SMTP. Đừng chia sẻ file .env cho ai.
D.Bước 3 — dạy Sellbird về sản phẩm
sellbird train https://your-company.comThay địa chỉ bằng website công ty bạn. Sellbird đọc trang đó để hiểu bạn bán gì, rồi ghi kết quả vào file sellbird.local.yaml.
E.Bước 4 — xác nhận thế nào là khách tốt
sellbird signals --confirm freeBước này chốt các tín hiệu cho thấy một doanh nghiệp đáng tiếp cận. Dùng đúng cờ --confirm free như README.
F.Bước 5 — tìm doanh nghiệp
sellbird discoverNguồn mặc định miễn phí và không cần tài khoản.
G.Bước 6 — mở dashboard và chạy
sellbird dashboard # prints a private link to http://127.0.0.1:5555
sellbird runsellbird dashboard in ra một đường link riêng tới địa chỉ trên máy bạn (127.0.0.1:5555). Đây là nơi bạn xem và duyệt email. sellbird run bật vòng lặp chính. Nên mở dashboard trước để thấy Outbox khi nó bắt đầu có thư chờ duyệt.
Mặc định mọi email nằm chờ trong Outbox cho đến khi bạn duyệt. Đừng bật autopilot khi chưa kiểm tra kỹ nội dung và chưa warmup xong hộp thư. Cần dừng khẩn cấp thì chạy sellbird sending pause.
Ngoài ra, trên Linux bạn có thể chạy bằng Docker. Repo có sẵn Dockerfile và docker-compose.yml, chi tiết xem trong thư mục docs/.
IV.Kiểm tra đã chạy được chưa
Sau sellbird run, bạn sẽ thấy dòng thông báo tương tự ví dụ trong README:
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.Những dấu hiệu cho thấy ổn:
- Terminal hiện "Sellbird is online" và kết thúc một chu kỳ rồi chờ 15 phút cho vòng sau.
- Dòng
outboxcho biết có bao nhiêu email đang chờ bạn duyệt. - Mở link do
sellbird dashboardin ra, bạn thấy giao diện và các email chờ duyệt.
Số liệu trong ví dụ là dữ liệu mẫu, của công ty giả "Bookwell" bán phần mềm đặt lịch cho thợ lợp mái, phòng nha và tiệm điều hoà, chạy trên tên miền .test. Dữ liệu thật của bạn sẽ khác.
V.Dùng vào việc thật
Bám theo những gì README mô tả, dưới đây là vài tình huống thực tế.
A.Chủ công ty phần mềm tìm khách là phòng khám
Bạn bán phần mềm đặt lịch hẹn và muốn tiếp cận các phòng khám nha khoa. Bạn chạy sellbird train với website của mình, xác nhận tín hiệu "chưa có đặt lịch online", rồi sellbird discover. Sellbird tìm các phòng khám, đọc website của họ để xem có tín hiệu đó không, tìm tên chủ phòng khám và kiểm tra email. Kết quả là một danh sách khách có lý do rõ ràng để liên hệ, và một chuỗi email ngắn riêng cho từng người.
Công cụ này không thay bạn quyết định gửi gì, nó thay bạn làm phần việc nhàm chán trước khi bạn bấm duyệt.
Ông T
B.Nhân viên sales chỉ cần danh sách
Công ty bạn đã có phần mềm gửi email riêng và chỉ thiếu danh sách khách đã kiểm tra. Bạn dừng pipeline sau bước xác minh rồi chạy:
sellbird exportBạn nhận file CSV sẵn sàng đưa vào công cụ gửi thư. Phù hợp khi bạn không muốn Sellbird tự gửi.
C.Duyệt thư và xử lý trả lời mỗi buổi sáng
Bạn để sellbird run chạy, rồi mỗi sáng mở dashboard. Trong Outbox có các email chờ duyệt; bạn đọc, sửa nếu cần rồi cho gửi. Khi có người trả lời, Sellbird đã soạn sẵn câu đáp cho trường hợp quan tâm hoặc phản đối, đồng thời tách riêng thư tự động trả lời. Nếu có việc gấp hoặc thấy có gì lạ, bạn chạy sellbird sending pause để dừng mọi việc gửi.
Trước khi gửi, một bước kiểm tra không dùng mô hình sẽ loại các thư còn sót merge tag chưa điền, chứa cụm từ bị cấm, quá dài, có thừa link hoặc gửi tới địa chỉ không nhận được thư. Nhờ vậy bạn đỡ phải soi từng lỗi nhỏ.
D.Dev tuỳ biến theo ngành của mình
Nếu bạn là lập trình viên, các file prompts/ và skills/ là những kịch bản bán hàng có thể chỉnh sửa. Settings riêng nên đặt trong sellbird.local.yaml, vì git không đụng tới file này khi bạn cập nhật. Repo cũng có tài liệu về Extensions để thêm route, bước trong vòng lặp hoặc lệnh từ một gói riêng.
VI.Lỗi hay gặp và cách xử lý
A.Cài xong nhưng báo sai phiên bản Python
Trên macOS, python3 trần thường là bản 3.9, thấp hơn yêu cầu 3.11. Chạy brew install python@3.13, rồi tạo môi trường ảo bằng python3.13 đúng như README, đừng dùng python3.
B.Gõ sellbird báo không tìm thấy lệnh
Thường là môi trường ảo chưa được kích hoạt trong cửa sổ terminal hiện tại, hoặc bước pip install -e . chưa chạy xong. Mỗi lần mở terminal mới, hãy vào thư mục sellbird và kích hoạt lại .venv. README không có mục riêng cho lỗi này, nên nếu vẫn lỗi hãy xem tài liệu Troubleshooting trong docs/.
C.Claude Code chưa đăng nhập
Sellbird dựa vào Claude Code CLI đã đăng nhập. Nếu bạn chưa đăng nhập, hãy chạy claude login. Nếu dùng ChatGPT thì làm theo hướng dẫn Codex trong docs/.
D.git pull báo thay đổi cục bộ sẽ bị ghi đè (người dùng Harvey cũ)
Lỗi này xảy ra nếu bạn từng sửa trực tiếp file harvey.yaml. README hướng dẫn: chạy git stash, git pull, rồi git stash pop. Git sẽ chuyển các chỉnh sửa của bạn sang sellbird.yaml. Nếu có xung đột, giữ các dòng của bạn, xoá các dấu xung đột, rồi chạy git stash drop. Về lâu dài, hãy để cài đặt trong sellbird.local.yaml.
E.Thư vào spam hoặc tỉ lệ vào hộp thư chính thấp
Đây là rủi ro chung của cold email, không riêng Sellbird. Nguyên nhân thường gặp là hộp thư mới chưa warmup hoặc dùng luôn tên miền chính. Hãy dùng tên miền gửi thư riêng, warmup trước khi gửi, giữ giới hạn gửi mỗi ngày thấp, và đọc tài liệu Legal and deliverability trong repo.
VII.Có nên dùng không
Điểm mạnh. Bạn không phải trả tiền API mô hình riêng, chỉ dùng gói đang có. 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, có bước kiểm tra trước khi gửi và lệnh dừng tức thì. Các bước tìm và đọc website có thể chạy miễn phí. Giấy phép AGPL-3.0, mã mở nên bạn đọc được nó làm gì.
Giới hạn. Cài đặt cần dùng terminal và Python 3.11 trở lên. README chưa có hướng dẫn riêng cho Windows. Nguồn tìm miễn phí là OpenStreetMap, nên độ phủ với doanh nghiệp tại Việt Nam chưa được tư liệu nói tới; mình khuyên bạn thử một đợt nhỏ trước. Cold email còn chịu các quy định pháp lý và yêu cầu về uy tín gửi thư. Bạn cần tự đọc kỹ phần Legal and deliverability và luật nơi người nhận sinh sống. Sellbird cũng dùng hạn mức gói của bạn, dù nó tự giảm tốc để chừa chỗ cho việc của bạn.
Khi nào nên chọn cách khác. Nếu bạn không muốn tự vận hành, dự án có bản hosted tại sellbird.ai (đang trong 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ư cho khách quen, một công cụ email thông thường là đủ. Và nếu bạn mới bắt đầu, hãy chạy thử trên danh sách nhỏ, giữ chế độ duyệt tay, rồi mới tính chuyện tự động hoá.
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. Tìm doanh nghiệp trên nguồn mặc định và đọc website đều là 0 đô. Bạn vẫn cần gói Claude Pro/Max hoặc ChatGPT có 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 trả phí rẻ nhất khoảng 0,37 đô cho 1.000 kết quả.
Có cần API key của Claude hay OpenAI không?
Không. 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ó key và không tính tiền theo token. Một số nguồn tuỳ chọn như xác minh email hay tìm kiếm trả phí có biến API key riêng trong file .env.example, bạn chỉ điền khi dùng.
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 Code hoặc Codex với gói thuê bao của bạn, không chạy mô hình trên máy.
Chạy được trên Windows không?
README viết lệnh cho macOS/Linux và nói Docker chạy trên Linux. Tài liệu có nhắc thư mục dữ liệu trên Windows là %APPDATA%\sellbird, nhưng chưa ghi các bước cài riêng cho Windows. Bạn nên xem thư mục docs/ trong repo trước khi thử.
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 tới khi bạn duyệt, trừ khi bạn tự bật autopilot. Có thêm bước kiểm tra không dùng mô hình trước khi gửi, và lệnh sellbird sending pause để dừng mọi việc gửi ngay.
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. Tư liệu chưa nói chi tiết về bảo mật ngoài việc có file SECURITY.md để báo lỗi bảo mật. Hãy giữ file .env riêng tư. Nội dung bạn xử lý vẫn đi qua Claude hoặc Codex mà bạn dùng.
Tôi đang dùng Harvey, 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, cấu hình và dữ liệ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. Các biến HARVEY_* vẫn đọc được khi chưa đặt biến SELLBIRD_* tương ứng.


