本教程鎖定四件事可復現：① 在 VS Code／相容編輯器安裝 OpenClaw Node 擴充功能並指向獨佔遠端 Mac；② 讓擴充功能讀到工作區根目錄下的技能（.cursor/skills、專案內 SKILL.md 或團隊約定的等價路徑）；③ 與遠端 Gateway 及 ACP（Agent Client Protocol） 端點完成聯調（含本機回呼埠）；④ 用 SSH 埠轉發把僅在遠端 loopback 上的服務帶到筆電，並用分診表排錯。
- 已可用 SSH 登入的獨佔遠端 Mac，且 OpenClaw CLI／閘道版本與組織 Runbook 一致（升級後務必跑
openclaw doctor）。
- 閘道預設僅監聽
127.0.0.1:18789（埠號以你環境為準）；ACP 或擴充功能回呼埠亦應避免裸奔 0.0.0.0，除非已疊防火牆與審核。
- 工作區目錄已含技能定義；若多工作區，先釐清「哪個資料夾是單一工作區根」以免載入順序打架（可對照站內 Skills 優先級文章）。
建議路徑 B（Remote-SSH）：使用 Remote - SSH 直接開遠端資料夾時，確認擴充功能在「遠端」而非「本機」脈絡啟用；否則會讀不到遠端工作區內技能檔。切換方式：命令選擇板 → Developer: Show Running Extensions，檢視 OpenClaw Node 是否標記為 SSH: …。
- Gateway Base URL：若走 SSH 隧道，填
http://127.0.0.1:
<本地轉發埠>，勿在設定檔硬編碼生產權杖。
- 工作區技能根：留空表示「自動偵測工作區根」；多根目錄時改為明確相對路徑並寫入 Runbook。
- ACP／回呼埠：與閘道約定同一埠區間，避免與本機其他代理或 Docker 綁定衝突。
- 工作區根是否正確：只開單一資料夾測試；若使用 multi-root，確認技能檔落在「被標記為預設根」的那個資料夾。
- 檔名與層級：常見約定為
.cursor/skills/
/SKILL.md
或專案根 skills/；大小寫在 macOS 預設檔案系統上不區分，但在同步工具與 CI 上可能區分——Runbook 應寫死一種。
- 重新載入：變更技能後執行
Developer: Reload Window；遠端連線時順便觀察擴充功能輸出通道是否報 YAML／JSON 解析錯誤。
- 權限：SSH 使用者對技能目錄需可讀；若技能內含可執行腳本，確認未違反組織的簽章政策。
閘道健康檢查：在遠端 Mac 上先以 curl 打 loopback 健康或最小 API（依你版本文件），確認 200／預期 JSON。筆電端再透過 SSH 隧道重複同一步驟，若僅筆電失敗，問題在隧道或本機代理。
ACP 聯調：ACP 讓編輯器以標準化訊息與代理／閘道交換能力宣告與工具呼叫。實務上請對齊三件事：① 擴充功能與閘道使用同一協定版本；② WebSocket／HTTP+SSE 等傳輸層與公司代理相容；③ 回呼 URL 若指向 127.0.0.1，必須發生在「發起請求的那台機器」上——遠端閘道要回呼筆電時，需改為可路由位址或再加一條反向隧道／內網服務發現。
若你的主線還包含 OpenAI 相容 HTTP 層與 /v1/chat/completions，請與 Gateway 設定一併驗收，細節可對照站內「Gateway OpenAI 相容 API」長文。
ssh -N -L 18080:127.0.0.1:18789
ssh -N
-L 18080:127.0.0.1:18789 -L 19090:127.0.0.1:19090
bind: Address already in use 隧道可建但
curl 逾時 遠端服務是否只監聽 IPv6；試
::1 映射或改閘道監聽位址。 Bearer／閘道權杖是否與
launchd 環境變數一致；是否半舊行程未重啟。 系統代理、PAC、SSL 檢查；必要時為 SSH 單獨設
ProxyCommand。
- E1：遠端 loopback
curl 閘道健康 → 通過。
- E2：筆電經隧道
curl 同一健康 → 通過。
- E3：擴充功能「技能列表」載入專案內測試技能 → 通過。
- E4：ACP 能力宣告與一筆最小工具呼叫（唯讀）→ 通過。
- E5：關閉隧道後請求應失敗 → 證明未繞過 SSH 邊界。
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容，请联系我们，一经查实，本站将立刻删除。
如需转载请保留出处：https://51itzy.com/kjqy/278831.html