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

Sellbird: tự tìm khách, 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, 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, kiểm tra email, viết và gửi cold email rồi xử lý phản hồi. Nó chạy bằng gói Claude Pro/Max hoặc ChatGPT (Codex) bạn đang có, không cần API key của mô hình. Cài không quá khó nếu bạn đã quen terminal, và README còn có cách nhờ Claude Code cài hộ.

Sellbird là một công cụ 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): 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 thư riêng cho từng người, gửi đi và đọc phản hồi giúp bạn. Trước đây dự án tên là Harvey, nay đổi tên thành Sellbird, vẫn là một dự án và giữ nguyên lịch sử.

Bạn nên xem qua repo này nếu bạn làm kinh doanh nhỏ, làm dịch vụ B2B, làm agency, hoặc là dev muốn tự dựng hệ thống tiếp cận khách mà không trả tiền cho cả bộ công cụ như Apollo, ZoomInfo, Clearbit hay Clay. Theo README, Sellbird không dùng những công cụ đó. Hiện repo có khoảng 5250 sao và 1127 fork, và vẫn được cập nhật trong vài tháng gần đây.

Điểm đáng giá nhất có hai ý. Một: nó "suy nghĩ" qua Claude Code CLI trên gói Claude Pro/Max (hoặc 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. Hai: mặc định không email nào được gửi đi nếu bạn chưa duyệt. Bạn xem video ngắn bên dưới để thấy tổng quan, rồi quay lại đây làm theo từng bước.

Ứng dụng

ethanplusai/sellbird

Nền tảng outreach mã nguồn mở chạy trên máy bạn: tìm công ty, kiểm tra email, viết và gửi cold email cá nhân hoá, xử lý phản hồi bằng gói Claude/ChatGPT.

★ 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 dây chuyền. Bạn chạy trọn vòng hoặc dừng ở bước nào tuỳ ý.

  • 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í. Bạn cũng có thể chọn nguồn trả phí, và README nói mỗi lần tìm trả phí đều hiện chi phí trước khi chạy. Bạn không bị trừ tiền bất ngờ.
  • Tìm lý do họ sẽ mua. Nó đọc website của từng công ty để tìm các "tín hiệu mua" 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 và không tốn tiền, mỗi công ty chỉ cần ba request HTTP. Nhờ vậy email của bạn có nội dung cụ thể thay vì chung chung.
  • 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 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, và chỉ địa chỉ gửi được mới được dùng để gửi. Việc này giúp giảm thư trả về, thứ làm hỏng uy tín tên miền gửi.
  • 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, trong giới hạn gửi 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, soạn sẵn câu trả lời, gạt thư tự động trả lời sang một bên, tôn trọng yêu cầu từ chối nhận thư 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. Bạn sẽ có file CSV sẵn để đưa vào công cụ gửi thư khác.

Về an toàn, mỗi email gửi đi nằm trong hộp "Outbox" chờ bạn duyệt cho đến khi bạn tự bật chế độ autopilot. Trước khi gửi còn có một bước kiểm tra không dùng mô hình, loại những thư còn sót trường ghép (merge tag) chưa điền, có cụm từ bị cấm, quá dài, nhiều link thừa hoặc gửi tới địa chỉ không nhận đượ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 ý máy Mac đóng gói sẵn bản 3.9, nên nếu python3 --version báo 3.9 thì chạy brew install python@3.13 trước.
  • Claude Pro hoặc Max với CLI đã đăng nhập bằng claude login, hoặc gói ChatGPT có Codex CLI. Phần Codex có hướng dẫn riêng trong thư mục 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 chạy được. README ước tính khoảng 7 USD một tháng cho Google Workspace.
  • Warmup (làm nóng) hộp thư đó. README giới thiệu TrulyInbox, nói rằng Sellbird đọc tỷ lệ vào hộp thư đến của nó để báo khi nào bạn đã sẵn sàng gửi. Đây là link affiliate, tác giả có thể nhận hoa hồng. Bạn không bắt buộc dùng nó theo tư liệu, nhưng nên có một cách làm nóng hộp thư nào đó.

File .env.example liệt kê các biến cấu hình như GMAIL_CLIENT_ID, SMTP_HOST, M365_CLIENT_ID, REOON_API_KEY, HUNTER_API_KEY, TRULYINBOX_API_KEY... Bạn chỉ điền những biến ứng với dịch vụ bạn thật sự dùng. Mỗi biến đều có giải thích ngay trong file.

Về hệ điều hành, tư liệu nói rõ có thư mục dữ liệu cho macOS, Windows và Linux, và nói "trên Linux bạn cũng có thể chạy bằng Docker". Các lệnh trong README viết theo kiểu macOS/Linux. README chưa ghi lệnh riêng cho Windows, nên bạn dùng Windows nên đọc kỹ phần Troubleshooting trong docs của repo hoặc dùng cách nhờ Claude cài ở dưới.

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

  1. Tải mã nguồnDùng git clone rồi vào thư mục sellbird
  2. Cài góiTạo môi trường ảo Python 3.13 và chạy pip install -e .
  3. Điền thông tinSao chép .env.example thành .env rồi điền key bạn cần
  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. Mở dashboard và chạyChạy sellbird dashboard rồi sellbird run

A.Cách nhanh: để Claude cài giúp

README có một đường tắt. Bạn tải mã nguồn, vào thư mục, mở Claude Code:

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

Sau đó gõ "set up Sellbird for me". 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à dạy Sellbird về sản phẩm của bạn. Lệnh git clone tải mã về, cd sellbird vào thư mục vừa tải, claude mở Claude Code ngay trong thư mục đó. Lưu ý: bạn phải mở terminal và chạy claude đúng trong thư mục sellbird, vì Claude đọc file CLAUDE.md ở thư mục hiện tại.

B.Hoặc tự cài từng bước

Bước 1 là tạo môi trường ảo và cài gói. README nhấn mạnh dùng python3.13, không dùng python3 trần vì trên macOS đó có thể là bản 3.9:

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

Lệnh này tạo thư mục .venv, kích hoạt nó, rồi cài Sellbird ở chế độ chỉnh sửa được. Sau đó bạn có lệnh sellbird. Nếu về sau terminal báo không tìm thấy sellbird, thường là bạn chưa kích hoạt lại môi trường ảo ở cửa sổ terminal mới.

Bước 2 là điền thông tin đăng nhập:

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

Lệnh đầu sao chép file mẫu thành .env, lệnh sau mở file đó trong trình soạn thảo của bạn. Chỗ người mới hay vấp: key và mật khẩu phải điền vào file .env, không điền vào .env.example. Nếu bạn chưa dùng dịch vụ nào thì cứ để trống biến đó.

Bước 3 là cho Sellbird "học" sản phẩm của bạn từ website. Lệnh này ghi ra file sellbird.local.yaml:

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

Thay địa chỉ bằng website thật của công ty bạn.

Bước 4 là xác nhận thế nào là khách hàng tốt:

Terminal
sellbird signals --confirm free

Bước 5 là 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

Bước 6 là mở dashboard và khởi động vòng lặp:

Terminal
sellbird dashboard          # prints a private link to http://127.0.0.1:5555
sellbird run

Lệnh sellbird 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 đó bằng trình duyệt. Bạn nên giữ cửa sổ terminal chạy sellbird run, và mở thêm một cửa sổ khác nếu cần dùng lệnh khác.

Về Docker, README chỉ nói trên Linux có thể chạy bằng Docker, và repo có sẵn Dockerfile và docker-compose.yml. README chưa ghi lệnh Docker cho lần cài đầu, nên hãy xem trang hướng dẫn Docker trong thư mục docs của repo.

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, làm nóng hộp thư trước, và giữ chế độ duyệt tay (không bật autopilot) cho đến khi bạn đã quen. Không đưa file .env lên chỗ công khai vì trong đó có mật khẩu và key.

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

Cách đơn giản nhất là chạy sellbird run. README mô tả màn hình đúng sẽ trông như sau: dòng "Sellbird is online", rồi "Checking pipeline state...", rồi một dòng "Decision" cho biết bước tiếp theo, ví dụ viết chiến dịch cho các khách tiềm năng chưa có thư nháp. Tiếp theo là các dòng của những "nhân viên" con như handler, writer, outbox, cuối cùng là "Cycle complete" kèm thông báo nghỉ 15 phút rồi chạy vòng sau.

Bạn cũng nên mở dashboard bằng link do sellbird dashboard in ra. Nếu trang mở được ở địa chỉ 127.0.0.1:5555 thì phần giao diện đã chạy. Sau khi chạy sellbird discover, bạn nên thấy danh sách công ty trong dashboard, và email viết xong sẽ nằm ở Outbox chờ bạn duyệt. Thấy thư nằm chờ duyệt, chưa có gì gửi đi, tức là cơ chế an toàn đang hoạt động đúng.

Có nhắc sẵn: trong README, dữ liệu demo là dữ liệu bịa (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ếu bạn thấy những tên đó, đó là dữ liệu mẫu chứ không phải khách thật.

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

Sellbird không thay bạn hiểu khách hàng. Nó làm phần việc lặp đi lặp lại, còn quyết định cuối cùng vẫn là của bạn.

A.Chủ doanh nghiệp nhỏ muốn có danh sách khách mục tiêu

Bạn bán phần mềm đặt lịch cho các tiệm dịch vụ. Bạn chạy sellbird train với website của mình, xác nhận tín hiệu bằng sellbird signals --confirm free, rồi sellbird discover để tìm doanh nghiệp từ nguồn miễn phí. Sau khi nó tìm người quyết định và kiểm tra email, bạn chạy:

Terminal
sellbird export

Kết quả là một file CSV sẵn cho công cụ gửi thư bạn đang dùng. Cách này phù hợp nếu bạn đã có công cụ gửi và chỉ cần nguồn khách đã được kiểm tra email.

B.Người làm sales muốn gửi thư cá nhân hoá mà không viết tay từng thư

Bạn để Sellbird chạy cả vòng với sellbird run. Nó viết chuỗi thư ngắn cho từng người dựa trên điều đã đọc được ở website, ví dụ README mô tả ví dụ "công ty điện lạnh đang tuyển điều phối viên". Bạn mở Outbox trên dashboard, đọc từng thư, sửa nếu cần rồi mới duyệt gửi.

Không email nào rời máy bạn nếu bạn chưa gật đầu.

Ông T

Nhờ bước duyệt tay đó, bạn kiểm soát được giọng văn và tránh để thư lỗi đi ra ngoài trong những ngày đầu dùng thử.

C.Người phải trả lời khách phản hồi mỗi ngày

Khi đã có thư gửi đi, phản hồi sẽ về. Sellbird đọc từng thư, soạn sẵn câu trả lời, gạt thư tự động trả lời sang một bên, và xử lý ngay yêu cầu từ chối nhận thư. Những thư nó không nên tự trả lời sẽ được chuyển cho bạn. Trong ví dụ README, nó đánh dấu một người là "interested" (quan tâm) và một người là "objection" (phản đối), cả hai đều có sẵn câu trả lời nháp. Bạn mở dashboard, đọc và duyệt thay vì phải viết từ đầu.

D.Dev muốn tuỳ chỉnh playbook bán hàng

Repo có thư mục prompts/ và skills/ mà README nói là "all yours to edit", tức bạn tự sửa được. Bạn có thể chỉnh cách viết thư hoặc cách xử lý phản hồi cho hợp ngành mình. README cũng nhắc đến tài liệu Extensions để thêm route, bước chạy và lệnh từ một gói riêng. Nếu muốn đóng góp, bạn đọc CONTRIBUTING.md trước.

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, python3 có thể là bản 3.9 trong khi Sellbird cần 3.11 trở lên. Cách xử lý theo README: cài bản mới (brew install python@3.13) và dùng đúng python3.13 khi tạo môi trường ảo.

Gõ sellbird báo không tìm thấy lệnh. Thường do bạn mở terminal mới mà chưa kích hoạt lại môi trường ảo .venv, hoặc chưa chạy pip install -e .. Hãy vào lại thư mục sellbird, kích hoạt .venv và thử lại.

Claude CLI chưa đăng nhập. Sellbird dựa vào Claude Code CLI đã đăng nhập. Nếu nó không "suy nghĩ" được, hãy chạy claude login và kiểm tra gói Pro/Max của bạn còn hoạt động. Nếu bạn dùng ChatGPT, xem hướng dẫn Codex trong docs của repo.

Thư không gửi đi. Có thể thư đang nằm ở Outbox chờ bạn duyệt, đây là hành vi mặc định. Cũng có thể thư bị bước kiểm tra trước khi gửi giữ lại vì còn trường ghép chưa điền, quá dài, có link thừa hoặc địa chỉ không nhận được. Hãy mở Outbox, đọc lý do rồi sửa. Bạn cũng nên kiểm tra xem mình có lỡ chạy sellbird sending pause hay không.

Nâng cấp từ Harvey bị lỗi git pull. Nếu bạn từng sửa trực tiếp file harvey.yaml, git pull sẽ dừng với thông 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 và chạy git stash drop. Cách tốt hơn là đặt cấu hình của bạn trong sellbird.local.yaml, file mà git không đụng tới.

Nếu gặp lỗi khác, README trỏ tới tài liệu Troubleshooting trong thư mục docs.

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

Điểm mạnh. Bạn không trả tiền theo token vì dùng luôn gói Claude hoặc ChatGPT sẵn có. Nguồn tìm công ty mặc định miễn phí và việc đọc website không tốn tiền. Dữ liệu và cấu hình nằm trên máy bạn. Mặc định có bước duyệt tay và bước kiểm tra trước khi gửi, nên an toàn hơn nhiều công cụ tự động hoàn toàn. Dự án còn được cập nhật, có tài liệu riêng cho từng phần.

Giới hạn. Bạn vẫn phải có hộp thư gửi, tên miền gửi và làm nóng hộp thư, nghĩa là có chi phí và thời gian chuẩn bị. Các ví dụ và lệnh trong README thiên về macOS/Linux, người dùng Windows sẽ phải tự mò thêm. Gửi cold email chịu các quy định pháp lý và yêu cầu về khả năng nhận thư, README có hẳn một trang "Legal and deliverability" để bạn đọc kỹ trước khi gửi, đặc biệt nếu bạn gửi cho khách ở nước khác. Giấy phép là AGPL-3.0 (các bản Harvey đến 0.3.x dùng MIT), nên nếu bạn định dựng dịch vụ thương mại trên mã này, hãy đọc kỹ điều khoản.

Khi nào chọn cách khác. Nếu bạn không muốn tự vận hành, tác giả có bản chạy sẵn trên sellbird.ai (đang ở giai đoạn truy cập sớm). Nếu bạn chỉ cần vài chục khách mỗi tháng và đã có công cụ ưa thích, chỉ cần sellbird export hoặc làm tay có thể là đủ. Còn nếu bạn chưa có gói Claude Pro/Max hay ChatGPT có Codex, repo này không phù hợp theo cách thiết kế hiện tại.

4.8/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 miễn phí, giấy phép AGPL-3.0. Nguồn tìm công ty mặc định (OpenStreetMap) và việc đọc website đều $0. Bạn vẫn cần gói Claude Pro/Max hoặc ChatGPT có Codex, một hộp thư gửi (README nêu khoảng 7 USD một tháng cho Google Workspace), và có thể trả phí cho nguồn tìm kiếm trả phí nếu chọn.

Có cần API key của mô hình AI 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ố dịch vụ phụ như kiểm tra email có biến key riêng trong .env.example, nhưng bạn chỉ điền khi dùng.

Cần GPU hoặc máy mạnh không?

Tư liệu không nhắc yêu cầu GPU hay cấu hình phần cứng. Mô hình chạy qua Claude hoặc Codex nên nặng việc không nằm 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ó nêu thư mục dữ liệu cho Windows (%APPDATA%\sellbird), nhưng các lệnh cài đặt viết theo kiểu macOS/Linux và Docker chỉ được nói là dùng được trên Linux. README chưa ghi cách cài riêng cho Windows, bạn nên xem phần Troubleshooting trong thư mục docs hoặc nhờ Claude Code hướng dẫn.

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

Mặc định là không. Mọi email nằm ở 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ủa tôi lưu ở đâu, có an toàn không?

README nói cấu hình, kiến thức và dữ liệu nằm trong một thư mục riêng trên máy bạn, gồm cơ sở dữ liệu, log và token dashboard. Dashboard mở ở địa chỉ nội bộ 127.0.0.1:5555. Tư liệu không nói thêm về mã hoá hay các cam kết bảo mật khác, nên bạn nên tự bảo vệ file .env và đọc SECURITY.md của repo.

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

Harvey được đổi tên thành Sellbird từ bản 0.4.0 và cấu hình, dữ liệu, đăng nhập dashboard của bạn được giữ lại. Bạn chạy `git pull`, rồi `pip install -e .` một lần để có lệnh `sellbird`, và chạy `sellbird dashboard`. Lệnh `harvey` cũ vẫn chạy tạm thời nhưng sẽ bị bỏ ở bản sau.

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 giúp
    2. B.Hoặc tự cài từng bước
  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 mục tiêu
    2. B.Người làm sales muốn gửi thư cá nhân hoá mà không viết tay từng thư
    3. C.Người phải trả lời khách phản hồi mỗi ngày
    4. D.Dev muốn tuỳ chỉnh playbook 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ỏ.