Sponsored by Vmake Labs Video Enhancer - Vmake Labs Video Enhancer 運用 AI 改善影片畫質、還原細節、減少模糊，並將影片升頻至 8K。

AI 廣告資料庫

Openclaw Skills

Agent Handshake

適用於 Openclaw 的 Agent Handshake

Openclaw Skills 透過單一指令註冊、接受和握手工作流程，將 AI 伺服器轉化為可發現的、持久化的 agent。

lyliefeng

v0.1.0

Jul 19, 2026

安裝

基本資訊

Skill.md

安裝與下載

1. ClawHub CLI

從來源直接安裝技能的最快方式。


                  npx clawhub@latest install agent-handshake

2. 手動安裝

將技能資料夾複製到以下位置之一

全域模式

~/.openclaw/skills/

工作區

<project>/skills/

優先級：工作區 > 本地 > 內建

3. 提示詞安裝

將此提示詞複製到 OpenClaw 即可自動安裝。


                  請幫我使用 Clawhub 安裝 agent-handshake。如果尚未安裝 Clawhub，請先安裝（npm i -g clawhub）。

想要直接下載？

取得包含原生技能檔案的ZIP壓縮檔。

什麼是 Agent Handshake？

Openclaw Skills 為 AI agent 提供了一個標準化的握手層：伺服器發布其身分，本機端進行驗證和儲存，後續連接只需單一指令即可發起。它專為 OpenCode、LangChain、CrewAI、通用 FastAPI 服務和 MCP 端點等異質技術棧而建置，使 Openclaw Skills 成為混合 agent 叢集的實用發現與連接層。

透過結合伺服器端註冊、references\/servers\/ 下的本機持久化，以及選配的 Cloudflare Quick Tunnel 支援，Openclaw Skills 允許您連接到區域網路（LAN）、NAT 後或 VPS 上的 agent，而不會迷失您正在與哪台機器通訊。其結果是一個可重複的 CLI 工作流程，為 agent 到 agent 以及人到 agent 的交接增加了記憶體、身分和可追溯性。

Agent Handshake 應用場景

當使用者請求從 CLI 握手、連接或發現 OpenCode 伺服器時。
當安裝了新的 OpenCode CLI 執行個體並需要將其註冊到本機記憶體中時。
當您需要精確識別您正在連接的是哪台 NAS、雲端主機或區域網路（LAN）機器時。
當伺服器處於 NAT 或防火牆後，需要 Cloudflare Quick Tunnel 進行臨時公開存取時。
當您希望透過 HTTP 代替開放 22 埠，在 VPS 上進行類似 SSH 的遠端執行時。
當 Openclaw Skills 需要維護已知 AI 伺服器的持久化清單以進行快速重新握手和可重複的自動化時。

Agent Handshake 運作原理

伺服器執行 register.sh 以收集主機名稱、作業系統（OS）、架構、硬體、埠、健康端點、agent 類型和 SSH 指紋。
register.sh 在 references\/servers\/<hostname>.json 下生成一個機器身分 JSON，並確認 agent 是可達的。
本機機器透過複製、accept.sh 或隧道接收該身分，然後驗證健康狀況和可達性。
accept.sh 在本機持久化保存伺服器記錄，更新 references\/servers\/_index.json，並將最適合的已知地址儲存在 ~\/.agent-handshake 中。
discover.sh 掃描網路並比對已知身分，以便 Openclaw Skills 可以準確地告訴使用者哪台機器可用。
handshake.sh auto 選擇最合適的 URL，顯示伺服器橫幅，開啟工作階段，並返回任務結果。
對於 NAT 或 VPS 場景，tunnel.sh 或 deploy.sh 使用 Cloudflare Quick Tunnel 或基於 HTTP 的遠端任務執行來擴充工作流程。

Agent Handshake 設定指南

在任何將公開 OpenCode Serve 的伺服器上安裝 OpenCode CLI，或者確保您的 FastAPI 或 MCP agent 已經擁有一個 \/health 端點。
將 Openclaw Skills 目錄放置在本機機器以及每個將要註冊自身的伺服器上。
從伺服器端註冊伺服器身分：

chmod +x scripts\/*.sh
bash scripts\/register.sh
bash scripts\/register.sh opencode

在本機接受該伺服器並將其持久化：

bash scripts\/accept.sh lvliefeng http:\/\/192.168.5.2:4096

如果伺服器處於 NAT 後，請先啟動隧道，然後接受該隧道 URL：

bash scripts\/tunnel.sh start
bash scripts\/accept.sh lvliefeng https:\/\/random-name.trycloudflare.com

可選的 OpenCode Serve 設定：

export OPENCODE_AUTH='opencode:opencode123'
export OPENCODE_PORT='4096'
export OPENCODE_PROVIDER='zen'
export OPENCODE_MODEL='deepseek-v4-flash-free'

對於 VPS 部署，引導 HTTP agent shell：

bash scripts\/deploy.sh 4096 user:pass

透過自動連接驗證端到端握手：

bash scripts\/handshake.sh auto 'list NAS docker projects'

Agent Handshake 資料結構與分類體系

Openclaw Skills 將伺服器身分和發現狀態儲存為持久的 JSON 記錄，包含每個主機的檔案以及索引清單。

Path	Generated by	Purpose	Key contents
`references\/servers\/<hostname>.json`	`register.sh` and `accept.sh`	持久化單一伺服器身分記錄	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`	所有已知伺服器的全域註冊表	`servers` map, total count, quick lookup keys
`~\/.agent-handshake`	`accept.sh`	偏好或最後已知端點的使用者級記憶體	canonical URL, selected LAN or tunnel address, auth hints, local defaults

元資料分類法

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

支援的 agent_type 值

opencode
langchain
crewai
generic-fastapi
generic
mcp

協定比對規則

opencode 使用 GET \/global\/health 以及透過 \/session 的工作階段流
langchain 和 crewai 通常公開 GET \/health 和 POST \/chat
generic-fastapi 透過 GET \/health 以及 \/docs 或 \/openapi.json 被發現
generic 被接受為任何傳回有效健康 JSON 承載的 HTTP agent
mcp 透過其 MCP 端點和健康發現路徑進行追蹤

此結構使 Openclaw Skills 能夠準確記住哪台機器是哪台，即使多個 AI 伺服器共用相同的本機網路也是如此。

Agent Handshake 進階特性

支援在 opencode、langchain、crewai、generic-fastapi、generic 和 mcp 之間進行自動 agent 類型偵測。
支援 Cloudflare Quick Tunnel 以用於 NAT 穿透、免帳戶臨時 HTTPS 以及快速遠端存取。
handshake.sh auto 自動選擇最佳的可用地址類型，並在連接前顯示伺服器身分橫幅。
透過 references\/servers\/_index.json 和 ~\/.agent-handshake 實現持久化記憶體，使 Openclaw Skills 記住每個已註冊的伺服器。
結合 agent_shell.py 並透過 HTTP Basic Auth 上的 \/run 在 VPS 上實現類似 SSH 的遠端執行。
使用 \/global\/health、\/health、\/openapi.json 和 MCP 發現路徑進行協定感知的健康驗證。
輕量化部署，可安裝 systemd 服務並在開機時自動啟動。
發現、註冊和工作階段交接被打包到適用於多伺服器 Openclaw Skills 設定的單一 CLI 原生工作流程中。