Sellbird: tìm khách, gửi cold email cá nhân hoá — 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 outreach mã nguồn mở viết bằng Python. Nó tìm doanh nghiệp 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ý phản hồi, dùng gói Claude Pro/Max hoặc ChatGPT có Codex nên không cần API key mô hình. Cài bằng Python 3.11 trở lên, khá dễ nếu bạn quen terminal; chưa quen thì có thể nhờ Claude Code dẫn cài.
Sellbird là một nền tảng mã nguồn mở giúp bạn làm cold email từ đầu đến cuối: 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 từng email riêng cho từng người, gửi đi và xử lý phản hồi. Nó chạy ngay trên máy của bạn. Mặc định, không có email nào được gửi khi bạn chưa duyệt.
Điểm đáng giá nhất là chuyện chi phí. Sellbird dùng Claude Code CLI trên gói Claude Pro hoặc Max, hoặc Codex trên gói ChatGPT, để "suy nghĩ" và viết email. Nghĩa là bạn không cần API key mô hình và không bị tính tiền theo token. Nó cũng không dùng các công cụ tìm khách trả phí kiểu Apollo, ZoomInfo, Clearbit hay Clay.
Repo hiện có khoảng 5249 sao và 1127 fork, giấy phép AGPL-3.0, và vẫn được cập nhật trong 3 tháng gần đây. Người nên xem là chủ doanh nghiệp nhỏ, người làm sales hoặc marketing, và lập trình viên muốn tự chạy hệ thống tiếp cận khách. Bạn có thể xem video ngắn bên dưới để thấy nó chạy trước khi cài.
ethanplusai/sellbird
Nền tảng mã nguồn mở tự tìm công ty, tìm người quyết định, kiểm tra email, viết và gửi cold email, 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 chuỗi bước. Bạn có thể chạy hết cả chuỗi hoặc dừng ở bất kỳ bước nào.
- 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ị tính tiền bất ngờ.
- Tìm lý do họ sẽ mua. Nó đọc chính website của 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ì. 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 trang của công ty, tối đa hai người mỗi công ty. Bạn không phải ngồi lục LinkedIn từng nơi.
- Kiểm tra địa chỉ email. Nó học mẫ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 bị đưa vào danh sách gửi, nên bạn đỡ bị trả thư lỗi và giữ được uy tín hộp thư.
- 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 đó nó gửi từ hộp thư Gmail, Microsoft 365 hoặc SMTP của bạn, trong giới hạn số email mỗi ngày và theo 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 tách riêng, yêu cầu ngừng nhận mail được tôn trọng ngay. Việc nào không nên tự trả lời thì nó 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 rồi chạy sellbird export. Bạn sẽ có một file CSV sẵn để đưa vào công cụ gửi mail khác.
Về an toàn, mọi email gửi đi nằm chờ trong Outbox cho đến khi bạn duyệt, trừ khi bạn tự bật autopilot. Trước khi gửi còn có một bước kiểm tra không dùng mô hình. Bước này chặn các trường hợp như quên điền merge tag, cụm từ bị cấm, email quá dài, thừa link và địa chỉ không gửi được. Lệnh sellbird sending pause dừng mọi thứ ngay lập tức.
II.Cần chuẩn bị gì
Theo README, bạn cần:
- Python 3.11 trở lên. Gói khai báo
requires-python >=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. - Một gói để chạy mô hình: Claude Pro hoặc Max với 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 riêng. Microsoft 365 và SMTP cũng chạy được.
- Warmup cho hộp thư đó. Tác giả giới thiệu TrulyInbox để "làm nóng" hộp thư mới trước khi gửi cold email. Sellbird đọc tỉ lệ vào inbox của dịch vụ này để báo khi bạn đã sẵn sàng. Lưu ý đây là link affiliate: người duy trì dự án có thể nhận hoa hồng.
- Git, để tải mã nguồn về.
Chi phí đi kèm theo README: 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 doanh nghiệp với nguồn trả phí rẻ nhất. Hộp thư Google Workspace khoảng 7 USD một tháng.
File .env.example còn liệt kê nhiều biến tuỳ chọn, ví dụ khoá cho dịch vụ kiểm tra email (Reoon, ZeroBounce, Hunter), Instantly, Cloudflare hay DataForSEO. Bạn không cần điền hết. Chỉ điền những dịch vụ bạn thật sự dùng.
Về hệ điều hành, README nhắc cụ thể macOS và Linux (Docker cho Linux), và có nêu thư mục dữ liệu trên Windows. Phần Quick start dùng lệnh kiểu macOS/Linux, còn cách kích hoạt môi trường ảo trên Windows thì README chưa ghi. Bạn xem thêm trong thư mục docs/ của repo.
III.Cài đặt từng bước
- Tải mã nguồngit clone repo về máy rồi vào thư mục sellbird
- Cài góiTạo môi trường ảo bằng Python 3.13 và pip install -e .
- Điền thông tinCopy .env.example thành .env rồi điền thông tin hộp thư
- Dạy Sellbird về sản phẩmsellbird train với website của bạn
- Tìm kháchsellbird signals --confirm free rồi sellbird discover
- Mở dashboard và chạysellbird dashboard rồi sellbird run
README đưa ra hai cách: nhờ Claude dẫn cài, hoặc tự làm từng lệnh.
A.Cách 1: để Claude Code dẫn bạn cài
Cách này hợp với người mới. Mở terminal (Terminal trên macOS, hoặc cửa sổ dòng lệnh bạn quen dùng), rồi chạy:
git clone https://github.com/ethanplusai/sellbird.git
cd sellbird
claudeLệnh git clone tải mã nguồn về, cd sellbird đưa bạn vào thư mục vừa tải, claude mở Claude Code ngay trong thư mục đó. Khi nó mở, bạn gõ: "set up Sellbird for me". File CLAUDE.md của repo biến Claude Code thành người hướng dẫn: nó kiểm tra máy bạn, cài những gì còn thiếu, hỏi thông tin cần thiết và dạy Sellbird về sản phẩm của bạn. Điều kiện là bạn đã cài Claude Code CLI và đăng nhập bằng claude login.
B.Cách 2: tự cài từng lệnh
Sau khi đã git clone và cd sellbird như trên, chạy bước đầu tiên:
# 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, kích hoạt nó, rồi cài Sellbird ở chế độ pip install -e .. Chỗ hay vấp là dùng python3 trần, vì trên macOS đó là bản 3.9 quá cũ. Hãy dùng đúng python3.13 như README ghi.
# 2. Add credentials. Every variable is documented inline.
cp .env.example .env && $EDITOR .envLệ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ư bạn dùng để gửi (Gmail, Microsoft 365 hoặc SMTP). File .env chứa mật khẩu, nên đừng gửi nó cho ai và đừng đưa lên chỗ công khai.
# 3. Learn your product from your website (writes sellbird.local.yaml).
sellbird train https://your-company.comThay địa chỉ bằng website thật của bạn. Sellbird đọc trang web để hiểu bạn bán gì rồi ghi kết quả vào file sellbird.local.yaml. File này nằm ngoài sự quản lý của git, nên cập nhật sau này không ghi đè.
# 4. Confirm what makes a good prospect.
sellbird signals --confirm freeBước này xác nhận những tín hiệu cho biết một công ty là khách tiềm năng tốt. Ở đây bạn dùng lựa chọn free, đúng như README.
# 5. Find businesses. The default source is free and needs no account.
sellbird discoverTìm doanh nghiệp từ nguồn mặc định, miễn phí và không cần tài khoản.
# 6. Open the dashboard and start the loop.
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ỉ http://127.0.0.1:5555, tức bảng điều khiển chạy trên chính máy bạn. Hãy mở link đó bằng trình duyệt. Sau đó sellbird run bật vòng lặp chính. Cứ mỗi chu kỳ nó kiểm tra tình hình, viết thêm nội dung nếu cần, rồi nghỉ 15 phút (theo ví dụ trong README). Hãy để cửa sổ terminal này mở trong lúc chạy.
C.Nếu bạn dùng Docker hoặc ChatGPT
README nói trên Linux bạn có thể chạy bằng Docker, và repo có sẵn Dockerfile cùng docker-compose.yml. Chi tiết nằm trong tài liệu Docker của repo. Với ChatGPT, README có hướng dẫn riêng "Using a ChatGPT plan (Codex)" trong docs/. Mình không chép lệnh ở đây vì README chính không ghi các lệnh đó.
Sellbird sẽ gửi email thật từ hộp thư của bạn. Hãy dùng tên miền gửi riêng, bật warmup và giữ chế độ duyệt tay trong Outbox lúc mới làm quen. Đọc kỹ tài liệu Legal and deliverability trong repo để biết quy định bạn phải tuân thủ khi gửi cold email.
IV.Kiểm tra đã chạy được chưa
Cách đơn giản nhất là chạy sellbird run và xem màn hình. README cho ví dụ kết quả mong đợi: dòng "Sellbird is online", dòng "Checking pipeline state...", một dòng "Decision" cho biết nó định làm gì tiếp, các dòng handler hoặc writer cho biết việc đang xử lý, và cuối cùng là "Cycle complete. Sleeping for 15 minutes." Nếu bạn thấy kiểu thông báo đó, vòng lặp đã chạy.
Bạn cũng kiểm tra được qua dashboard. sellbird dashboard phải in ra một link riêng, và mở link đó bạn thấy giao diện chạy tại địa chỉ 127.0.0.1:5555. Khi có email được viết xong, chúng sẽ nằm trong Outbox chờ bạn duyệt. Trong ví dụ của README, dòng "outbox → 5 emails waiting for your approval" cho thấy đúng điều này.
Dữ liệu demo trong README là bịa ra (công ty "Bookwell" bán đặt lịch online cho thợ lợp mái, phòng nha và tiệm điều hoà, trên tên miền .test), nên bạn không cần lo email demo bay ra ngoài.
V.Dùng vào việc thật
Dưới đây là vài tình huống bám đúng khả năng có trong README. Mình giữ các câu lệnh đúng như tài liệu.
A.Chủ doanh nghiệp nhỏ muốn tìm khách mới
Bạn bán phần mềm đặt lịch cho 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 bạn bán gì, rồi sellbird signals --confirm free để chốt dấu hiệu một khách tốt trông ra sao, ví dụ chưa có đặt lịch online. Sau đó chạy sellbird discover. Kết quả là một danh sách doanh nghiệp từ nguồn miễn phí, kèm lý do mỗi nơi có thể cần sản phẩm của bạn.
Trên dashboard bạn xem danh sách, loại bớt những nơi không hợp, rồi cho nó viết email.
B.Nhân viên sales chỉ cần danh sách để gọi hoặc gửi bằng công cụ khác
Công ty bạn đã có phần mềm gửi mail riêng và chỉ thiếu danh sách sạch. Bạn chạy các bước tìm công ty, tìm người quyết định và kiểm tra email, rồi dừng lại. Sau đó chạy:
sellbird exportBạn nhận một file CSV sẵn sàng đưa vào công cụ gửi mail. Mỗi địa chỉ đã được gắn nhãn verified, risky, guess hoặc invalid, nên bạn lọc được những địa chỉ đáng tin.
Sellbird không gửi gì khi bạn chưa gật đầu: mọi email chờ trong Outbox cho đến khi bạn duyệt.
Ông T
C.Người làm một mình, muốn có người trực thư trả lời
Bạn đã gửi được một đợt email. Giờ thư trả lời về rải rác trong ngày. Để sellbird run chạy, nó đọc từng thư, soạn sẵn câu trả lời cho người quan tâm hoặc người phản đối, tách thư tự động trả lời sang một bên và tôn trọng ngay yêu cầu ngừng nhận mail. Việc nó không nên tự quyết thì được chuyển cho bạn. Bạn mở dashboard, đọc các bản nháp, sửa nếu cần rồi duyệt gửi.
Nếu cần dừng khẩn cấp, ví dụ thấy nội dung chưa ổn, bạn chạy sellbird sending pause.
D.Lập trình viên muốn tuỳ biến
README nói các sales playbook (trong skills/) và các prompt (trong prompts/) đều có thể sửa, và có tài liệu về Extensions để thêm route, bước heartbeat và lệnh từ một gói riêng. Bạn có thể chỉnh giọng văn email, đổi cách viết hay bổ sung bước mới. Bắt đầu bằng tài liệu "Skills and sub-agents" và "Extensions" trong docs/.
VI.Lỗi hay gặp và cách xử lý
python3 --versionbáo 3.9, cài gói thất bại. Đây là trường hợp README nêu rõ trên macOS. Cài Python mới (brew install python@3.13) rồi tạo môi trường ảo bằngpython3.13, không dùngpython3trần.- Gõ
sellbirdbáo không tìm thấy lệnh. Rất có thể môi trường ảo chưa được kích hoạt, hoặc bạn mở terminal mới sau khi cài. Vào lại thư mục dự án, kích hoạt.venvrồi thử lại. Nếu vẫn lỗi, chạy lạipip install -e .. - Claude CLI chưa đăng nhập hoặc hết hạn mức gói. Sellbird suy nghĩ qua Claude Code CLI, nên cần
claude logintrước. Sellbird tự giảm tốc để chừa chỗ cho việc của bạn, nhưng nếu gói đã cạn thì hãy chờ hoặc đổi sang gói cao hơn. Chi tiết xem phần Troubleshooting trongdocs/. - Sau khi nâng cấp từ Harvey,
git pullbáo "your local changes would be overwritten". Điều này xảy ra khi bạn sửa trực tiếp fileharvey.yaml. README hướng dẫn: chạygit stash, rồigit pull, rồigit stash pop. Nếu có xung đột, giữ lại các dòng của bạn, xoá dấu xung đột rồi chạygit stash drop. Về lâu dài nên đặt cấu hình trongsellbird.local.yamlđể git không đụng tới. - Email không đến hoặc vào thư rác. README nhấn mạnh phải có warmup cho hộp thư và dùng tên miền gửi riêng. Hãy đọc tài liệu Legal and deliverability, giữ nội dung ngắn, ít link, và đừng tăng số email mỗi ngày quá nhanh.
VII.Có nên dùng không
Điểm mạnh rõ nhất: chi phí mô hình gần như bằng gói thuê bao bạn đã có, không phải trả theo token. Dữ liệu nằm trên máy bạn. Quy trình có nhiều lớp chốt an toàn: duyệt tay trong Outbox, kiểm tra trước khi gửi, nhãn chất lượng email và lệnh dừng tức thì. Cả chuỗi từ tìm khách đến xử lý phản hồi nằm trong một công cụ, và bạn có thể dừng ở bất kỳ bước nào.
Giới hạn cần biết: bạn phải tự chuẩn bị hộp thư gửi và warmup, đây là phần dễ bị đánh giá thấp. Cài đặt cần quen terminal và Python 3.11 trở lên, mà README chưa hướng dẫn riêng cho Windows ở phần Quick start. Nguồn tìm doanh nghiệp mặc định là OpenStreetMap, nên độ phủ có thể không đều với từng ngành hay từng quốc gia. README không nói về chất lượng dữ liệu ở thị trường Việt Nam, nên bạn nên thử nhỏ trước. Giấy phép là AGPL-3.0 (các bản Harvey đến 0.3.x dùng MIT), bạn nên đọc kỹ nếu định tích hợp vào sản phẩm thương mại.
Cuối cùng, gửi cold email có ràng buộc pháp lý tuỳ nơi bạn gửi. Đây là công cụ, không phải sự cho phép. Nếu bạn không muốn tự vận hành, tác giả có bản hosted tại trang chủ dự án (đang trong giai đoạn early access) và mình chưa có thông tin chi tiết về nó. Nếu bạn chỉ cần danh sách khách hoặc muốn gửi hàng loạt qua công cụ có sẵn, có thể chỉ dùng phần tìm khách và sellbird export.
Câu hỏi thường gặp
Sellbird có miễn phí không?
Phần mềm là mã nguồn mở, giấy phép AGPL-3.0. Tìm doanh nghiệp bằng nguồn mặc định là 0 đồng, đọc website của họ cũng 0 đồng. Bạn vẫn cần gói Claude Pro/Max hoặc ChatGPT có Codex và một hộp thư để gửi, ví dụ Google Workspace khoảng 7 USD một tháng theo README.
Có cần API key của OpenAI hay Anthropic không?
Không. README nói 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. Không có API key mô hình và không tính tiền theo token. Một số biến tuỳ chọn trong .env.example là khoá của dịch vụ khác như kiểm tra email.
Có cần GPU hay máy mạnh không?
Tư liệu không yêu cầu GPU. Phần suy nghĩ do Claude hoặc Codex đảm nhận qua gói thuê bao của bạn. Yêu cầu nêu 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 trên Windows (%APPDATA%\sellbird), nhưng phần Quick start viết theo kiểu macOS/Linux và chỉ nói Docker cho Linux. Hướng dẫn riêng cho Windows chưa có trong README chính, bạn nên xem thư mục docs/ của repo.
Email có tự gửi đi mà tôi không biết không?
Mặc định là không. Mọi email nằm trong Outbox chờ bạn duyệt cho đến 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 thứ ngay.
Dữ liệu có an toàn không?
Sellbird chạy trên máy của bạn, cấu hình, kiến thức và dữ liệu nằm trong một thư mục home. Dashboard chạy ở địa chỉ nội bộ 127.0.0.1:5555 qua link riêng. README không nói thêm về chuẩn bảo mật khác, nên hãy giữ file .env kín và xem SECURITY.md.
Harvey và Sellbird khác nhau thế nào?
Là cùng một dự án, cùng lịch sử, được đổi tên thành Sellbird từ phiên bản 0.4.0. Cấu hình, dữ liệu và đăng nhập dashboard của Harvey đượ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.


