Openclaw Skills chuyển đổi các máy chủ AI thành các agent có thể phát hiện và có tính persistent với các quy trình đăng ký, chấp nhận và handshake bằng một lệnh duy nhất.
Cài đặt & Tải xuống
1. ClawHub CLI
Cách nhanh nhất để cài đặt kỹ năng trực tiếp từ thư viện.
npx clawhub@latest install agent-handshake
2. Cài đặt Thủ công
Sao chép thư mục kỹ năng vào một trong những vị trí sau
~/.openclaw/skills/ <project>/skills/ Ưu tiên: Không gian làm việc > Cục bộ > Gói sẵn
3. Cài đặt Prompt
Sao chép prompt này vào OpenClaw để tự động cài đặt.
Giúp tôi cài đặt agent-handshake bằng Clawhub. Nếu Clawhub chưa
Bạn muốn tải xuống?
Nhận các tệp kỹ năng gốc dưới dạng lưu trữ ZIP.
Agent Handshake là gì?
Openclaw Skills cung cấp một lớp handshake tiêu chuẩn hóa cho các AI agent: một máy chủ xuất bản danh tính của nó, phía local xác thực và lưu trữ nó, và các kết nối trong tương lai có thể được khởi tạo bằng một lệnh duy nhất. Nó được xây dựng cho các stack không đồng nhất như OpenCode, LangChain, CrewAI, các dịch vụ FastAPI chung và các MCP endpoint, giúp Openclaw Skills trở thành một lớp phát hiện và kết nối thực tế cho các nhóm agent hỗn hợp.
Bằng cách kết hợp đăng ký phía máy chủ, lưu trữ persistent cục bộ dưới references\/servers\/ và hỗ trợ Cloudflare Quick Tunnel tùy chọn, Openclaw Skills cho phép bạn kết nối với các agent trên mạng LAN, sau NAT hoặc trên VPS mà không bị mất dấu máy nào bạn đang trò chuyện. Kết quả là một quy trình làm việc CLI có thể lặp lại, thêm bộ nhớ, danh tính và khả năng truy xuất nguồn gốc vào quá trình bàn giao giữa agent với agent và con người với agent.
Trường hợp sử dụng Agent Handshake
- Khi người dùng yêu cầu handshake, kết nối hoặc phát hiện máy chủ OpenCode từ CLI.
- Khi một phiên bản OpenCode CLI mới được cài đặt và cần được đăng ký vào bộ nhớ cục bộ.
- Khi bạn cần xác định chính xác NAS, máy chủ đám mây hoặc máy LAN nào bạn đang kết nối.
- Khi một máy chủ nằm sau NAT hoặc tường lửa và cần Cloudflare Quick Tunnel để truy cập công cộng tạm thời.
- Khi bạn muốn thực thi từ xa kiểu SSH trên VPS thông qua HTTP thay vì mở cổng 22.
- Khi Openclaw Skills cần duy trì một kho lưu trữ persistent các máy chủ AI đã biết để thực hiện handshake lại nhanh chóng và tự động hóa có thể lặp lại.
Cách thức hoạt động của Agent Handshake
- Máy chủ chạy
register.shđể thu thập hostname, OS, kiến trúc, phần cứng, cổng, endpoint sức khỏe, loại agent và dấu vân tay SSH. register.shtạo một JSON danh tính máy dướireferences\/servers\/<hostname>.jsonvà xác nhận agent có thể kết nối được.- Máy cục bộ nhận danh tính đó thông qua sao chép,
accept.shhoặc đường hầm, sau đó xác thực sức khỏe và khả năng kết nối. accept.shduy trì bản ghi máy chủ cục bộ, cập nhậtreferences\/servers\/_index.jsonvà lưu trữ địa chỉ tốt nhất đã biết trong~\/.agent-handshake.discover.shquét mạng và đối chiếu các danh tính đã biết để Openclaw Skills có thể báo cho người dùng biết chính xác máy nào đang sẵn sàng.handshake.sh autochọn URL thích hợp nhất, hiển thị banner máy chủ, mở phiên và trả về kết quả của tác vụ.- Đối với các kịch bản NAT hoặc VPS,
tunnel.shhoặcdeploy.shmở rộng quy trình làm việc với Cloudflare Quick Tunnel hoặc thực thi tác vụ từ xa dựa trên HTTP.
Cài đặt Agent Handshake
- Cài đặt OpenCode CLI trên bất kỳ máy chủ nào sẽ hiển thị OpenCode Serve hoặc đảm bảo FastAPI hoặc MCP agent của bạn đã có một endpoint
\/health. - Đặt thư mục Openclaw Skills trên máy cục bộ và trên mỗi máy chủ tự đăng ký.
- Đăng ký danh tính máy chủ từ phía máy chủ:
chmod +x scripts\/*.sh
bash scripts\/register.sh
bash scripts\/register.sh opencode
- Chấp nhận máy chủ cục bộ và duy trì nó:
bash scripts\/accept.sh lvliefeng http:\/\/192.168.5.2:4096
- Nếu máy chủ nằm sau NAT, hãy khởi động một đường hầm trước rồi chấp nhận URL đường hầm:
bash scripts\/tunnel.sh start
bash scripts\/accept.sh lvliefeng https:\/\/random-name.trycloudflare.com
- Cấu hình OpenCode Serve tùy chọn:
export OPENCODE_AUTH='opencode:opencode123'
export OPENCODE_PORT='4096'
export OPENCODE_PROVIDER='zen'
export OPENCODE_MODEL='deepseek-v4-flash-free'
- Đối với triển khai VPS, khởi tạo HTTP agent shell:
bash scripts\/deploy.sh 4096 user:pass
- Xác minh handshake đầu-cuối bằng kết nối tự động:
bash scripts\/handshake.sh auto 'list NAS docker projects'
Lược đồ dữ liệu & Hệ thống phân loại của Agent Handshake
Openclaw Skills lưu trữ danh tính máy chủ và trạng thái phát hiện dưới dạng các bản ghi JSON bền vững, với một tệp trên mỗi máy chủ cộng với một kho lưu trữ được lập chỉ mục.
| Path | Generated by | Purpose | Key contents |
|---|---|---|---|
references\/servers\/<hostname>.json |
register.sh and accept.sh |
Bản ghi danh tính persistent trên mỗi máy chủ | hostname, agent_type, protocol, OS, kernel, arch, CPU, memory, disk, LAN IPs, public IP, agent version, port, SSH fingerprint, tunnel URL, generated timestamp |
references\/servers\/_index.json |
accept.sh |
Cơ sở đăng ký toàn cầu của tất cả các máy chủ đã biết | servers map, total count, quick lookup keys |
~\/.agent-handshake |
accept.sh |
Bộ nhớ cấp người dùng cho các endpoint ưa thích hoặc được biết đến gần nhất | canonical URL, selected LAN or tunnel address, auth hints, local defaults |
Phân loại siêu dữ liệu
- Identity: hostname, OS, kernel, architecture
- Agent: agent_type, agent version, protocol, exposed endpoints
- Network: LAN IPs, public IP, port, tunnel URL
- Hardware: CPU model, memory size, disk capacity
- Security: SSH fingerprint, auth mode, Basic Auth secret reference
- Lifecycle: generation time, last accepted time, health status
Các giá trị agent_type được hỗ trợ
opencodelangchaincrewaigeneric-fastapigenericmcp
Quy tắc đối chiếu giao thức
opencodesử dụngGET \/global\/healthvà luồng phiên qua\/sessionlangchainvàcrewaithường hiển thịGET \/healthvàPOST \/chatgeneric-fastapiđược phát hiện quaGET \/healthcùng với\/docshoặc\/openapi.jsongenericđược chấp nhận dưới dạng bất kỳ HTTP agent nào trả về tải trọng JSON sức khỏe hợp lệmcpđược theo dõi thông qua MCP endpoint và đường dẫn phát hiện sức khỏe của nó
Sơ đồ này giúp Openclaw Skills ghi nhớ chính xác máy nào là máy nào, ngay cả khi nhiều máy chủ AI chia sẻ cùng một mạng cục bộ.
Tính năng Nâng cao của Agent Handshake
- Tự động phát hiện loại agent trên
opencode,langchain,crewai,generic-fastapi,genericvàmcp. - Hỗ trợ Cloudflare Quick Tunnel để duyệt qua NAT, HTTPS tạm thời không cần tài khoản và truy cập từ xa nhanh chóng.
handshake.sh autotự động chọn loại địa chỉ tốt nhất hiện có và hiển thị banner danh tính máy chủ trước khi kết nối.- Bộ nhớ persistent qua
references\/servers\/_index.jsonvà~\/.agent-handshake, nhờ đó Openclaw Skills ghi nhớ mọi máy chủ đã đăng ký. - Thực thi từ xa kiểu SSH trên VPS với
agent_shell.pyvà\/runqua HTTP Basic Auth. - Xác thực sức khỏe nhận biết giao thức bằng cách sử dụng
\/global\/health,\/health,\/openapi.jsonvà các đường dẫn phát hiện MCP. - Triển khai gọn nhẹ có thể cài đặt một dịch vụ systemd và tự động khởi động khi khởi động.
- Phát hiện, đăng ký và bàn giao phiên được đóng gói thành một quy trình làm việc gốc CLI cho các thiết lập Openclaw Skills đa máy chủ.
SKILL.md
Đang tải
Các kỹ năng Openclaw liên quan
Agent Deployment Kit
Một phương pháp có cấu trúc để nhân bản cấu hình AI Agent trên nhiều khách hàng bằng cách sử dụng một nguồn ngữ cảnh duy nhất và một trình tạo nghiêm ngặt được kiểm soát bằng cổng xác thực.
Canvora Visual Generation Skill
Canvora là một công cụ tiện ích chạy bằng CLI giúp chuyển đổi văn bản thô, URL trang web và tài liệu thành hình ảnh tiếp thị chất lượng cao, đồng bộ với thương hiệu và các bộ trang trình bày có cấu trúc.
Tristan RFQ Overseer
Tristan RFQ Overseer chuyển đổi các RFQ đến thành các bản thảo báo giá được định giá, so sánh và kiểm soát phê duyệt với trạng thái được hỗ trợ bởi kho lưu trữ (vault).
UI Master Static
Hướng dẫn từ Openclaw Skills để xây dựng giao diện chất lượng sản xuất với CSS thuần, BEM, bố cục hiện đại và hiệu ứng chuyển động tinh tế.
Novelty Validator
Một công cụ xác minh nghiên cứu học thuật giúp trích xuất các tuyên bố từ biên bản cuộc họp và xác thực tính mới đối chiếu với cơ sở dữ liệu 1,2 tỷ tài liệu.
Diễn Tập Bảo Vệ Luận Văn
Một quy trình làm việc trên Openclaw Skills giúp diễn tập bảo vệ luận văn học thuật từ đầu đến cuối với hội đồng giả định, quét điểm yếu tài liệu tham khảo và đánh giá kỹ năng thuyết trình.
Đặc sắc*
