Bỏ qua tới nội dung
Ông T.vn

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

12 phút đọcCập nhật

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 →

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 bạn 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 qua Claude Code CLI hoặc Codex nên không cần API key mô hình. Cài đặt vừa sức: cần Python 3.11 trở lên và một hộp thư để gửi, còn lại có thể nhờ Claude Code dẫn từng bước.

Sellbird là một nền tảng mã nguồn mở để làm outreach (tiếp cận khách hàng chủ động) bằng email lạnh: nó tìm công ty cần thứ bạn bán, tìm người quyết định, kiểm tra email, viết thư riêng cho từng người, gửi đi và đọc giúp bạn các thư trả lời. Cả chuỗi này chạy ngay trên máy của bạn. Mặc định, không email nào được gửi đi nếu bạn chưa duyệt.

Nếu bạn làm kinh doanh nhỏ, làm sales, làm agency hoặc là lập trình viên muốn có dây chuyền tìm khách mà không trả tiền cho hàng loạt công cụ prospecting, repo này dành cho bạn. Điểm đáng giá nhất là Sellbird 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ả tiền. Không cần API key mô hình, không tính tiền theo từng token. Repo hiện có khoảng 5.250 sao và 1.127 fork, giấy phép AGPL-3.0, và vẫn được cập nhật trong 3 tháng gần đây.

Bạn có thể xem video ngắn bên dưới để thấy tổng quan trước khi cài. Bài này đi từ chuẩn bị, cài đặt, kiểm tra đến các tình huống dùng thật và những lỗi hay gặp.

Ứng dụng

ethanplusai/sellbird

Sellbird 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 và xử lý phản hồi, chạy trên gói Claude hoặc ChatGPT của bạn.

★ 5.3kPythonAGPL-3.0
Xem repo trên GitHub
Video giới thiệu sellbirdXem trên YouTubeXem trên Facebook

I.Sellbird làm được gì

Sellbird là một đường ống (pipeline). Bạn chạy trọn từ đầu đến cuối, hoặc dừng ở bước nào cũng được. Theo README, có sáu việc chính:

  • Tìm công ty. Nó tìm các doanh nghiệp giống khách hàng của bạn, miễn phí trên OpenStreetMap hoặc trên một nguồn trả phí do bạn chọn. Mỗi lần tìm bằng nguồn trả phí đều hiện chi phí trước khi chạy, nên bạn không bị bất ngờ.
  • Hiểu vì sao họ sẽ mua. Nó đọ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, hay đang tuyển một vị trí nào đó. Bước này không gọi mô hình, không tốn phí.
  • 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 trang của công ty, tối đa hai người mỗi công ty. Bạn không phải mua danh sách liên hệ.
  • 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 thư. Điều này giúp bạn tránh thư bị trả về làm hỏng uy tín tên miền gửi.
  • Viết và gửi. Với mỗi người, nó viết một chuỗi email ngắn dựa trên 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, trong hạn mức 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 từng thư trả lời, soạn sẵn câu trả lời, tách riêng thư trả lời tự động, tôn trọng yêu cầu từ chối 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, hãy dừng sau bước kiểm tra email và chạy sellbird export để có file CSV sẵn cho công cụ gửi thư khác.

Một điểm đáng chú ý nữa là cơ chế an toàn. Mọi email gửi đi nằm chờ trong hộp Outbox cho đến khi bạn duyệt, trừ khi chính bạn bật chế độ autopilot. Trước khi gửi, một bước kiểm tra không dùng mô hình sẽ chặn thư còn sót merge tag 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. Lệnh sellbird sending pause dừng mọi thứ cùng lú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. 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.
  • Một trong hai gói mô hình: Claude Pro hoặc Max với CLI đã đăng nhập (claude login), hoặc gói ChatGPT có Codex CLI (có hướng dẫn riêng trong docs 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 để làm nóng hộp thư mới trước khi gửi cold email, và Sellbird đọc tỷ lệ vào inbox của nó để báo bạn khi nào sẵn sàng. Lưu ý: link TrulyInbox trong dự án là link affiliate, tác giả có thể nhận hoa hồng.

Hệ điều hành: README nêu đường dẫn thư mục dữ liệu cho macOS, Windows và Linux, và nói chạy bằng Docker thì dùng trên Linux. Về phần cứng, README không đề cập yêu cầu đặc biệt nào.

File .env.example liệt kê các biến cấu hình tuỳ chọn như thông tin Gmail, SMTP/IMAP, Microsoft 365, các dịch vụ kiểm tra email (Reoon, ZeroBounce, Hunter), TrulyInbox và vài dịch vụ khác. Bạn không cần điền hết. Chỉ điền phần ứng với dịch vụ bạn thật sự dùng.

Hộp thư gửi và tên miền của bạn là thứ có giá trị. Gửi cold email sai cách có thể làm tên miền bị đánh dấu spam. Hãy dùng tên miền gửi riêng, làm warmup trước, giữ chế độ duyệt tay (đừng bật autopilot vội) và đọc kỹ tài liệu Legal and deliverability trong thư mục docs của repo về quy định nơi bạn gửi tới. Mật khẩu và key trong file .env tuyệt đối không đưa lên mạng.

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

  1. Tải mã nguồnClone repo về máy và vào thư mục sellbird
  2. Cài đặtTạo môi trường ảo Python và cài gói bằng pip
  3. Điền thông tinSao chép .env.example thành .env rồi điền
  4. Dạy Sellbird về sản phẩmChạy sellbird train với website của bạn
  5. Chọn tín hiệu và tìm kháchChạy sellbird signals và sellbird discover
  6. Mở dashboard và chạyChạy sellbird dashboard rồi sellbird run

README có hai đường: nhờ Claude Code dẫn dắt, hoặc tự làm tay. Người mới nên thử đường thứ nhất trước.

A.Cách dễ nhất: để 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 ba lệnh sau. Lệnh đầu tải mã nguồn, 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 đó.

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

Khi Claude Code mở lên, bạn gõ: set up Sellbird for me (nghĩa là cài Sellbird giúp tôi). 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 gì 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. Bạn cần đã đăng nhập Claude CLI bằng claude login từ trước.

B.Tự cài bằng tay: tạo môi trường và cài gói

Sau khi đã clone và cd sellbird, chạy lệnh dưới đây. Nó tạo môi trường ảo .venv, kích hoạt rồi cài Sellbird. Đây là lệnh đúng như README, ghi cho macOS/Linux. Chỗ người mới hay vấp: README dặn dùng python3.13 chứ không dùng python3 trần, vì trên macOS python3 trần là bản 3.9 quá cũ.

Terminal
python3.13 -m venv .venv && source .venv/bin/activate && pip install -e .

README chưa ghi riêng lệnh kích hoạt môi trường ảo trên Windows. Nếu bạn dùng Windows, cách an toàn là dùng đường nhờ Claude Code ở trên, hoặc xem thêm tài liệu trong thư mục docs/ của repo.

C.Điền thông tin đăng nhập

Lệnh sau sao chép file mẫu thành file .env thật rồi mở nó để bạn điền. README nói mọi biến đều có chú thích ngay trong file. $EDITOR là trình soạn thảo mặc định trên máy bạn. Nếu lệnh này không mở được gì, bạn cứ mở file .env bằng bất kỳ trình soạn thảo văn bản nào.

Terminal
cp .env.example .env && $EDITOR .env

Bạn chỉ cần điền phần ứng với hộp thư và dịch vụ bạn định dùng. Đừng điền những dịch vụ chưa có.

D.Dạy Sellbird về sản phẩm của bạn

Lệnh này cho Sellbird đọc website công ty bạn để hiểu bạn bán gì. Kết quả được ghi vào file sellbird.local.yaml. Hãy thay địa chỉ bằng website thật của bạn.

Terminal
sellbird train https://your-company.com

E.Xác nhận khách hàng tốt trông như thế nào

Lệnh này giúp bạn chốt các tín hiệu cho thấy một công ty đáng tiếp cận. Theo README, bạn chạy với --confirm free.

Terminal
sellbird signals --confirm free

F.Tìm doanh nghiệp

Nguồn mặc định miễn phí và không cần tài khoản.

Terminal
sellbird discover

G.Mở dashboard và chạy vòng lặp

Lệnh đầu in ra một link riêng tư tới http://127.0.0.1:5555, đây là địa chỉ chỉ máy bạn truy cập được. Lệnh thứ hai khởi động vòng lặp làm việc. Hãy để cửa sổ terminal này mở khi chạy.

Terminal
sellbird dashboard
sellbird run

Ngoài ra README nói trên Linux bạn cũng có thể chạy bằng Docker. Repo có sẵn Dockerfile và docker-compose.yml, chi tiết xem trong tài liệu Docker ở thư mục docs/.

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

Cách kiểm tra rõ nhất là chạy sellbird run. Theo README, màn hình sẽ hiện dòng “Sellbird is online”, rồi báo đang kiểm tra trạng thái pipeline, đưa ra quyết định (ví dụ viết chiến dịch cho các prospect mới chưa có thư nháp), liệt kê các việc của bộ xử lý phản hồi và bộ viết thư, rồi báo số email đang chờ bạn duyệt. Cuối cùng nó ghi “Cycle complete” và nghỉ 15 phút trước vòng kế tiếp.

Bạn cũng có thể mở link riêng mà sellbird dashboard in ra. Nếu thấy giao diện dashboard với Outbox và danh sách công ty, bạn đã cài thành công.

Về dữ liệu demo, README nói bộ dữ liệu mẫu là 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, dùng tên miền .test). Nên ví dụ trên màn hình có thể khác dữ liệu của bạn.

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

A.Chủ doanh nghiệp nhỏ muốn có danh sách khách tiềm năng

Bạn bán dịch vụ cho tiệm nha, phòng khám hay xưởng sửa chữa. Bạn chưa muốn gửi thư, chỉ cần danh sách sạch. Cách làm: chạy sellbird train với website của bạn, sellbird signals --confirm free, rồi sellbird discover để tìm trên nguồn miễn phí. Sau khi Sellbird đã tìm người quyết định và kiểm tra email, chạy:

Terminal
sellbird export

Kết quả là file CSV mà README mô tả là sẵn cho công cụ gửi thư hàng loạt. Bạn có danh sách công ty, người liên hệ và trạng thái email mà không tốn tiền mua dữ liệu.

Công cụ không biết bán hàng thay bạn, nhưng nó làm hết phần việc lặp đi lặp lại mà bạn hay bỏ dở.

Ông T

B.Nhân viên sales duyệt thư mỗi sáng

Bạn là người làm sales và muốn giữ quyền kiểm soát. Giữ nguyên chế độ mặc định: Sellbird viết chuỗi email dựa trên thông tin tìm được (ví dụ một công ty đang tuyển nhân viên điều phối) rồi đưa vào Outbox. Mỗi sáng bạn mở dashboard, đọc từng thư, sửa nếu cần và duyệt. Thư chỉ đi ra khi bạn gật đầu. Nếu thấy có gì không ổn, sellbird sending pause dừng toàn bộ việc gửi.

C.Người làm agency xử lý thư trả lời

Sau khi gửi, thư trả lời về nhiều. Sellbird đọc từng thư, soạn sẵn câu trả lời cho các thư quan tâm hoặc phản đối, đặt riêng thư trả lời tự động, và lập tức tôn trọng yêu cầu ngừng nhận. Bạn chỉ phải xử lý những thứ nó chuyển lên cho mình, như các trường hợp nó không nên tự trả lời. Cách làm việc: để sellbird run chạy, mở dashboard để xem các câu trả lời nháp và duyệt.

D.Lập trình viên muốn tuỳ biến theo cách bán của mình

Bạn là dev và muốn chỉnh cách viết thư. README nói thư mục prompts/ và skills/ là các playbook bán hàng có thể sửa, và bạn nên đặt cài đặt riêng vào sellbird.local.yaml (git không đụng tới file này khi bạn cập nhật). Bạn có thể thêm route, bước heartbeat hay lệnh mới từ một gói riêng theo tài liệu Extensions. Hãy đọc thêm mục Skills and sub-agents trong docs để biết agent nào dùng playbook nào.

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

  • python3 --version báo 3.9 trên macOS, cài lỗi. Đây là lỗi README đã cảnh báo. Chạy brew install python@3.13 rồi dùng python3.13 khi tạo môi trường ảo, đừng dùng python3 trần.
  • Gõ sellbird báo không tìm thấy lệnh. Thường do bạn chưa kích hoạt môi trường ảo trong cửa sổ terminal đang dùng, hoặc chưa chạy pip install -e .. Kích hoạt lại .venv và cài lại gói. Nếu vẫn lỗi, xem tài liệu Troubleshooting trong docs/.
  • Claude Code không chạy hoặc Sellbird không gọi được mô hình. Sellbird dựa vào Claude CLI đã đăng nhập. Hãy chạy claude login và kiểm tra gói Claude Pro/Max của bạn còn hiệu lực. Nếu dùng ChatGPT, làm theo hướng dẫn Codex trong docs.
  • Đang dùng Harvey cũ, git pull báo “your local changes would be overwritten”. README nói đây là do bạn đã sửa trực tiếp harvey.yaml. Chạy lần lượt git stash, git pull, git 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 git stash drop. Lần sau hãy đặt cài đặt vào sellbird.local.yaml.
  • Thư đi ít hoặc vào spam. Đây là rủi ro chung của cold email, không riêng gì Sellbird. Hãy kiểm tra hộp thư đã warmup đủ chưa, bạn có dùng tên miền gửi riêng không, và đọc tài liệu Legal and deliverability của repo. Giữ hạn mức gửi mỗi ngày thấp lúc mới bắt đầu.

VII.Có nên dùng không

Điểm mạnh. Bạn tận dụng gói Claude hoặc ChatGPT sẵn có nên không phải trả hoá đơn API theo token. Nguồn tìm doanh nghiệp mặc định miễn phí, bước đọc website không tốn phí, và README nói rõ không cần Apollo, ZoomInfo, Clearbit hay Clay. Mọi thứ chạy trên máy của bạn, mặc định mọi thư chờ bạn duyệt, và có bước kiểm tra trước khi gửi không dùng mô hình. Mã nguồn mở nên bạn đọc và chỉnh được.

Giới hạn. Đây là công cụ cho cold email, nên bạn phải tự chịu trách nhiệm về quy định pháp lý và uy tín tên miền. Bạn vẫn cần hộp thư gửi (README nhắc khoảng 7 USD mỗi tháng cho Google Workspace) và nên có warmup. Dùng nguồn tìm trả phí sẽ tốn thêm tiền, dù mỗi lần đều hiện giá trước. README cũng cho thấy công cụ này tập trung vào tiếp cận doanh nghiệp theo kiểu danh mục địa phương, nên nếu khách của bạn rất ngách hoặc không có website, kết quả có thể ít. Giấy phép AGPL-3.0 có điều kiện riêng, hãy đọc kỹ nếu bạn định đưa nó vào 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, README nói có bản hosted tại sellbird.ai (đang ở giai đoạn early access, có sẵn tên miền gửi, hộp thư và warmup). Nếu bạn chỉ cần gửi một vài email thủ công, một công cụ đơn giản hơn là đủ. Còn nếu bạn muốn một dây chuyền tìm khách chạy sẵn, tự kiểm soát và chi phí thấp, Sellbird là lựa chọn đáng thử, miễn là bạn bắt đầu chậm và giữ chế độ duyệt tay.

4.7/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

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, tải về dùng được. Bạn vẫn cần gói Claude Pro/Max hoặc ChatGPT có Codex, và một hộp thư để gửi (README nhắc khoảng 7 USD mỗi tháng cho Google Workspace). Nguồn tìm doanh nghiệp mặc định miễn phí, nguồn trả phí sẽ hiện chi phí trước khi chạy.

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

Không. Theo README, Sellbird suy nghĩ 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ần API key mô hình 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ần GPU hoặc máy mạnh không?

README không nêu yêu cầu phần cứng đặc biệt nào, và phần suy nghĩ của mô hình chạy qua gói Claude hoặc ChatGPT của bạn. Điều kiện được nêu 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) nên có thể dùng được, nhưng lệnh kích hoạt môi trường ảo trong README chỉ ghi cho macOS/Linux, và Docker được ghi là dùng trên Linux. Trên Windows, bạn nên nhờ Claude Code dẫn cài hoặc xem thêm tài liệu trong thư mục docs.

Sellbird có tự gửi thư mà tôi không biết không?

Không, trừ khi bạn tự bật autopilot. Mặc định mọi thư chờ trong Outbox để bạn duyệt. Trước khi gửi còn có bước kiểm tra chặn các lỗi như merge tag chưa điền, thư quá dài, quá nhiều link hay địa chỉ không gửi được. Lệnh sellbird sending pause dừng 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, cấu hình, kiến thức và dữ liệu nằm trong một thư mục riêng. Dashboard mở ở địa chỉ 127.0.0.1 với link riêng tư. Về chi tiết bảo mật, hãy xem SECURITY.md trong repo.

Sellbird có phải là Harvey cũ không?

Đúng, Harvey đã đổi tên thành Sellbird từ bản 0.4.0, cùng dự án và cùng lịch sử. Cấu hình, dữ liệu và đăng nhập dashboard được chuyển sang tự động. README có mục hướng dẫn nâng cấp riêng cho người đang dùng Harvey.

Chuyển nhanh tới mục

  1. I.Sellbird làm được gì
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Cách dễ nhất: để Claude Code cài giúp
    2. B.Tự cài bằng tay: tạo môi trường và cài gói
    3. C.Điền thông tin đăng nhập
    4. D.Dạy Sellbird về sản phẩm của bạn
    5. E.Xác nhận khách hàng tốt trông như thế nào
    6. F.Tìm doanh nghiệp
    7. G.Mở dashboard và chạy vòng lặp
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ doanh nghiệp nhỏ muốn có danh sách khách tiềm năng
    2. B.Nhân viên sales duyệt thư mỗi sáng
    3. C.Người làm agency xử lý thư trả lời
    4. D.Lập trình viên muốn tuỳ biến theo cách bán của mình
  6. VI.Lỗi hay gặp và cách xử lý
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.