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

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/ChatGPT — 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 làm outreach: tìm khách tiềm năng, kiểm tra email, viết thư lạnh, gửi và xử lý phản hồi. Nó chạy trên máy bạn, dùng Claude Code CLI hoặc Codex nên không cần API key mô hình. Cài đặt cần quen dùng terminal; có thể nhờ Claude Code hướng 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 bằng email lạnh) gần như từ đầu đến cuối. Nó tìm các công ty có thể 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à xử lý thư trả lời. Tên cũ của dự án là Harvey.

Bạn nên xem qua nếu bạn bán dịch vụ cho doanh nghiệp nhỏ (đặt lịch, quảng cáo, phần mềm, tư vấn…), làm sale một mình hoặc nhóm nhỏ, và không muốn trả tiền cho cả một bộ công cụ như Apollo, ZoomInfo, Clearbit hay Clay. Tác giả nói rõ Sellbird không dùng các công cụ đó.

Điểm đáng giá nhất có hai ý. Một: nó chạy bằng gói Claude Pro/Max (qua Claude Code CLI) hoặc gói ChatGPT (qua Codex), nên không có API key và không tính tiền theo token. Hai: mặc định không có email nào được gửi đi nếu bạn chưa duyệt. Repo hiện có khoảng 5250 sao và 1127 fork. Bạn có thể xem video ngắn bên dưới để thấy nó chạy trước khi cài.

Ứng dụng

ethanplusai/sellbird

Sellbird tự tìm công ty hợp, tìm người quyết định, kiểm tra email, viết cold email cá nhân hoá và xử lý phản hồi, chạy bằng gói Claude hoặc ChatGPT bạn có sẵ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 dây chuyền nhiều bước. Bạn có thể chạy hết, 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í. 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ị trừ tiền ngoài ý muốn.
  • Tìm lý do họ sẽ mua. Đọc chính website của từng công ty để tìm các 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, hay đ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 (tư liệu ghi là ba yêu cầu HTTP cho mỗi công ty). Lợi ích: thư của bạn có lý do cụ thể để gửi, không phải thư gửi bừa.
  • Tìm người quyết định. Lấy chủ hoặc quản lý được nêu trên các trang của công ty, tối đa hai người mỗi công ty.
  • Kiểm tra địa chỉ. Sellbird học kiểu email của công ty và 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 bị gửi tới. Cái này giúp bảo vệ uy tín hộp thư của bạn.
  • 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à trong giờ làm việc của người nhận.
  • Xử lý phản hồi. Đọc từng thư trả lời, soạn câu trả lời nháp, đặt riêng thư tự động, 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 khách, hãy dừng sau bước kiểm tra email rồi chạy sellbird export để có file CSV đưa vào công cụ gửi thư khác.

Về an toàn, mọi email gửi đi đều nằm chờ trong mục Outbox cho 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 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 hoặc địa chỉ không gửi được. Lệnh sellbird sending pause dừng mọi thứ ngay.

II.Cần chuẩn bị gì

Theo tư liệu, bạn cần:

  • Python 3.11 trở lên. Tệp cấu hình của gói yêu cầu đúng mức này. 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.
  • Claude Pro hoặc Max đã đăng nhập Claude Code CLI (lệnh claude login), hoặc một gói ChatGPT có Codex CLI. Không cần API key của mô hình.
  • 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 nói chi phí khoảng 7 đô la mỗi tháng cho Google Workspace.
  • Warmup (làm nóng) hộp thư. README khuyên dùng TrulyInbox, và lưu ý các liên kết TrulyInbox trong dự án là liên kết affiliate. Sellbird đọc tỉ lệ vào inbox của dịch vụ này để báo bạn khi nào sẵn sàng.
  • Tệp .env.example còn liệt kê nhiều khoá tuỳ chọn cho các nhà cung cấp khác (xác minh email như Reoon, ZeroBounce, Hunter; Instantly; Cloudflare; DataForSEO…). Bạn chỉ điền cái nào mình dùng.

Tư liệu không nói rõ yêu cầu về phần cứng. Phần ví dụ về thư mục dữ liệu có nhắc cả Windows, macOS và Linux. Riêng Docker, README chỉ ghi là dùng được trên Linux.

Sellbird 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, giữ chế độ duyệt tay lúc đầu và đọc tài liệu Legal and deliverability trong thư mục docs/ trước khi gửi hàng loạt. Quy định về email quảng cáo khác nhau theo từng nước, nên bạn tự kiểm tra luật nơi người nhận sống.

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

  1. Kiểm tra Python và ClaudePython 3.11+, đã chạy claude login
  2. Tải mã nguồngit clone repo về máy rồi vào thư mục
  3. Cài góiTạo môi trường ảo và pip install -e .
  4. Điền thông tinSao chép .env.example thành .env rồi điền
  5. Dạy Sellbirdtrain, signals, discover
  6. Mở bảng điều khiểnsellbird dashboard rồi sellbird run

Có hai cách: để Claude Code cài giúp (dễ nhất cho người mới), hoặc tự gõ lệnh.

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

Mở terminal (trên Windows là PowerShell hoặc Terminal, trên macOS là ứng dụng Terminal), rồi chạy ba lệnh:

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

Lệnh đầu tải mã nguồn về máy, 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 đó. Khi Claude mở, bạn gõ set up Sellbird for me. Theo README, tệp 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 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ỗ hay vấp: bạn phải đứng trong thư mục sellbird trước khi gõ claude, nếu không Claude sẽ không đọc được CLAUDE.md.

B.Cách tự làm: tạo môi trường và cài gói

Sau khi đã git clone và cd sellbird như trên, chạy lệnh của README:

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ột môi trường ảo tên .venv (để thư viện của Sellbird không lẫn với phần còn lại của máy), bật nó lên, rồi cài Sellbird ở chế độ chỉnh sửa được. Sau bước này bạn có lệnh sellbird. Lưu ý: dòng này viết cho macOS/Linux. Trên Windows, README chưa ghi lệnh riêng; bước bật môi trường ảo thường khác (.venv\Scripts\activate trong PowerShell), nên nếu vướng, bạn hãy dùng cách nhờ Claude cài ở 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 cp sao chép tệp mẫu thành .env, rồi mở bằng trình soạn thảo. Mỗi biến trong tệp đều có chú thích ngay bên cạnh. Bạn điền thông tin hộp thư gửi (Gmail, Microsoft 365 hoặc SMTP) và khoá của dịch vụ nào bạn dùng. Trên Windows, bạn có thể tự sao chép tệp bằng File Explorer và mở bằng Notepad. Tuyệt đối không đưa tệp .env lên GitHub hay gửi cho người khác.

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

# 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ạn thay https://your-company.com bằng website thật của mình. Lệnh train đọc website và ghi hiểu biết về sản phẩm vào sellbird.local.yaml. Lệnh signals giúp bạn xác nhận dấu hiệu nào cho thấy một công ty là khách tốt. Lệnh discover tìm doanh nghiệp từ nguồn miễn phí mặc định, không cần tài khoản.

E.Mở bảng điều khiển và chạy

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 link riêng tới địa chỉ trên máy bạn (127.0.0.1:5555), mở trong trình duyệt để xem danh sách khách, Outbox và các thư trả lời. sellbird run khởi động vòng lặp: cứ mỗi chu kỳ nó kiểm tra tình trạng, viết thư, xử lý phản hồi rồi nghỉ. Hai lệnh này thường cần hai cửa sổ terminal riêng, vì run chiếm cửa sổ khi đang chạy.

Nếu bạn dùng Linux và thích Docker, repo có sẵn Dockerfile và docker-compose.yml, và README có tài liệu Docker trong thư mục docs/. README chưa ghi lệnh chạy Docker lần đầu ở phần Quick start, nên hãy xem hướng dẫn Docker trong docs/.

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

Sau khi chạy sellbird run, màn hình mẫu trong README trông như sau:

Code
Sellbird is online.
Checking pipeline state...
Decision: write_campaign (3 new prospects with no drafts)
  handler   → ...
  writer    → 2-email sequence: ...
  outbox    → 5 emails waiting for your approval
Cycle complete. Sleeping for 15 minutes.

Bạn thấy dòng "Sellbird is online", rồi một quyết định của chu kỳ, và cuối cùng là "Cycle complete" kèm thời gian nghỉ thì nghĩa là vòng lặp đang chạy. Với người mới, dấu hiệu rõ nhất là: mở link in ra từ sellbird dashboard, thấy bảng điều khiển và thấy các email nháp nằm trong Outbox chờ bạn duyệt. Nếu Outbox có thư nhưng chưa có gì bị gửi đi, đó là hành vi đúng theo thiết kế.

Muốn dừng khẩn cấp, chạy sellbird sending pause.

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

A.Chủ công ty dịch vụ muốn có danh sách khách để gọi điện

Bạn bán phần mềm đặt lịch cho phòng khám nha khoa và chưa muốn gửi email. 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 chạy sellbird discover. Sau khi các bước tìm người quyết định và kiểm tra email xong, bạn chạy:

Terminal
sellbird export

Kết quả là một file CSV sẵn để đưa vào công cụ gửi thư khác, hoặc để nhân viên gọi điện. Mỗi địa chỉ có nhãn verified, risky, guess hoặc invalid để bạn biết cái nào đáng tin.

B.Sale làm một mình, muốn thư có lý do cụ thể

Bạn bán dịch vụ cho tiệm điều hoà. Thay vì viết một mẫu chung cho tất cả, bạn để Sellbird đọc website từng công ty, tìm dấu hiệu như đang tuyển nhân viên điều phối, rồi viết một chuỗi hai email xoay quanh đúng chi tiết đó. Ví dụ trong README là thư gửi một tiệm HVAC ở Phoenix đang tuyển người điều phối.

Hiệu quả nhất không phải là gửi nhiều hơn, mà là mỗi thư có một lý do thật để được gửi.

Ông T

Bạn mở Outbox, đọc từng thư, sửa nếu cần rồi duyệt. Nhờ đó bạn giữ được giọng của mình mà vẫn không phải viết từng thư.

C.Người vận hành muốn giữ hộp thư không bị khoá

Bạn đã có Google Workspace trên tên miền gửi riêng và đã warmup. Bạn giữ chế độ duyệt tay, đặt giới hạn gửi mỗi ngày trong cấu hình và để Sellbird gửi trong giờ làm việc của người nhận. Trước khi thư ra khỏi máy, bước kiểm tra không dùng mô hình chặn các thư còn merge tag chưa điền hoặc có quá nhiều link. Cách làm này phù hợp khi uy tín tên miền quan trọng hơn tốc độ.

D.Dev muốn tuỳ biến theo cách bán hàng riêng

Bạn muốn đổi giọng văn hoặc cách xử lý phản hồi. Repo có thư mục prompts/ và skills/ (các kịch bản bán hàng chỉnh sửa được) và sellbird.local.yaml để đặt cấu hình riêng mà git không động tới. Có thêm tài liệu Extensions nếu bạn muốn thêm lệnh hoặc bước mới từ một gói riêng. Bạn sửa các tệp này theo nhu cầu, rồi chạy lại sellbird run.

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

1. python3 --version báo 3.9 hoặc thấp hơn 3.11. Sellbird yêu cầu Python 3.11 trở lên. Trên macOS, cài bằng brew install python@3.13 và dùng python3.13 khi tạo môi trường ảo, đúng như README ghi.

2. Không thấy lệnh sellbird. Thường là bạn chưa bật môi trường ảo hoặc chưa chạy pip install -e . trong thư mục repo. Mở terminal mới, vào thư mục sellbird, bật lại môi trường ảo rồi chạy lại lệnh cài.

3. Claude hoặc Codex không phản hồi, báo chưa đăng nhập. Sellbird dùng gói thuê bao của bạn qua CLI, nên CLI phải đăng nhập sẵn. Chạy claude login với gói Claude Pro/Max. Với ChatGPT, xem tài liệu Using a ChatGPT plan (Codex) trong docs/.

4. Không có gì được gửi đi. Đây thường không phải lỗi. Mặc định mọi thư nằm trong Outbox chờ bạn duyệt. Vào bảng điều khiển để duyệt. Chỉ bật autopilot khi bạn đã tin tưởng chất lượng thư. Ngay cả khi bật, Sellbird vẫn giữ lại thư có link tới tên miền không phải của bạn.

5. Sau khi nâng cấp từ Harvey, git pull báo "your local changes would be overwritten". Bạn đã sửa trực tiếp harvey.yaml. README hướng dẫn chạy git stash, git pull, rồi git stash pop. Về sau, hãy đặt cài đặt của bạn vào sellbird.local.yaml để git không đụng tới.

Muốn xem thêm các tình huống khác, repo có tài liệu Troubleshooting trong docs/.

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

Điểm mạnh. Chạy trên máy bạn, dữ liệu nằm trong thư mục của bạn. Không cần API key mô hình, chỉ dùng gói bạn đang có. Tìm khách và đọc website có thể hoàn toàn miễn phí. Mặc định có bước duyệt tay và bước kiểm tra trước khi gửi, nên hợp với người muốn kiểm soát. Dự án vẫn được cập nhật trong vài tháng gần đây và có cộng đồng khá lớn.

Giới hạn. Bạn vẫn cần một hộp thư gửi, nên có chi phí cho hộp thư, tên miền và dịch vụ warmup. Cài đặt qua dòng lệnh, nên người chưa quen terminal sẽ cần thời gian, dù có cách nhờ Claude Code cài giúp. README viết ví dụ cho macOS/Linux, phần Windows ít được hướng dẫn hơn. Giấy phép là AGPL-3.0 (các bản Harvey đến 0.3.x dùng MIT), điều này đáng cân nhắc nếu bạn định tích hợp vào sản phẩm thương mại của mình. Tư liệu cũng không đảm bảo kết quả bán hàng: chất lượng thư phụ thuộc vào sản phẩm và danh sách của bạ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 hosted tại sellbird.ai (đang trong 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 vài thư gửi tay cho khách quen, một công cụ đơn giản sẽ nhẹ hơn. Và nếu bạn chưa rõ khách hàng lý tưởng của mình là ai, hãy làm rõ điều đó trước, vì Sellbird chỉ tìm tốt khi bạn nói đúng mình cần ai.

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ìm công ty trên nguồn mặc định (OpenStreetMap) và đọc website là $0. Nguồn trả phí rẻ nhất khoảng $0,37 cho 1.000 kết quả theo README, và mỗi lần tìm trả phí đều hiện chi phí trước. Bạn vẫn cần gói Claude/ChatGPT và một hộp thư gửi (README nêu khoảng 7 đô la mỗi tháng cho Google Workspace).

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

Không. Sellbird dùng Claude Code CLI trên gói Claude Pro hoặc Max, hoặc Codex trên gói ChatGPT, nên không tính tiền theo token. Nó cũng tự giới hạn để chừa chỗ cho việc bạn đang làm. Một số dịch vụ tuỳ chọn như xác minh email có thể cần khoá riêng, xem .env.example.

Có cần GPU không?

Tư liệu không nhắc yêu cầu GPU. Việc suy luận do Claude hoặc Codex đảm nhiệm qua gói thuê bao của bạn, không chạy mô hình cục bộ. 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, nhưng các lệnh cài đặt trong phần Quick start viết theo kiểu macOS/Linux, và README chưa có lệnh riêng cho Windows. Docker được nói là dùng được trên Linux. Bạn có thể nhờ Claude Code hướng dẫn cài theo cách đầu tiên.

Nó 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 đến khi bạn tự bật autopilot. Lệnh sellbird sending pause dừng mọi việc gửi ngay lập tức.

Dữ liệu của tôi nằm ở đâu?

Nó chạy trên máy bạn. Cấu hình, tri thức và dữ liệu nằm trong một thư mục home (cơ sở dữ liệu, log và token bảng điều khiển nằm trong data/). Tư liệu không nói thêm về chính sách dữ liệu của các dịch vụ bên thứ ba mà bạn có thể kết nối.

Tôi đang dùng Harvey thì có phải cài lại không?

Không. Harvey đã đổi tên thành Sellbird từ bản 0.4.0, cấu hình, dữ liệu và đăng nhập bảng điều khiển được giữ nguyên. Bạn chạy git pull rồi pip install -e . để có lệnh sellbird mới. Các biến HARVEY_* vẫn hoạt động nếu chưa đặt 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 dễ: để Claude cài giúp
    2. B.Cách tự làm: 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.Mở bảng điều khiển và chạy
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ công ty dịch vụ muốn có danh sách khách để gọi điện
    2. B.Sale làm một mình, muốn thư có lý do cụ thể
    3. C.Người vận hành muốn giữ hộp thư không bị khoá
    4. D.Dev muốn tuỳ biến theo cách bán hàng riê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ỏ.