一個輕量級、零依賴的 Node.js HTTP 用戶端，具備自動重試與優雅的錯誤處理功能，用於發起具彈性的 API 請求。
安裝與下載
1. ClawHub CLI
從來源直接安裝技能的最快方式。
npx clawhub@latest install simplehttpskill
2. 手動安裝
將技能資料夾複製到以下位置之一
~/.openclaw/skills/ <project>/skills/ 優先級：工作區 > 本地 > 內建
3. 提示詞安裝
將此提示詞複製到 OpenClaw 即可自動安裝。
請幫我使用 Clawhub 安裝 simplehttpskill。如果尚未安裝 Clawhub，請先安裝（npm i -g clawhub）。
想要直接下載？
取得包含原生技能檔案的ZIP壓縮檔。
什麼是 Simple HTTP？
Simple HTTP 技能是專為 AI 代理與 Web 服務及 API 交互而設計的高性能工具。作為 Openclaw Skills 的原生組件，它基於 Node.js 模組構建，無需外部庫即可實現無縫的 GET、POST、PUT 和 DELETE 操作。它專為可靠性而設計，內建對自定義請求頭和自動有效負載序列化的支持，是代理在網路上獲取或發送數據時必不可少的工具。
透過利用原生的 Node.js http 和 https 模組，該技能確保了極小的占用空間和跨不同環境的高相容性。它透過提供一個統一的接口來處理網路級錯誤和特定的 HTTP 狀態碼，從而簡化了請求管理的複雜性。
Simple HTTP 應用場景
- 從 RESTful API 獲取數據，供代理處理和決策。
- 向第三方服務發送即時 Webhook 和事件通知。
- 與雲端微服務交互以觸發外部工作流。
- 自動化需要強大錯誤處理和自動重試的數據檢索任務。
Simple HTTP 運作原理
- 用戶實例化 HttpClient，可選擇性地定義全域設置，如基礎請求頭、超時和最大重試次數。
- 使用特定的 HTTP 方法（GET、POST 等）和目標 URL 發起請求。
- 該技能自動將基於物件的請求體序列化為 JSON 並設置相應的請求頭。
- 如果發生暫時性錯誤（如連線超時、速率限制 (429) 或伺服器錯誤 (5xx)），該技能將應用帶有抖動的指數退避策略。
- 在完成或重試耗盡後，該技能返回一個標準化的響應物件，其中包含狀態碼、請求頭和解析後的內容以便檢查。
Simple HTTP 設定指南
要在 Openclaw Skills 框架內使用此工具，請確保源文件在您的專案中可用。您可以按如下方式初始化並使用用戶端：
const { HttpClient } = require("./src/http-client");
const client = new HttpClient({
defaultHeaders: { "Authorization": "Bearer YOUR_TOKEN" },
maxRetries: 3
});
由於該技能完全依賴於內建的 Node.js 模組，因此不需要安裝外部 npm 套件。
Simple HTTP 資料結構與分類體系
所有請求都返回一致的響應物件，以簡化代理邏輯：
| 鍵 | 類型 | 描述 |
|---|---|---|
ok |
boolean | 如果 HTTP 狀態碼在 2xx 範圍內，則為 true |
status |
number | null | 數字 HTTP 狀態碼，如果是網路錯誤則為 null |
headers |
object | 響應頭的鍵值對 |
body |
any | 響應負載，如果內容是 JSON 則自動解析 |
error |
string | null | 如果請求失敗，則提供描述性錯誤消息 |
Simple HTTP 進階特性
- 內建帶有抖動的指數退避機制，以減輕速率限制和暫時性伺服器不穩定的影響。
- 零依賴架構，僅使用 Node.js 核心模組，確保最高安全性和速度。
- 自動為請求體進行 JSON 序列化，並對響應數據進行智能解析。
- 採用不拋出異常的錯誤處理模型，透過始終返回響應物件來確保 AI 代理可預測的流控制。
SKILL.md
加載中
Openclaw 相關技能
Permissions Broker
一個安全優先的代理，使 AI 智能體能夠透過 Telegram 人機交互審批存取第三方 API 和 Git 倉庫。
Better Auth 雙重身份驗證實作
一份關於使用 Better Auth 框架及其 twoFactor 插件實作安全多因素身份驗證的全面指南與技能。
精選*
