openclaw/openclaw
Trợ lý AI cá nhân của riêng bạn. Bất kỳ hệ điều hành nào. Bất kỳ nền tảng nào. Cách tôm hùm. 🦞
README
OpenClaw 🦞 — Trợ lý của bạn, trên thiết bị của bạn, trong cuộc trò chuyện của bạn
OpenClaw là trợ lý AI cá nhân chạy trên thiết bị của bạn và gặp bạn trên các kênh bạn đã sử dụng. Nó được thiết kế cho một nhà điều hành duy nhất và kết nối các mô hình, công cụ, kênh nhắn tin và ứng dụng đồng hành tùy chọn thông qua một Cổng.
Trang web · Tài liệu · Bắt đầu · trưng bày · Câu hỏi thường gặp · Tầm nhìn · DeepWiki
cài đặt
Trình cài đặt hỗ trợ macOS, Linux và Windows. Nó cung cấp thời gian chạy Node.js được hỗ trợ khi cần.
# macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash
# Windows PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex
Đã quản lý Node.js? Thay vào đó hãy cài đặt gói đã xuất bản (Nút 22.22.3+, 24.15+ hoặc 25.9+):
npm install -g openclaw@latest --allow-scripts=openclaw
Lệnh đó dành cho npm 12 hoặc npm 11.16+. Vào npm 11.15 trở về trước, hãy bỏ qua
--allow-scripts=openclaw. Xem
hướng dẫn cài đặt đối với hợp đồng tập lệnh vòng đời, Docker, Nix và các lộ trình triển khai khác.
Bắt đầu nhanh
Khi cài đặt mới, các tập lệnh cài đặt sẽ tự động bắt đầu được tích hợp. Hoàn thành trình hướng dẫn họ mở. Nếu bạn đã cài đặt gói trực tiếp bằng npm, pnpm hoặc Bun, hãy chạy:
openclaw onboard --install-daemon
Sau khi lên máy bay:
openclaw gateway status
openclaw dashboard
Quá trình triển khai sẽ xác minh quyền truy cập vào mô hình, tạo không gian làm việc và định cấu hình Cổng. Lệnh cuối cùng sẽ mở Control UI; gửi tin nhắn tới đó để xác nhận trợ lý đang làm việc. Xem hướng dẫn bắt đầu để thiết lập kênh và khắc phục sự cố.
Làm thế nào nó phù hợp với nhau
- các Cổng vào là mặt phẳng điều khiển cục bộ cho các phiên, công cụ, sự kiện và kết nối kênh.
- các Giao diện người dùng điều khiển, CLI, và TUI kết nối với Cổng.
- Kênh đưa trợ lý này đến WhatsApp, Telegram, Slack, Discord, Google Chat, Signal, iMessage và các dịch vụ nhắn tin khác.
- Các ứng dụng và nút đồng hành thêm các hành động bằng giọng nói, Canvas, máy ảnh, màn hình và thiết bị cục bộ trên các nền tảng được hỗ trợ.
OpenClaw hoạt động với máy chủ lưu trữ và cục bộ nhà cung cấp mô hình. của nó công cụ, kỹ năngvà plugin mở rộng những gì một trợ lý có thể làm.
Bảo mật
Hãy coi các tin nhắn gửi đến là đầu vào không đáng tin cậy. Theo mặc định, các kênh có khả năng DM sẽ ghép nối những người gửi không xác định; phê duyệt yêu cầu ghép nối với openclaw pairing approve <channel> <code>.
Các công cụ chạy trên máy chủ cho phiên chính trừ khi bạn định cấu hình hộp cát. Đọc hướng dẫn bảo mật, sổ tay tiếp xúcvà hướng dẫn đóng hộp cát trước khi kết nối những người dùng khác hoặc để lộ Cổng từ xa.
Tài liệu
| Mục tiêu | Bắt đầu ở đây |
|---|---|
| Định cấu hình mô hình và xác thực | Người mẫu · Nhà cung cấp mô hình |
| Kết nối dịch vụ nhắn tin | Kênh |
| Thêm công cụ, kỹ năng và plugin | Công cụ · Kỹ năng · Plugin · móng vuốt |
| Chạy ứng dụng và nút thiết bị | Nền tảng · Nút |
| Sử dụng CLI và lệnh trò chuyện | Tham chiếu CLI · Lệnh gạch chéo |
| Cấu hình hoặc vận hành Cổng | Cấu hình · Kiến trúc · Đang cập nhật · Kênh phát hành |
Phát triển
Kho lưu trữ là không gian làm việc pnpm. đồng bằng npm install tại thư mục gốc của kho lưu trữ không được hỗ trợ.
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm ui:build
Xem ĐÓNG GÓP.md cho quy trình làm việc đóng góp và hướng dẫn cài đặt nguồn cho vòng lặp phát triển.
cộng đồng
OpenClaw được phát triển mở bởi Quỹ OpenClaw, một tổ chức phi lợi nhuận. Xem ĐÓNG GÓP.md đối với người duy trì và hướng dẫn đóng góp; PR được hỗ trợ bởi AI đều được chào đón.
Sử dụng người chọn vấn đề để biết các lỗi và yêu cầu tính năng, hãy đặt câu hỏi thiết lập trong Bất hòavà báo cáo các lỗ hổng thông qua BẢO MẬT.md. Các khả năng mới thường thuộc về các plugin được xây dựng trên plugin SDK và chia sẻ thông qua móng vuốt.
OpenClaw được xây dựng cho Molty, trợ lý AI về tôm hùm không gian, của Peter Steinberger và cộng đồng. Khám phá truyền thuyết dự án, linh hồn.md, trang web của Peter, Lịch sử ngôi saovà @openclaw.
Đặc biệt cảm ơn đến Mario Zechner vì sự ủng hộ của anh ấy và vì số pivà gửi tới Adam Doppelt cho miền Tôm hùm.bot.
Nhà tài trợ
Người đóng góp
Cảm ơn tất cả các nhà phát triển móng vuốt:
Giấy phép
MIT © Quỹ OpenClaw. Xem THIRD_PARTY_NOTICES.md đối với mã được kết hợp hoặc điều chỉnh.
Dự án cùng danh mục
Hệ thống tối ưu hóa hiệu suất khai thác tác nhân. Kỹ năng, bản năng, trí nhớ, bảo mật và sự phát triển ưu tiên nghiên cứu cho Claude Code, Codex, Opencode, Cursor và hơn thế nữa.
Đại lý phát triển cùng bạn
Kỹ năng dành cho kỹ sư thực sự. Trực tiếp từ thư mục .agents của tôi.
Triển lãm bảo tàng do đại lý quản lý, được xây dựng trong Rust với Gajae-Code / LazyCodex — được phát triển và duy trì mà không có sự can thiệp của con người.
DeepSeek Khai thác: Mọi thứ đều là Plugin.