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/ChatGPT — hướng dẫn cài đặt và dùng

11 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/ChatGPT — 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 (Codex) bạn đang có thay vì API key. Cài cần Python 3.11 trở lên và khá vừa tay: có thể nhờ Claude Code cài giúp hoặc tự chạy khoảng sáu lệnh.

Sellbird là một nền tảng mã nguồn mở chạy ngay trên máy của bạn, làm trọn chuỗi việc bán hàng bằng 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 từng email cá nhân hoá, gửi đi và xử lý thư trả lời. Trước đây dự án tên là Harvey, nay đổi tên thành Sellbird nhưng vẫn là cùng một dự án.

Điểm khiến mình thấy đáng chú ý nhất là cách nó “suy nghĩ”. Sellbird không đòi API key của mô hình AI và không tính tiền theo token. Nó chạy qua Claude Code CLI trên gói Claude Pro hoặc Max, hoặc qua Codex trên gói ChatGPT mà bạn đang trả sẵn. Mặc định, không email nào được gửi đi nếu bạn chưa duyệt.

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 vài tháng gần đây. Phù hợp với chủ doanh nghiệp nhỏ, người làm sales, agency, hoặc lập trình viên muốn tự chủ công cụ outreach thay vì thuê nhiều dịch vụ riêng lẻ. Xem video ngắn bên dưới để thấy nhanh nó vận hành ra sao.

Ứng dụng

ethanplusai/sellbird

Sellbird là 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 ra quyết định, kiểm tra email, viết và gửi cold email, 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 dây chuyền, bạn có thể chạy hết hoặc dừng ở bất kỳ bước nào.

  • Tìm công ty. 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à mỗi lần tìm có trả phí đều hiện chi phí trước khi chạy. Nhờ vậy bạn không bị bất ngờ về tiền.
  • Tìm lý do họ sẽ mua. Đọc chính website của từng công ty để tìm tín hiệu mua hàng 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 chi phí.
  • Tìm người quyết định. Lấy chủ hoặc quản lý được nêu trên trang của công ty, tối đa hai người mỗi công ty.
  • Kiểm tra địa chỉ email. Học mẫu email của công ty rồi xác minh một địa chỉ. Mỗi địa chỉ được gắn nhãn verified, risky, guess hoặc invalid, và chỉ địa chỉ có thể nhận thư mới được gửi tới. Điều này giúp bảo vệ tên miền gửi của bạn khỏi bị đánh dấu spam.
  • Viết và gửi. 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ý thư trả lời. Đọc mọi thư trả lời, soạn sẵn câu trả lời, gạt thư tự động 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ư không nên tự trả lời.

Nếu bạn chỉ cần danh sách khách, hãy dừng sau bước xác minh và chạy sellbird export để có file CSV sẵn nhập vào công cụ gửi email khác.

Ngoài ra còn có lớp an toàn: trước khi gửi có bước kiểm tra không dùng mô hình, loại bỏ email còn sót merge tag chưa điền, cụm từ bị cấm, email 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ứ ngay lập tứ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 đó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.
  • Một gói AI có sẵn: Claude Pro hoặc Max với CLI đã đăng nhập bằng claude login, hoặc gói ChatGPT có Codex CLI (README có hướng dẫn riêng cho Codex).
  • Một hộp thư để gửi đ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) 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. Đây là liên kết affiliate, tác giả có thể nhận hoa hồng. Đây chỉ là gợi ý, không bắt buộc phải dùng.

Về hệ điều hành, README đưa ví dụ cho macOS và Linux, đồng thời có thư mục dữ liệu cho Windows (%APPDATA%\sellbird). Docker được ghi là chạy trên Linux. Tư liệu không nói gì về yêu cầu GPU hay phần cứng riêng.

Các khoá khác như Hunter, ZeroBounce, Reoon, TrulyInbox, Instantly, Cloudflare nằm trong file .env.example dưới dạng tuỳ chọn, bạn chỉ điền cái nào cần dùng.

Cold email có rủi ro thật: tên miền bị đánh dấu spam, và có quy định pháp lý ở từng nước. Hãy đọc tài liệu Legal and deliverability trong thư mục docs/ của repo trước khi gửi hàng loạt. Nên dùng tên miền gửi riêng, đừng dùng tên miền chính của công ty.

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

  1. Tải mã nguồnClone repo về máy và vào thư mục
  2. Cài đặtTạo môi trường ảo và cài gói sellbird
  3. Điền thông tinSao chép .env.example thành .env và điền
  4. Dạy SellbirdCho nó đọc website sản phẩm của bạn
  5. Chọn tín hiệu và tìm kháchXác nhận tín hiệu rồi chạy discover
  6. Mở bảng điều khiểnBật dashboard và chạy vòng lặp

README đưa ra hai cách: nhờ Claude cài giúp, hoặc tự làm. Mình đi cả hai.

A.Cách dễ nhất: để Claude cài giúp

Mở terminal (trên Windows là PowerShell hoặc Git Bash) ở nơi bạn muốn lưu dự án, rồi chạy:

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

Lệnh đầu tải mã về, lệnh thứ hai vào thư mục, lệnh thứ ba mở Claude Code ngay trong thư mục đó. Bạn cần đã cài và đăng nhập Claude Code trước. Sau đó gõ “set up Sellbird for me”. Theo README, file CLAUDE.md của 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 và dạy Sellbird về sản phẩm của bạn. Người mới nên chọn cách này.

B.Cài thủ công: tạo môi trường và cài gói

Nếu muốn tự làm, vẫn ở trong thư mục sellbird, chạy:

Terminal
# 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ôi trường ảo .venv, kích hoạt nó rồi cài Sellbird ở chế độ chỉnh sửa được (-e). Dùng python3.13 chứ đừng dùng python3 trần vì trên macOS nó có thể là bản 3.9. Lệnh kích hoạt source .venv/bin/activate là kiểu macOS/Linux. README chưa ghi lệnh kích hoạt riêng cho Windows PowerShell, bạn có thể dùng Git Bash hoặc nhờ Claude Code cài theo cách trên.

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

Terminal
# 2. Add credentials. Every variable is documented inline.
cp .env.example .env && $EDITOR .env

Lệnh sao chép file mẫu thành .env rồi mở bằng trình soạn thảo của bạn. Mỗi biến đều có chú thích ngay trong file. Với hộp thư Gmail bạn sẽ gặp GMAIL_CLIENT_ID và GMAIL_CLIENT_SECRET. Với SMTP là SMTP_HOST, SMTP_PORT, SMTP_USERNAME, SMTP_PASSWORD, cùng nhóm IMAP_* để đọc thư trả lời. Chỗ người mới hay vấp: $EDITOR chỉ chạy nếu máy bạn đã đặt trình soạn thảo mặc định. Nếu báo lỗi, cứ mở file .env bằng Notepad hoặc VS Code rồi điền tay.

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

Terminal
# 3. Learn your product from your website (writes sellbird.local.yaml).
sellbird train https://your-company.com

Thay địa chỉ bằng website công ty bạn. Lệnh đọc website và ghi cấu hình vào sellbird.local.yaml. File này git không đụng tới, nên bạn nâng cấp mà không mất cài đặt.

E.Xác nhận tín hiệu và tìm khách

Terminal
# 4. Confirm what makes a good prospect.
sellbird signals --confirm free

# 5. Find businesses. The default source is free and needs no account.
sellbird discover

Bước 4 xác nhận loại tín hiệu cho thấy một công ty là khách tốt. Bước 5 tìm doanh nghiệp bằng nguồn mặc định, miễn phí và không cần tài khoản.

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

Terminal
# 6. Open the dashboard and start the loop.
sellbird dashboard          # prints a private link to http://127.0.0.1:5555
sellbird run

sellbird dashboard in ra một đường dẫn riêng tới địa chỉ http://127.0.0.1:5555 trên máy bạn. Hãy mở link đó trong trình duyệt. Sau đó sellbird run khởi động vòng lặp chính, chạy liên tục nên hãy để cửa sổ terminal đó mở, và mở thêm cửa sổ khác nếu cần gõ lệnh khác.

README cũng nói trên Linux bạn có thể chạy bằng Docker (repo có Dockerfile và docker-compose.yml). Chi tiết nằm ở tài liệu Docker trong docs/.

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

Sau khi chạy sellbird run, README mô tả màn hình mong đợi: dòng “Sellbird is online.”, rồi dòng “Checking pipeline state...”, tiếp theo là một quyết định (ví dụ viết chiến dịch cho các prospect mới chưa có bản nháp) và danh sách việc của từng thành phần. Cuối cùng có “Cycle complete. Sleeping for 15 minutes.” Tức là mỗi chu kỳ chạy xong rồi nghỉ 15 phút.

Ví dụ trong README có dòng “outbox → 5 emails waiting for your approval”. Đó là dấu hiệu tốt: email nằm chờ bạn duyệt trong Outbox, chưa gửi đi.

Bạn cũng nên mở dashboard ở địa chỉ http://127.0.0.1:5555 bằng link riêng mà lệnh in ra. Nếu thấy giao diện và danh sách công ty vừa tìm được, nghĩa là cài thành công. Dữ liệu demo trong repo là 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ên đừng nhầm đó là khách thật.

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 phần mềm đặt lịch cho phòng khám nha khoa. Bạn chưa muốn gửi email, chỉ cần danh sách. Chạy lần lượt sellbird train với website của bạn, sellbird signals --confirm free, sellbird discover, rồi sau khi dây chuyền xác minh email xong thì chạy:

Terminal
sellbird export

Kết quả là file CSV gồm các công ty, người quyết định và địa chỉ đã gắn nhãn verified, risky, guess hoặc invalid. Bạn có thể đưa vào công cụ gửi mail quen thuộc. Nguồn tìm mặc định là OpenStreetMap nên bước này không tốn tiền.

Không email nào rời máy bạn nếu bạn chưa bấm duyệt.

Ông T

B.Người làm sales duyệt từng email trước khi gửi

Bạn muốn AI viết nhưng mình là người quyết định. Cứ để chế độ mặc định, mọi email sẽ chờ trong Outbox. Mở dashboard, đọc từng email, sửa nếu cần rồi duyệt. Email chỉ đ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à giờ làm việc của người nhận. Nếu thấy có gì sai, gõ sellbird sending pause để dừng toàn bộ.

C.Agency xử lý thư trả lời

Sau khi chiến dịch chạy, thư trả lời về dồn dập. Sellbird đọc từng thư, phân loại (ví dụ quan tâm hay phản đối), soạn sẵn câu trả lời, gạt thư tự động sang một bên và ghi nhận ngay những ai xin từ chối. Những thư nó không nên tự trả lời sẽ được chuyển cho bạn. Việc của bạn là mở dashboard, đọc bản nháp và gửi.

D.Lập trình viên mới muốn dựng thử và tuỳ biến

Nếu bạn quen code, hãy để Claude Code hướng dẫn bằng câu lệnh mẫu:

text
set up Sellbird for me

Sau đó vào các thư mục prompts/ và skills/ để chỉnh cách viết email và các kịch bản bán hàng. README nói chúng đều có thể chỉnh sửa, và với bản cài bằng pip thì các chỉnh sửa này được giữ khi nâng cấp.

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

Báo Python quá cũ hoặc lệnh cài lỗi trên macOS. Nguyên nhân thường là python3 trần là bản 3.9. Cài Python 3.13 bằng brew install python@3.13 rồi dùng python3.13 như README hướng dẫn.

Gõ sellbird báo không tìm thấy lệnh. Thường do môi trường ảo chưa được kích hoạt hoặc bạn mở terminal mới. Hãy vào lại thư mục dự án và kích hoạt lại .venv, rồi chạy lại. Nếu vẫn lỗi, xem tài liệu Troubleshooting trong docs/.

Claude CLI chưa đăng nhập. Sellbird dùng Claude Code CLI qua gói của bạn, nên cần chạy claude login trước. Với ChatGPT thì làm theo tài liệu Codex setup.

Email gửi không được hoặc rơi vào spam. Thường do hộp thư chưa warmup hoặc dùng tên miền chính. Hãy dùng tên miền gửi riêng, làm nóng hộp thư trước (README gợi ý TrulyInbox) và đọc tài liệu Legal and deliverability. Đừng tăng giới hạn gửi mỗi ngày quá nhanh.

Nâng cấp từ Harvey mà git pull báo “your local changes would be overwritten”. Điều này xảy ra khi bạn đã 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 có xung đột trong sellbird.yaml, giữ các dòng của bạn, xoá dấu xung đột rồi chạy git stash drop. Về lâu dài hãy đặt cài đặt vào sellbird.local.yaml.

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

Điểm mạnh rõ nhất là không phải trả tiền token cho mô hình AI, vì Sellbird dùng gói Claude hoặc ChatGPT bạn đã có. Nó chạy trên máy bạn, mặc định chờ bạn duyệt trước khi gửi, có bước kiểm tra an toàn trước khi gửi và có thể tạm dừng ngay. Phần tìm khách bằng nguồn mặc định miễn phí, và mỗi lần tìm có trả phí đều báo giá trước. Mã nguồn mở, bạn chỉnh được prompt và kịch bản bán hàng.

Giới hạn cũng cần nói thẳng. Bạn vẫn cần một hộp thư gửi, nên có chi phí (README ví dụ khoảng 7 đô la một tháng cho Google Workspace), cùng công sức làm nóng hộp thư. Dữ liệu demo xoay quanh khách hàng doanh nghiệp địa phương, nên bạn nên thử kỹ xem nguồn dữ liệu có đủ cho thị trường của mình không. Tư liệu không nói gì về độ phủ dữ liệu ở Việt Nam, và mình cũng chưa có thông tin đó. Giấy phép là AGPL-3.0, cần cân nhắc nếu bạn định tích hợp vào sản phẩm thương mại.

Nếu bạn không muốn tự vận hành, dự án có bản chạy sẵn trên sellbird.ai (đang truy cập sớm). Còn nếu chỉ cần gửi vài chục email thủ công, một công cụ email đơn giản hơn có thể hợp hơn. Nếu bạn muốn một dây chuyền tự động có người duyệt cuối, 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 (OpenStreetMap) miễn phí và bước đọc website không tốn tiền. Bạn vẫn cần gói Claude Pro/Max hoặc ChatGPT, và một hộp thư gửi (README ví dụ khoảng 7 đô la một tháng cho Google Workspace).

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

Không. README nói Sellbird dùng Claude Code CLI trên gói Claude Pro hoặc Max, hoặc Codex trên gói ChatGPT, không có API key và không tính tiền theo token. Một số nguồn dữ liệu hoặc dịch vụ kiểm tra email tuỳ chọn có biến API key riêng trong file .env.example.

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

Tư liệu không nói về yêu cầu phần cứng hay GPU. Phần suy luận chạy qua Claude hoặc Codex chứ không chạy mô hình trên máy bạn, nên chưa thấy lý do cần GPU, nhưng đây là suy luận chứ README không khẳng định.

Chạy được trên Windows không?

README có đề cập thư mục dữ liệu cho Windows (%APPDATA%\sellbird), nhưng các ví dụ lệnh viết theo kiểu macOS/Linux. Docker được ghi là dùng trên Linux. README chưa ghi lệnh kích hoạt môi trường ảo riêng cho Windows.

Email có tự gửi đi mà tôi không kiểm soát không?

Mặc định thì không. Mọi email chờ trong Outbox để bạn duyệt cho tới khi bạn tự bật chế độ 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.

Sellbird khác gì Harvey?

Đó là cùng một dự án, Harvey đượ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 giữ khi nâng cấp, và README có hướng dẫn nâng cấp riêng.

Dữ liệu của tôi lưu ở đâu, 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 home riêng, còn dashboard mở ở địa chỉ 127.0.0.1. Tư liệu chưa có thông tin chi tiết hơn về bảo mật, bạn nên xem file SECURITY.md trong repo.

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 cài giúp
    2. B.Cài thủ công: 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 khách
    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ủ doanh nghiệp nhỏ muốn có danh sách khách tiềm năng
    2. B.Người làm sales duyệt từng email trước khi gửi
    3. C.Agency xử lý thư trả lời
    4. D.Lập trình viên mới muốn dựng thử và tuỳ biến
  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ỏ.