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
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 là Harvey) là nền tảng mã nguồn mở chạy trên máy bạn, dùng để 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ó dùng gói Claude Pro/Max hoặc ChatGPT có Codex nên không cần API key của mô hình. Cài bằng Python 3.11 trở lên với vài lệnh, hoặc nhờ Claude Code cài giúp. Mặc định không email nào được gửi nếu bạn chưa duyệt.
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 bán hàng chủ động bằng email: 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 cold email riêng cho từng người, gửi đi và xử lý thư trả lời. Dự án trước đây tên Harvey, nay đã đổi tên. Hiện có khoảng 5.250 sao và 1.127 fork trên GitHub.
Bạn nên xem qua nếu bạn là chủ doanh nghiệp nhỏ, người làm sales hoặc làm agency, và đang tự tìm khách bằng tay: lên bản đồ, vào từng website, copy email, rồi soạn từng thư. Sellbird gom các việc đó vào một vòng chạy. Bạn có thể chạy cả chuỗi, hoặc dừng ở bước nào cũng được, ví dụ chỉ lấy danh sách khách đã kiểm tra email.
Điểm đáng giá nhất có hai cái. Thứ nhất, nó dùng chính gói Claude Pro/Max (qua Claude Code CLI) hoặc gói ChatGPT có Codex mà bạn đang trả, nên không có hoá đơn API theo từng token. Thứ hai, mặc định không email nào ra khỏi máy nếu bạn chưa bấm duyệt. Xem video ngắn bên dưới để thấy nó chạy thế nào, rồi quay lại đây làm theo từng bước.
ethanplusai/sellbird
Sellbird tự tìm công ty hợp, tìm người ra quyết định, kiểm tra email, viết và gửi cold email rồi xử lý phản hồi, chạy bằng gói Claude hoặc ChatGPT của bạn.
I.Sellbird làm được gì
Sellbird là một dây chuyền. Bạn chạy hết cả chuỗi hoặc dừng ở bước bạn muốn.
- Tìm công ty. Nó 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í và không cần tài khoản. 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ị tính tiền bất ngờ.
- Tìm lý do họ có thể mua. Nó đọc website của từng công ty để tìm các tín hiệu 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 và không tốn tiền, chỉ gửi ba yêu cầu HTTP cho mỗi công ty. Email sau này viết dựa trên đúng những gì nó thấy, nên đỡ giống thư gửi hàng loạt.
- 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 kiểu 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, risky, guess hoặc invalid. Chỉ địa chỉ gửi được mới được gửi tới. Việc này giúp giảm thư trả về, mà thư trả về nhiều thì hộp thư gửi dễ bị đánh giá xấu.
- Viết và gửi. Nó viết một chuỗi email ngắn cho từng người từ những gì nó tìm được, rồi gửi từ hộp thư Gmail, Microsoft 365 hoặc SMTP của bạn. Nó tôn trọng 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 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 xử lý ngay, còn việc nó không nên tự trả lời thì được chuyển cho bạn.
Ngoài ra có lệnh sellbird export để xuất file CSV sẵn cho công cụ gửi email khác, nếu bạn chỉ cần danh sách. Và có bảng điều khiển (dashboard) để xem tất cả, trong đó có hộp Outbox chứa các email chờ duyệt.
Về an toàn: trước khi gửi, một bước kiểm tra không dùng mô hình sẽ chặn email còn sót thẻ chưa điền, cụm từ bị cấm, thư quá dài, thừa link và địa chỉ không gửi được. Khi bạn bật chế độ tự động (autopilot), nó vẫn giữ lại email có link sang tên miền không phải của bạn, hoặc email trích dẫn chính chỉ dẫn nội bộ của Sellbird.
II.Cần chuẩn bị gì
Theo README, bạn cần:
- Python 3.11 trở lên. File
pyproject.tomlcũng yêu cầu>=3.11. README lưu ý macOS có sẵn bản 3.9, nên nếupython3 --versionbáo 3.9 thì chạybrew install python@3.13trước. - Claude Pro hoặc Max với CLI đã đăng nhập (
claude login), hoặc gói ChatGPT có Codex CLI. Phần cài Codex có hướng dẫn riêng trong thư mụcdocs/của repo. - 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) cho hộp thư đó. README giới thiệu TrulyInbox, và Sellbird đọc tỷ lệ vào inbox của nó để báo bạn khi nào sẵn sàng. Đây là link giới thiệu (affiliate) của người duy trì dự án. Bạn không bắt buộc dùng, nhưng hộp thư mới không warmup thì rất dễ vào spam.
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 đô cho 1.000 kết quả ở nguồn trả phí rẻ nhất. Đọc website là 0 đồng. Hộp thư Google Workspace khoảng 7 đô một tháng. README cũng cho biết không cần Apollo, ZoomInfo, Clearbit hay Clay.
Tư liệu không nói rõ yêu cầu phần cứng. File .env.example có sẵn nhiều biến cho các dịch vụ tuỳ chọn (kiểm tra email, Cloudflare, LinkedIn…), nhưng bạn chỉ cần điền những cái mình dùng.
Đây là công cụ gửi email thật tới người thật. Hãy gửi từ một tên miền riêng, không dùng tên miền chính của công ty. Đọc kỹ tài liệu "Legal and deliverability" trong thư mục docs/ của repo để biết các quy định về gửi email lạnh ở nước người nhận. Mật khẩu hộp thư và key chỉ để trong file .env trên máy bạn, đừng đưa lên GitHub hay gửi cho ai.
III.Cài đặt từng bước
Có hai đường: nhờ Claude Code cài giúp, hoặc tự gõ lệnh. Tóm tắt:
- Lấy mã nguồnTải repo về máy bằng git clone
- Cài SellbirdTạo môi trường ảo bằng Python 3.13 và chạy pip install -e .
- Điền thông tin đăng nhậpCopy .env.example thành .env rồi sửa
- Dạy Sellbird về sản phẩmChạy sellbird train với website của bạn
- Chọn dấu hiệu khách tốtChạy sellbird signals --confirm free
- Tìm khách và chạyChạy sellbird discover, sellbird dashboard, sellbird run
A.Cách dễ nhất: để Claude cài giúp
Nếu bạn đã có Claude Code và đã đăng nhập, mở terminal (trên Windows là PowerShell hoặc Terminal) rồi 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 thứ ba mở Claude Code ngay trong thư mục đó. Khi Claude mở, gõ "set up Sellbird for me". Theo README, 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 những thứ còn thiếu, hỏi những gì cần hỏi và huấn luyện Sellbird về sản phẩm của bạn. Chỗ người mới hay vấp: phải chạy claude bên trong thư mục sellbird, không phải ở thư mục khác.
B.Tự cài: tạo môi trường và cài gói
Sau khi đã clone và cd sellbird, chạy lệnh dưới. README ghi rõ dùng python3.13 chứ không phải python3, vì trên macOS lệnh python3 trần là bản 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 Python riêng trong thư mục .venv, bật nó lên, rồi cài Sellbird vào đó. Sau bước này bạn có lệnh sellbird. Lưu ý: dòng source .venv/bin/activate là cách bật môi trường trên macOS/Linux. README chưa ghi lệnh tương đương cho Windows, nên nếu dùng Windows hãy xem phần Troubleshooting trong docs/ của repo, hoặc nhờ Claude Code cài giúp như ở trên. Tư liệu cũng cho biết Docker chạy được trên Linux, và repo có sẵn Dockerfile và docker-compose.yml.
C.Điền thông tin đăng nhập
cp .env.example .env && $EDITOR .envLệnh đầu copy file mẫu thành .env, lệnh sau mở file để bạn sửa (README nói mỗi biến đều có chú thích ngay trong file). Bạn chỉ cần điền phần mình dùng, ví dụ thông tin Gmail, SMTP hoặc Microsoft 365 để gửi thư. Nếu máy không có $EDITOR, cứ mở file .env bằng trình soạn thảo quen thuộc. Chú ý: file .env bắt đầu bằng dấu chấm nên có thể bị ẩn trong trình quản lý file.
D.Dạy Sellbird về sản phẩm của bạn
sellbird train https://your-company.comThay địa chỉ bằng website của bạn. Sellbird đọc trang web để hiểu bạn bán gì cho ai, rồi ghi kết quả vào file sellbird.local.yaml. File này nằm trên máy bạn và git không đụng tới.
E.Xác nhận khách hàng tốt trông thế nào
sellbird signals --confirm freeBước này chốt các dấu hiệu cho thấy một công ty đáng nhắm tới. Tài liệu của repo nói có 29 dấu hiệu, bạn xem chi tiết trong phần "Signals" của docs/.
F.Tìm doanh nghiệp
sellbird discoverNguồn mặc định miễn phí, không cần tài khoản.
G.Mở bảng điều khiển và bắt đầu vòng 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). Mở link đó trong trình duyệt để xem Outbox và các màn hình khác. sellbird run khởi động vòng lặp chính, bạn nên để cửa sổ terminal này mở. Muốn chạy song song thì mở thêm một cửa sổ terminal khác cho dashboard.
IV.Kiểm tra đã chạy được chưa
Khi sellbird run hoạt động, README cho thấy màn hình mẫu như sau (dữ liệu trong ví dụ là dữ liệu giả):
Sellbird is online.
Checking pipeline state...
Decision: write_campaign (3 new prospects with no drafts)
writer → 2-email sequence: Phoenix HVAC hiring a dispatcher
outbox → 5 emails waiting for your approval
Cycle complete. Sleeping for 15 minutes.Các dấu hiệu bạn đang làm đúng:
- Dòng "Sellbird is online." xuất hiện.
- Có dòng "outbox" báo số email đang chờ bạn duyệt.
- Có dòng "Cycle complete" rồi nghỉ 15 phút trước vòng kế tiếp.
- Mở link do
sellbird dashboardin ra thì thấy bảng điều khiển và hộp Outbox.
Nếu lệnh sellbird báo không tìm thấy, thường là bạn chưa bật môi trường ảo ở cửa sổ terminal hiện tại, hoặc chưa chạy pip install -e . thành công.
V.Dùng vào việc thật
A.Chủ công ty phần mềm nhỏ tìm khách mới
Bạn bán phần mềm đặt lịch cho các tiệm làm đẹp hoặc phòng khám. Bạn chạy sellbird train với website của mình để Sellbird hiểu sản phẩm, rồi sellbird signals --confirm free để chốt dấu hiệu khách tốt, ví dụ doanh nghiệp chưa có đặt lịch online. Sau đó sellbird discover tìm doanh nghiệp. Kết quả là một danh sách công ty cùng người ra quyết định, mỗi email có nhãn verified, risky, guess hoặc invalid. Bạn không cần tự lục từng website.
Mặc định không có email nào được gửi đi nếu bạn chưa bấm duyệt.
Ông T
B.Nhân viên sales duyệt thư mỗi sáng
Bạn mở dashboard, vào hộp Outbox và đọc từng email Sellbird đã viết. Email nào ổn thì duyệt, email nào chưa ổn thì sửa. Khi có người trả lời, Sellbird đã soạn sẵn câu đáp, và bạn xem lại trước khi gửi. Những thư nó không nên tự trả lời sẽ được chuyển tới bạn. Bạn giữ quyền quyết định, còn việc soạn thảo lặp đi lặp lại thì máy làm. Khi cần dừng khẩn cấp, chạy sellbird sending pause để dừng toàn bộ việc gửi.
C.Agency chỉ cần danh sách để gửi bằng công cụ khác
Bạn đã có công cụ gửi email riêng và chỉ cần danh sách khách sạch. Hãy để Sellbird tìm và kiểm tra, rồi dừng lại sau bước kiểm tra. Chạy lệnh sau để xuất CSV:
sellbird exportREADME nói file này sẵn sàng đưa vào công cụ gửi thư (sequencer). Bạn tận dụng được phần tìm khách và kiểm tra email mà không cần cho Sellbird gửi thay.
D.Người đang dùng Harvey muốn nâng cấp
Nếu bạn đã chạy bản Harvey cũ, cấu hình, dữ liệu và đăng nhập dashboard được giữ lại. Dùng đúng các lệnh README đưa:
git pull
pip install -e . # once, to get the new `sellbird` command
sellbird dashboardLần chạy đầu, Sellbird tự đổi tên harvey.local.yaml thành sellbird.local.yaml và đổi tên file dữ liệu trong data/. Nó không ghi đè file đã có tên mới. Hãy tắt tiến trình Harvey đang chạy trước khi nâng cấp.
VI.Lỗi hay gặp và cách xử lý
Báo sai phiên bản Python hoặc lỗi khi cài trên macOS. Máy macOS thường có Python 3.9, trong khi Sellbird cần 3.11 trở lên. Chạy brew install python@3.13, rồi dùng đúng lệnh python3.13 khi tạo môi trường ảo như ở trên, không dùng python3 trần.
Không tìm thấy lệnh sellbird. Nguyên nhân thường gặp là môi trường ảo chưa được bật ở cửa sổ terminal này, hoặc pip install -e . chưa chạy xong. Mở terminal trong thư mục sellbird, bật lại môi trường ảo rồi thử lại.
Claude chưa đăng nhập. Sellbird dùng Claude Code CLI qua gói của bạn, nên CLI phải đăng nhập sẵn. Chạy claude login theo README rồi thử lại. Nếu bạn dùng ChatGPT, xem hướng dẫn Codex trong docs/.
git pull báo "your local changes would be overwritten" khi nâng cấp từ Harvey. Điều này xảy ra khi 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. Nếu báo xung đột, giữ lại các dòng của bạn, xoá dấu đánh dấu xung đột và chạy git stash drop. Về lâu dài, hãy để cài đặt của bạn trong sellbird.local.yaml, vì git không bao giờ đụng tới file này.
Email gửi đi bị vào spam hoặc tỷ lệ gửi thấp. Đây là rủi ro chung của cold email, tư liệu không nói riêng về một lỗi cụ thể. Nguyên nhân dễ 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 warmup hộp thư trước, dùng tên miền gửi riêng, giữ giới hạn gửi mỗi ngày thấp lúc đầu và đọc tài liệu "Legal and deliverability" trong docs/.
VII.Có nên dùng không
Điểm mạnh. Nó gom cả chuỗi tìm khách, kiểm tra email, viết thư, gửi và xử lý phản hồi vào một nơi, chạy trên máy bạn. Không phải trả API theo token vì dùng gói Claude hoặc ChatGPT sẵn có. Nguồn tìm doanh nghiệp mặc định miễn phí và mọi lần tìm trả phí đều hiện chi phí trước. Cơ chế duyệt mặc định cùng bước kiểm tra trước khi gửi giúp giảm rủi ro gửi nhầm. Bạn cũng có thể chỉ dùng một phần, như xuất danh sách CSV.
Giới hạn. Bạn phải tự lo hộp thư gửi, tên miền riêng và warmup. Cài đặt cần chút quen thuộc với terminal, và README mới ghi lệnh kích hoạt môi trường theo kiểu macOS/Linux. Repo dùng giấy phép AGPL-3.0, nên nếu bạn định sửa rồi cung cấp thành dịch vụ cho người khác thì cần đọc kỹ giấy phép. Phần cold email còn gắn với quy định pháp lý và độ uy tín của tên miền, những thứ công cụ không thể lo thay bạn.
Khi nào chọn cách khác. Nếu bạn không muốn tự vận hành, README nói có bản trả phí tên sellbird.ai (đang truy cập sớm), nơi tên miền gửi, hộp thư và warmup được thiết lập sẵn. Nếu bạn chủ yếu làm chăm sóc khách quen hoặc email marketing cho danh sách đã đồng ý nhận thư, một công cụ email marketing thông thường sẽ hợp hơn. Nếu máy không chạy được Claude Code CLI hoặc Codex, bạn sẽ không dùng được phần suy nghĩ của Sellbird theo cách README mô tả.
Câu hỏi thường gặp
Sellbird có miễn phí không?
Mã nguồn miễn phí, giấy phép AGPL-3.0. Bạn vẫn cần một gói Claude Pro/Max hoặc ChatGPT có Codex, và 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à 0 đồng, nguồn 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. README nói Sellbird chạy 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 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 thì có biến key riêng trong file .env.example.
Có cần GPU hay máy mạnh không?
Tư liệu không nêu yêu cầu phần cứng. Việc suy nghĩ được thực hiện qua Claude Code CLI hoặc Codex, nên bạn không thấy nhắc tới GPU. Yêu cầu chính là Python 3.11 trở lên.
Chạy được trên Windows không?
README có nhắc thư mục dữ liệu trên Windows là %APPDATA%\sellbird, nhưng lệnh kích hoạt môi trường ảo trong README viết theo kiểu macOS/Linux. Docker được nói là chạy trên Linux. Bạn xem thêm phần Troubleshooting trong docs/ hoặc nhờ Claude Code cài giúp.
Nó 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 chế độ tự động. Lệnh sellbird sending pause dừng toàn bộ việc gửi ngay lập tức.
Dữ liệu của tôi lưu ở đâu?
Cấu hình, dữ liệu và kiến thức nằm trong một thư mục chính trên máy bạn. Khi dùng bản clone thì đó là chính thư mục repo, còn khi cài như gói thì là thư mục dữ liệu người dùng. Bảng điều khiển chạy ở địa chỉ 127.0.0.1 trên máy bạn. Tư liệu không nói gì thêm về cách bảo mật chi tiết.
Sellbird khác gì Harvey?
Là cùng một dự án, cùng lịch sử, đổi tên từ phiên bản 0.4.0. Cấu hình và dữ liệu Harvey cũ được giữ lại khi nâng cấp, và biến HARVEY_* vẫn dùng được khi chưa đặt biến SELLBIRD_* tương ứng. Lệnh harvey cũ còn chạy tạm thời và sẽ bị bỏ ở bản sau.


