OpenClaw có thể được cài trên Mac theo nhiều cách, tùy vào thói quen làm việc và cách bạn muốn quản lý môi trường của mình. Trong hướng dẫn này, bạn sẽ thấy các bước chi tiết cho từng phương pháp cài đặt, cùng những mẹo giúp OpenClaw chạy ổn định.
Tổng quan nhanh: ba cách cài đặt OpenClaw trên Mac
Dưới đây là bảng so sánh ba phương pháp. Mỗi cách khác nhau ở mức độ thiết lập thủ công mà bạn cần thực hiện.
| Trình cài đặt một dòng lệnh | Homebrew | Kimi Claw (Trực tuyến) | |
|---|---|---|---|
| Đây là gì | Script cài đặt chính thức, tự động tải xuống và thiết lập OpenClaw | Thiết lập thủ công bằng Homebrew để cài các phần phụ thuộc (như Node.js), rồi chạy OpenClaw qua CLI | Công cụ trực tuyến cho phép bạn chạy OpenClaw trên đám mây mà không cần thiết lập thủ công |
| Các bước thủ công cần thực hiện | Rất ít bước thủ công | Cần thực hiện nhiều bước thủ công | Không cần thiết lập thủ công |
| Cần code hoặc terminal | Có | Có | Không |
| Khả dụng 24/7 | Chỉ chạy khi Mac của bạn đang thức | Chỉ chạy khi Mac của bạn đang thức | Chạy 24/7 trên đám mây |
| Phù hợp nhất với | Người dùng lần đầu muốn thiết lập cục bộ nhanh nhất | Lập trình viên muốn quản lý gói qua Homebrew | Người dùng muốn chạy OpenClaw mà không cần thiết lập cục bộ |
Kimi Claw cho phép bạn chạy OpenClaw trên đám mây mà không cần thiết lập Node.js, Homebrew hay khóa API. Bạn có thể bắt đầu dùng một agent hoạt động ngay trong trình duyệt chỉ sau vài phút.
Nếu muốn thiết lập cục bộ, hãy tiếp tục sang phần tiếp theo. Nếu muốn cách đơn giản hơn, chuyển tới phần Chạy OpenClaw trên Mac bằng Kimi Claw, hoặc bấm nút bên dưới để bắt đầu ngay.
Trước khi bắt đầu: Chuẩn bị thiết yếu và bảo mật
Trước khi cài OpenClaw cục bộ trên Mac, bạn cần hoàn tất vài bước chuẩn bị và bảo mật. Nếu định dùng Kimi Claw, bạn có thể bỏ qua phần này và đi thẳng tới hướng dẫn thiết lập bên dưới.
Phần phụ thuộc: Trình cài đặt một dòng lệnh sẽ tự động cài Node.js nếu cần. Nếu chọn Homebrew, bạn cần cài Node.js thủ công (khuyến nghị Node 24; Node 22 LTS 22.16+ cũng dùng được).
Tường lửa và cài đặt mạng: Tường lửa macOS thường tắt theo mặc định. Bạn có thể bật trong System Settings > Network > Firewall. OpenClaw gắn gateway vào 127.0.0.1 (localhost), nên các thiết bị khác trong mạng của bạn không thể kết nối trực tiếp. Nếu cần truy cập từ di động hoặc từ xa, bạn có thể dùng các công cụ như Tailscale hoặc đường hầm SSH. Không chuyển tiếp cổng
18789qua router của bạn.
Cài đặt OpenClaw trên Mac bằng script một dòng lệnh
Đây là cách nhanh nhất để chạy OpenClaw cục bộ trên Mac. OpenClaw chạy từ Terminal và cung cấp giao diện trên trình duyệt để quản lý agent, thay vì một ứng dụng đồ họa truyền thống. Chỉ một lệnh sẽ cài CLI, kiểm tra phiên bản Node.js và khởi chạy trình hướng dẫn khởi tạo.
Bước 1. Chạy script cài đặt trong Terminal
Mở Terminal bằng Spotlight (⌘ + Space), rồi dán lệnh sau:
Script sẽ nhận diện hệ thống, cài OpenClaw CLI và kiểm tra phiên bản Node.js của bạn. Nếu thiếu Node.js hoặc phiên bản đã cũ, script sẽ tự động cài Node 24 (cũng hỗ trợ Node 22 LTS 22.16+).
Bước 2. Đặt khóa API và cấu hình gateway
Trình hướng dẫn khởi tạo sẽ tự động mở sau khi cài đặt xong. Chọn Moonshot AI (Kimi K2.5) làm nhà cung cấp LLM và dán khóa Kimi API khi được yêu cầu. Chấp nhận các cài đặt mặc định cho cổng gateway và xác thực. Nếu muốn OpenClaw tự khởi động khi Mac bật máy, hãy chọn tùy chọn cài đặt daemon trong quá trình khởi tạo.
Bước 3. Kiểm tra gateway và mở dashboard
Chạy lệnh sau để kiểm tra gateway đang chạy:
Sau đó mở dashboard:
Lệnh này mở Control UI trong trình duyệt của bạn tại http://127.0.0.1:18789. Nhập token gateway để đăng nhập. Sau khi đăng nhập, bạn có thể bắt đầu tương tác với agent OpenClaw của mình.
Cài OpenClaw trên Mac bằng Homebrew
Nếu muốn quản lý gói bằng Homebrew, bạn có thể cài OpenClaw trên Mac theo cách thủ công hơn. Phương pháp này cho bạn kiểm soát tốt hơn các phần phụ thuộc và phù hợp với quy trình Homebrew sẵn có của bạn.
Bước 1. Cài Homebrew
Mở Terminal bằng Spotlight (⌘ + Space). Nếu chưa cài Homebrew, hãy chạy lệnh sau. Homebrew là trình quản lý gói cho macOS, cho phép bạn cài và quản lý công cụ dành cho lập trình viên từ Terminal, tương tự cách kho ứng dụng cài ứng dụng.
Trong quá trình cài đặt, bạn có thể được yêu cầu nhập mật khẩu đăng nhập Mac. Lưu ý rằng vì lý do bảo mật, Terminal sẽ không hiển thị ký tự nào khi bạn gõ. Bạn cũng có thể thấy các lời nhắc xác nhận cài đặt và thông báo cho biết các tệp đang được cài.
Khi cài đặt hoàn tất, bạn sẽ thấy thông báo thành công và các bước tiếp theo trong Terminal.
Bước 2. Cài Node.js
Sau khi cài Homebrew, hãy cài Node.js:
Sau khi cài đặt, hãy xác nhận phiên bản là v24 (khuyến nghị) hoặc v22.16+.
Bước 3. Cài OpenClaw CLI và chạy onboarding
Cài CLI ở phạm vi toàn cục bằng npm, rồi chạy onboarding:
Nếu gặp lỗi quyền EACCES trong khi chạy npm install -g, thư mục global của npm cần quyền truy cập cao hơn. Hãy chạy sudo npm install -g openclaw@latest, hoặc đổi thư mục mặc định của npm để về sau không cần dùng sudo.
Cờ --install-daemon đăng ký OpenClaw làm LaunchAgent, để gateway tự khởi động khi bạn đăng nhập. Trong quá trình onboarding, chọn Moonshot AI (Kimi K2.5) làm nhà cung cấp và nhập khóa Kimi API của bạn.
Bước 4. Kiểm tra gateway và mở dashboard
Xác minh gateway đang chạy rồi mở dashboard:
Control UI sẽ mở trong trình duyệt của bạn. Nhập token gateway là bạn đã sẵn sàng.
Chạy OpenClaw trên Mac bằng Kimi Claw
Kimi Claw là công cụ trực tuyến cho phép bạn chạy OpenClaw trên đám mây mà không cần thiết lập cục bộ. Bạn không phải cài gì trên Mac, cũng không cần dùng Terminal hay quản lý phần phụ thuộc. Mọi thứ chạy ngay trong trình duyệt. Bạn có thể tạo một agent OpenClaw chỉ trong vài phút. Kimi Claw xử lý gateway, workspace, lưu trữ và quyền truy cập mô hình, nên agent của bạn luôn trực tuyến 24/7, kể cả khi MacBook đã đóng.
Cách sử dụng Kimi Claw?
Bước 1. Mở Kimi Claw
Truy cập trang Kimi Claw và bấm Create để bắt đầu triển khai môi trường OpenClaw của bạn.
Bước 2. Tự động triển khai OpenClaw
Xác nhận triển khai trong cửa sổ bật lên. Sau đó Kimi Claw sẽ thiết lập môi trường OpenClaw, gồm gateway, workspace và công cụ. Quá trình này thường hoàn tất trong vài phút.
Bước 3. Bắt đầu dùng OpenClaw
Khi triển khai xong, workspace của bạn sẽ mở trong dashboard. Bạn có thể trò chuyện với agent, thiết lập kỹ năng, lên lịch tác vụ và quản lý tệp—tất cả ngay trong trình duyệt.
Kimi Claw khác gì so với chạy OpenClaw cục bộ
Kimi Claw mang đến cách chạy OpenClaw đơn giản hơn, không cần thiết lập cục bộ. Thay vì cài phần phụ thuộc và quản lý môi trường trên máy, bạn có thể chạy agent trực tiếp trong trình duyệt, còn Kimi Claw lo phần thiết lập và hạ tầng bên dưới.
Không cần thiết lập cục bộ: Chạy OpenClaw mà không cần cài Node.js hay dùng Terminal. Mọi thứ hoạt động trực tiếp trong trình duyệt, giúp bạn bắt đầu nhanh hơn và tránh các vấn đề thiết lập môi trường.
Truy cập tức thì hơn 5.000 kỹ năng: Thay vì cài công cụ thủ công, Kimi Claw có thể tự động dùng các kỹ năng cần thiết cho tác vụ của bạn từ thư viện công cụ lớn, giúp giảm thời gian thiết lập và hạn chế lỗi tương thích.
Tự động hóa và lên lịch luôn hoạt động: Khác với các agent cục bộ sẽ dừng khi Mac ngủ, Kimi Claw chạy 24/7 trên đám mây, phù hợp với tác vụ theo lịch và quy trình dài hạn.
40GB lưu trữ đám mây và bộ nhớ liên tục: Khác với thiết lập cục bộ, nơi tệp thường gắn với một thiết bị duy nhất, Kimi Claw cung cấp 40GB dung lượng lưu trữ, giúp bạn truy cập báo cáo và nghiên cứu từ bất kỳ trình duyệt nào. Nền tảng cũng ghi nhớ tùy chọn và bối cảnh làm việc của bạn qua các phiên, để bạn có thể tiếp tục đúng nơi đã dừng.
Tích hợp mô hình Kimi K2.5 và tìm kiếm cấp chuyên nghiệp: Kimi Claw có sẵn quyền truy cập Kimi K2.5 và các khả năng tìm kiếm nâng cao, nên bạn không cần quản lý khóa API hay thiết lập dịch vụ bên ngoài. Công cụ có thể tự động đưa vào thông tin cập nhật từ các lĩnh vực như tài chính, công nghệ và tin tức, giúp việc nghiên cứu và thực thi tác vụ liền mạch hơn.
Giữ OpenClaw chạy 24/7 trên Mac
Phần lớn người dùng xem AI như một ứng dụng desktop truyền thống: dùng khi ngồi trước máy và đóng lại khi xong việc. Nhưng với các tác vụ tự động hóa có giá trị—như theo dõi thị trường toàn cầu qua đêm hoặc chuẩn bị sẵn báo cáo nghiên cứu trong hộp thư lúc 8 giờ sáng—agent của bạn cần hoạt động liên tục suốt ngày đêm. Vì macOS mặc định sẽ tạm dừng các tiến trình cục bộ khi hệ thống ngủ, bạn cần có chiến lược phù hợp để duy trì kết nối ổn định. Phần này trình bày hai cách:
Tùy chọn A: Phần cứng Mac chuyên dụng
Một cách là để một máy Mac (chẳng hạn Mac mini) chạy liên tục. Bạn có thể tắt chế độ ngủ bằng sudo pmset -a sleep 0 và bật “Wake for network access” trong System Settings. Để truy cập từ xa, bạn có thể dùng các công cụ như Tailscale hoặc đường hầm SSH.
Thiết lập này giữ OpenClaw chạy trên phần cứng của chính bạn, nhưng bạn phải duy trì máy luôn bật và tự xử lý bảo trì, cập nhật cũng như khởi động lại.
Tùy chọn B: Kimi Claw tự động xử lý
Nếu chạy agent bằng Kimi Claw, khả năng hoạt động 24/7 đã được tích hợp sẵn. Agent của bạn chạy độc lập với thiết bị cục bộ, nên vẫn tiếp tục làm việc ngay cả khi Mac đã đóng hoặc ngoại tuyến. Bạn không cần chỉnh cài đặt ngủ hay giữ một máy luôn chạy.
Sửa các lỗi cài đặt OpenClaw thường gặp trên Mac
Ngay cả khi thiết lập đơn giản, bạn vẫn có thể gặp sự cố trong quá trình cài đặt. Dưới đây là một số vấn đề phổ biến và cách khắc phục.
Lỗi không tìm thấy lệnh OpenClaw
Nguyên nhân: Thư mục bin global của npm chưa nằm trong PATH của shell.
Cách sửa: Chạy
source ~/.zshrcđể tải lại cấu hình shell. Nếu bạn dùng Bash thay vì Zsh, hãy thay~/.zshrcbằng~/.bash_profile. Nếu lỗi vẫn còn, hãy tìm prefix của npm rồi thêm vào PATH:
OpenClaw không khởi động sau khi reboot
Nguyên nhân: LaunchAgent chưa được cài trong quá trình onboarding.
Cách sửa: Chạy lệnh onboarding với cờ daemon:
Thao tác này đăng ký một LaunchAgent để gateway OpenClaw tự động khởi động khi bạn đăng nhập. Để xác minh nó đang hoạt động:
Cổng 18789 đã được sử dụng
Nguyên nhân: Một tiến trình khác đang chiếm cổng gateway.
Cách sửa: Tìm và dừng tiến trình gây xung đột:
Lỗi Xcode Command Line Tools khi cài kỹ năng
Nguyên nhân: Một số gói npm cần biên dịch native, trong khi Xcode Command Line Tools bị thiếu hoặc đã cũ.
Cách sửa: Cài đặt hoặc cập nhật các công cụ:
Sau khi cài đặt xong, hãy thử cài lại kỹ năng.
Phiên bản Node.js quá cũ
Nguyên nhân: Mac của bạn đang cài Node.js cũ hơn 22.16. OpenClaw yêu cầu Node 24 (khuyến nghị) hoặc Node 22 LTS 22.16+.
Cách sửa: Nếu bạn dùng Homebrew:
Nếu bạn dùng trình cài đặt một dòng lệnh, hãy chạy lại. Script sẽ phát hiện phiên bản đã cũ và cập nhật.
Kết luận
OpenClaw có thể chạy cục bộ trên Mac bằng trình cài đặt một dòng lệnh hoặc Homebrew, hoặc chạy trong trình duyệt với Kimi Claw mà không cần thiết lập cục bộ. Cả ba cách đều giúp bạn có một agent hoạt động, nhưng mức độ thao tác thủ công sẽ khác nhau. Nếu muốn thiết lập nhanh hơn và có sẵn khả năng hoạt động 24/7, bạn có thể bắt đầu với Kimi Claw để agent chạy chỉ sau vài phút.
Câu hỏi thường gặp
openclaw onboard --install-daemon để đăng ký một LaunchAgent, giúp gateway tự khởi động khi bạn đăng nhập. Nếu daemon đã được cài nhưng không khởi động, hãy kiểm tra trạng thái bằng launchctl list | grep openclaw và xem nhật ký hệ thống. Người dùng Kimi Claw không cần cấu hình này vì dịch vụ chạy trên máy chủ đám mây và luôn trực tuyến độc lập.source ~/.zshrc để tải lại cấu hình. Nếu vẫn không tìm thấy lệnh, hãy chạy npm config get prefix để xác định thư mục bin rồi thêm thư mục đó vào PATH trong ~/.zshrc. Sau khi thay đổi, hãy khởi động lại Terminal.sudo pmset -a sleep 0) và truy cập từ xa qua Tailscale; hoặc dùng Kimi Claw. Kimi Claw là nền tảng được quản lý toàn phần, giúp agent OpenClaw của bạn luôn trực tuyến suốt ngày đêm mà không cần bảo trì phần cứng.curl -fsSL https://openclaw.ai/install.sh | bash. Script sẽ cài OpenClaw, kiểm tra phiên bản Node.js và hướng dẫn bạn thiết lập. Bạn cũng có thể dùng Homebrew: chạy brew install node, rồi npm install -g openclaw@latest. Nếu muốn một lựa chọn được quản lý toàn phần, không cần terminal, Kimi Claw chạy OpenClaw ngay trong trình duyệt của bạn mà không cần thiết lập cục bộ.curl -fsSL https://openclaw.ai/install.sh | bash) hoặc cài qua Homebrew bằng npm install -g openclaw@latest. Nếu muốn lựa chọn chạy trên trình duyệt và không cần tải xuống, Kimi Claw sẽ chạy OpenClaw cho bạn trên máy chủ đám mây.