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 là Harvey) là nền tảng outreach mã nguồn mở viết bằng Python. Nó tìm công ty phù hợp, tìm người quyết định, xác minh email, viết cold email và xử lý thư trả lờ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 vài lệnh, mặc định không có email nào được gửi khi bạn chưa duyệt.

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 chủ động: 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 cá nhân hoá, gửi đi và xử lý thư trả lời. Repo này trước đây tên Harvey, nay đã đổi tên nhưng vẫn là cùng một dự án.

Bạn nên xem qua nếu đang bán dịch vụ cho doanh nghiệp nhỏ (phòng khám, thợ xây, cửa hàng, agency…) và muốn có danh sách khách tiềm năng cùng email mở đầu mà không phải thuê thêm người làm tay. Lập trình viên mới cũng dùng được, vì repo có sẵn hướng dẫn để Claude Code cài hộ bạn.

Điểm đáng giá nhất là hai chuyện. Thứ nhất, Sellbird dùng gói Claude Pro/Max (hoặc gói ChatGPT với Codex) mà bạn đang trả, nên không có hoá đơn API tính theo token. Thứ hai, mặc định không email nào rời máy bạn nếu bạn chưa bấm duyệt. Bạn có thể xem video ngắn bên dưới để thấy cách nó chạy, rồi quay lại đọc phần cài đặt.

Ứng dụng

ethanplusai/sellbird

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ý thư trả lời.

★ 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 vòng hoặc dừng ở bước nào tuỳ ý.

  • Tìm công ty. 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. Bạn 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 website của từng công ty để tìm những 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, hoặc đang tuyển một vị trí nào đó. Bước này không gọi mô hình AI nên không tốn thêm gì. README nói 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 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 địa chỉ email của công ty và xác minh 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 dùng để gửi. Việc này giúp bạn tránh gửi vào địa chỉ chết và giữ uy tín tên miền gửi 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ố thư mỗi ngày và theo giờ làm việc của người nhận.
  • Xử lý thư trả lời. Nó đọc mọi thư trả lời và soạn sẵn câu đáp. Thư tự động trả lời được xếp riêng, yêu cầu từ chối nhận thư đượ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, hãy dừng sau bước xác minh và chạy sellbird export. Bạn sẽ có file CSV sẵn để nạp vào công cụ gửi thư khác.

Ngoài ra còn có bảng điều khiển (dashboard) mở trên máy bạn, và hộp Outbox chứa các email chờ duyệt. Trước khi gửi, một bước kiểm tra không dùng mô hình sẽ loại các email có merge tag chưa điền, cụm từ bị cấm, email quá dài, quá nhiều 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 từ 3.11. README lưu ý macOS đi kèm Python 3.9, nên nếu python3 --version báo bản cũ thì chạy brew install python@3.13 trước.
  • Claude Pro hoặc Max và đã đăng nhập Claude Code CLI bằng claude login. Hoặc gói ChatGPT có Codex CLI, README có hướng dẫn riêng cho cách này trong tài liệu về 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. README ước tính Google Workspace khoảng 7 USD một tháng.
  • Warmup (làm nóng) hộp thư. README khuyên dùng TrulyInbox để làm nóng hộp thư mới trước khi gửi cold email. Đây là link giới thiệu, người duy trì dự án có thể nhận hoa hồng. Đây là gợi ý của tác giả, không bắt buộc về mặt kỹ thuật.
  • Git để tải mã nguồn.

Về phần cứng, README không nêu yêu cầu đặc biệt như GPU. Nguồn tìm công ty mặc định là miễn phí. Các nguồn trả phí rẻ nhất mà README nhắc đến khoảng 0,37 USD cho 1.000 công ty.

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ụ xác minh email (Reoon, ZeroBounce, Hunter), TrulyInbox… Bạn chỉ điền phần mình thực sự dùng. Mỗi biến đều có chú thích ngay trong file.

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

  1. Tải mã nguồngit clone về máy và vào thư mục sellbird
  2. Cài đặtTạo môi trường ảo Python rồi pip install -e .
  3. Điền thông tinSao chép .env.example thành .env và điền hộp thư
  4. Dạy Sellbird về sản phẩmChạy sellbird train với website của bạn
  5. Tìm kháchXác nhận tín hiệu rồi chạy sellbird discover
  6. Bật bảng điều khiểnChạy sellbird dashboard và sellbird run

README đưa ra hai đường: nhờ Claude cài hộ, hoặc tự làm. Người mới nên thử đường thứ nhất.

A.Cách nhanh: để Claude cài hộ

Mở terminal (trên Windows là PowerShell hoặc Windows Terminal), chạy ba lệnh sau. Lệnh đầu tải mã nguồn, lệnh hai đi vào thư mục, lệnh 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. File CLAUDE.md trong repo biến Claude Code thành người hướng dẫn cài đặt: nó kiểm tra máy bạn, 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. Chỗ người mới hay vấp là chạy claude ở sai thư mục. Hãy chắc là bạn đã cd sellbird rồi.

B.Hoặc tự cài: tạo môi trường và cài gói

Lệnh dưới đây lấy nguyên văn từ README. README dặn dùng python3.13 chứ đừng dùng python3 trần, vì trên macOS python3 trần là bản 3.9.

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

Lệnh này làm ba việc: tạo môi trường ảo .venv, kích hoạt nó, rồi cài Sellbird ở chế độ chỉnh sửa được. Sau đó bạn có lệnh sellbird. Lệnh trên theo kiểu macOS/Linux. README chưa ghi riêng cách kích hoạt trên Windows. Với PowerShell, cách kích hoạt môi trường ảo phổ thông của Python là .venv\Scripts\Activate.ps1, sau đó chạy pip install -e .. Nếu bạn dùng Windows và gặp rắc rối, hãy xem mục Troubleshooting trong thư mục docs/ của repo.

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

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

Lệnh này sao chép file mẫu thành .env rồi mở ra để sửa. Thay $EDITOR bằng trình soạn thảo bạn quen (Notepad, VS Code…). Trên Windows, bạn có thể sao chép file thủ công rồi đổi tên thành .env. Điền thông tin hộp thư gửi (Gmail, Microsoft 365 hoặc SMTP). Dịch vụ nào không dùng thì cứ để trống.

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

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

Thay địa chỉ bằng website của bạn. Sellbird đọc trang web để hiểu bạn bán gì và ghi kết quả vào file sellbird.local.yaml. File này là của riêng bạn, git không đụng đến, nên cập nhật sau này sẽ không ghi đè.

E.Xác nhận tín hiệu và tìm doanh nghiệp

Terminal
sellbird signals --confirm free
sellbird discover

Lệnh đầu xác nhận điều gì làm nên một khách tiềm năng tốt. Lệnh sau tìm doanh nghiệp, mặc định dùng nguồn miễn phí, không cần tài khoản.

F.Mở bảng điều khiển và chạy vòng lặp

Terminal
sellbird dashboard
sellbird run

sellbird dashboard in ra một link riêng tư tới http://127.0.0.1:5555. Đây là địa chỉ trên chính máy bạn. sellbird run khởi động vòng lặp chính: kiểm tra trạng thái, viết chiến dịch, soạn câu trả lời rồi nghỉ 15 phút trước vòng kế tiếp. Hãy để cửa sổ terminal này mở trong khi chạy.

README còn nói 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 tài liệu Docker trong docs/.

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

Sau khi sellbird run chạy, README mô tả màn hình mong đợi như sau:

  • Dòng “Sellbird is online.”
  • Dòng “Checking pipeline state...” kèm quyết định tiếp theo, ví dụ viết chiến dịch cho các prospect mới chưa có bản nháp.
  • Các dòng cho biết bộ xử lý thư trả lời và bộ viết email đang làm gì.
  • Dòng báo có bao nhiêu email đang chờ bạn duyệt trong Outbox.
  • Cuối cùng là “Cycle complete. Sleeping for 15 minutes.”

Bạn cũng nên mở link do sellbird dashboard in ra. Nếu trang bảng điều khiển hiện lên và bạn thấy các email nằm trong Outbox chờ duyệt, tức là mọi thứ đã thông. Nếu muốn dừng ngay, chạy sellbird sending pause để dừng toàn bộ việc gửi.

Mặc định mọi email nằm trong Outbox chờ bạn duyệt. Chỉ bật autopilot khi bạn đã đọc kỹ vài chục email mẫu và hiểu quy định về cold email ở nơi người nhận sinh sống. README có tài liệu riêng về “Legal and deliverability”. Hãy đọc trước khi gửi hàng loạt. Đừng bao giờ dán mật khẩu hộp thư vào file nào bạn định đưa lên mạng.

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

Bạn không cần thêm công cụ tìm khách tốn tiền, chỉ cần gói AI bạn đã trả và một hộp thư được làm nóng.

Ông T

A.Chủ agency muốn có danh sách khách nhanh

Bối cảnh: bạn làm dịch vụ website cho các phòng khám nha khoa và cần danh sách khách tiềm năng, nhưng chưa muốn gửi thư.

Cách làm: chạy sellbird train với website của bạn, rồi sellbird signals --confirm free và sellbird discover. Sau khi xác minh xong, chạy:

Terminal
sellbird export

Kết quả: một file CSV gồm công ty, người quyết định và địa chỉ email kèm nhãn verified, risky, guess hoặc invalid. Bạn lọc những địa chỉ verified rồi nạp vào công cụ gửi thư mình đang dùng.

B.Chủ doanh nghiệp nhỏ gửi cold email có kiểm soát

Bối cảnh: bạn bán phần mềm đặt lịch hẹn và muốn tiếp cận các cửa hàng chưa có đặt lịch online. Bạn không muốn máy tự gửi thư lung tung.

Cách làm: sau khi train và discover, mở dashboard và chạy sellbird run. Sellbird viết chuỗi email ngắn cho từng người, dựa trên tín hiệu như “chưa có đặt lịch online”. Các email nằm ở Outbox. Bạn đọc từng cái, sửa nếu cần rồi duyệt.

Kết quả: email đi từ hộp thư của bạn, trong giới hạn số thư mỗi ngày và giờ làm việc của người nhận. Bước kiểm tra trước khi gửi sẽ chặn email còn sót merge tag hoặc có link lạ.

C.Nhân viên kinh doanh xử lý thư trả lời

Bối cảnh: sau vài ngày gửi, hộp thư có nhiều phản hồi lẫn lộn: người quan tâm, người phản đối, thư tự động báo vắng mặt, người xin ngừng gửi.

Cách làm: để sellbird run tiếp tục chạy. Theo mô tả của README, nó đọc từng thư trả lời, soạn sẵn câu đáp cho thư quan tâm hoặc phản đối, xếp riêng thư tự động trả lời và tôn trọng yêu cầu ngừng gửi ngay lập tức. Việc gì nó không nên tự trả lời thì nó chuyển cho bạn.

Kết quả: bạn chỉ mở dashboard, đọc bản nháp rồi gửi hoặc chỉnh. Bạn tập trung vào những người thật sự muốn nói chuyện.

D.Lập trình viên tuỳ chỉnh kịch bản bán hàng

Bối cảnh: bạn là dev và muốn đổi giọng văn hoặc thêm bước mới vào vòng lặp.

Cách làm: README cho biết thư mục prompts/ và skills/ là của bạn để sửa, và có tài liệu “Extensions” hướng dẫn thêm route, bước heartbeat hay lệnh từ một gói riêng. Bạn cũng có thể đọc tài liệu về “Skills and sub-agents” để biết agent nào dùng kịch bản nào.

Kết quả: Sellbird viết theo phong cách của bạn. Nếu cài bằng pip hoặc pipx, README nói các bản sửa của bạn được giữ nguyên khi nâng cấp.

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

1. Lệnh sellbird không được nhận ra. Thường do bạn chưa kích hoạt môi trường ảo hoặc đã mở terminal mới. Hãy kích hoạt lại môi trường ảo trong thư mục sellbird rồi thử lại. Nếu vẫn lỗi, chạy lại pip install -e . trong thư mục repo.

2. Python quá cũ. Sellbird cần Python 3.11 trở lên. Nếu python3 --version báo 3.9 (thường gặp trên macOS), hãy cài bản mới theo gợi ý của README rồi tạo lại môi trường ảo bằng python3.13, đừng dùng python3 trần.

3. Claude Code chưa đăng nhập. Sellbird “suy nghĩ” qua Claude Code CLI nên cần bạn đăng nhập trước bằng claude login với gói Pro hoặc Max. Nếu dùng ChatGPT, hãy làm theo tài liệu Codex của repo.

4. Nâng cấp từ Harvey bị git chặn. Nếu bạn từng sửa trực tiếp file harvey.yaml, lệnh git pull sẽ báo “your local changes would be overwritten”. README hướng dẫn chạy git stash, git pull, rồi git stash pop. Nếu có xung đột, giữ các dòng của bạn, xoá dấu xung đột, rồi git stash drop. Về lâu dài, hãy đặt cấu hình riêng trong sellbird.local.yaml.

5. Email vào spam hoặc bị trả lại. Với cold email, đây là rủi ro thật chứ không riêng gì Sellbird. Hãy gửi từ một tên miền riêng, làm nóng hộp thư trước, giữ số thư mỗi ngày thấp và chỉ gửi đến địa chỉ verified. Xem tài liệu “Legal and deliverability” của repo để biết thêm.

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

Điểm mạnh. Sellbird chạy trên máy bạn, dùng gói AI bạn đã có nên không có hoá đơn API theo token, và nguồn tìm công ty mặc định miễn phí. Việc gửi thư mặc định cần bạn duyệt, lại có bước kiểm tra trước khi gửi và lệnh sellbird sending pause để dừng tức thì. Mã nguồn mở, hiện có khoảng 5.250 sao và 1.127 fork trên GitHub. Repo vẫn được cập nhật trong vài tháng gần đây.

Giới hạn. Bạn vẫn phải có hộp thư gửi, nên nhớ chi phí khoảng 7 USD một tháng nếu dùng Google Workspace, và nên cân nhắc thêm dịch vụ warmup. Đây là công cụ dòng lệnh, nên người chưa từng dùng terminal sẽ cần thời gian làm quen, dù đường “để Claude cài hộ” giúp nhiều. Nguồn tìm công ty miễn phí là OpenStreetMap, nên độ phủ phụ thuộc vào dữ liệu ở khu vực bạn nhắm tới. README chưa nói gì về chất lượng dữ liệu riêng cho thị trường Việt Nam. Giấy phép là AGPL-3.0, 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ó những quy định pháp lý khác nhau tuỳ quốc gia, và công cụ không thay bạn chịu trách nhiệm.

Khi nên chọn cách khác. Nếu bạn không muốn tự vận hành, README nhắc đến bản hosted tại trang chủ dự án, đang ở 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 thư cho danh sách khách có sẵn, một công cụ email marketing thông thường có thể đơn giản hơn. Còn nếu bạn muốn tự động hoá toàn bộ chuỗi từ tìm khách đến trả lời mà vẫn giữ quyền duyệt, Sellbird là lựa chọn đáng thử.

4.0/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?

Phần mềm là mã nguồn mở theo giấy phép AGPL-3.0. Nguồn tìm công ty mặc định là OpenStreetMap, miễn phí. 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 ước tính Google Workspace khoảng 7 USD một tháng.

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 hoặc Max, hoặc qua 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ụ tuỳ chọn khác như xác minh email có biến API key riêng trong .env.example.

Có cần GPU không?

Tư liệu không nêu yêu cầu GPU hay phần cứng đặc biệt. Phần suy nghĩ của AI chạy qua Claude Code hoặc Codex chứ không chạy mô hình trên máy bạn. Yêu cầu được nêu rõ 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, nghĩa là có hỗ trợ. Tuy nhiên các lệnh cài trong README viết theo kiểu macOS/Linux, và README chưa ghi riêng lệnh cho Windows. Mục Docker trong README chỉ nhắc đến Linux.

Sellbird 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 tới khi chính bạn bật autopilot. 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 nằm ở đâu, có an toàn không?

README nói 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, bảng điều khiển mở ở địa chỉ 127.0.0.1 trên máy bạn. Tư liệu không nói gì thêm về các đánh giá bảo mật. Nếu phát hiện lỗ hổng, repo hướng dẫn làm theo SECURITY.md.

Tôi đang dùng Harvey thì nâng cấp thế nào?

Harvey được đổi tên thành Sellbird từ phiên bản 0.4.0. Bạn chạy git pull, pip install -e . một lần rồi sellbird dashboard. README nói cấu hình, dữ liệu và đăng nhập dashboard được giữ nguyên, các biến HARVEY_* vẫn dùng được khi chưa có biến SELLBIRD_* tương ứng.

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 nhanh: để Claude cài hộ
    2. B.Hoặc tự cài: 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 tín hiệu và tìm doanh nghiệp
    6. F.Mở bảng điều khiển 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ủ agency muốn có danh sách khách nhanh
    2. B.Chủ doanh nghiệp nhỏ gửi cold email có kiểm soát
    3. C.Nhân viên kinh doanh xử lý thư trả lời
    4. D.Lập trình viên tuỳ chỉnh kịch bản bán hàng
  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ỏ.