教程 25 — OpenClaw API Gateway Skill 教程:零配置 OAuth 接入 Slack、HubSpot 等 100+ 服務(2026)
目標:安裝 API Gateway Skill,無需自己申請 OAuth 憑證,直接讓 OpenClaw 連接 Google Workspace、Microsoft 365、GitHub、Notion、Slack、Airtable、HubSpot 等 100+ 服務。
API Gateway 的核心價值
openclaw oauth 授權不用自己申請 key,是 API Gateway Skill 最大的賣點。
傳統做法:要讓 OpenClaw 發 Slack 訊息,你需要去 Slack 開發者後台註冊 App、申請 OAuth 憑證、配置回調 URL、儲存 token……整個過程至少 30 分鐘,還容易出錯。
API Gateway 的做法:安裝 Skill → 點擊授權連結 → 完成。OAuth 憑證由 API Gateway 雲端統一託管,你只需一次點擊授權即可使用。
支援的 100+ 服務分類
| 類別 | 服務 |
|---|---|
| 通訊協作 | Slack、Microsoft Teams、Discord、Gmail、Outlook |
| 專案管理 | Notion、Trello、Asana、Linear、Jira、Basecamp |
| CRM / 銷售 | HubSpot、Salesforce、Pipedrive、Zoho CRM |
| 資料 / 表格 | Airtable、Google Sheets、Smartsheet、Coda |
| 雲端儲存 | Google Drive、Dropbox、OneDrive、Box |
| 開發工具 | GitHub、GitLab、Bitbucket、Vercel、Netlify |
| 日曆 | Google Calendar、Outlook Calendar、Calendly |
| 電商 / 支付 | Shopify、Stripe、WooCommerce |
openclaw api gateway skill 支援哪些服務的完整列表可在安裝後執行 /api-gateway list 查看。
第一步:安裝 Skill
/install @byungkyu/api-gateway
驗證:
pnpm openclaw skills list
# 列表中應出現 api-gateway第二步:授權第一個服務(以 Slack 為例)
openclaw 連接 slack 發訊息免配置的完整步驟:
1. 觸發授權流程:
/api-gateway auth slack
2. OpenClaw 返回一個授權連結:
請點擊以下連結完成 Slack 授權:
https://gateway.clawhub.io/auth/slack?token=xxxx&callback=openclaw
3. 在瀏覽器中打開連結,用你的 Slack 帳號登入並點擊「允許」。
4. 頁面跳轉回 OpenClaw 並顯示:
Slack 授權成功!工作區:Your-Team-Name
可用權限:發送訊息、讀取頻道列表、上傳檔案
授權資訊加密儲存在 API Gateway 雲端,OpenClaw 本地只儲存一個短期 access token,有效期內自動刷新,無需重複授權。
第三步:發送 Slack 訊息示例
授權完成後,直接用自然語言操作:
用 Slack 給 #general 頻道發一條訊息:
「本週五下午 3 點有全員會議,請確認出席。」
或使用結構化命令:
/api-gateway slack send-message --channel general --text "本週五全員會議,請確認出席"
發送私訊:
通過 Slack 給 @zhangwei 發私訊:明天的設計稿我已經看過了,有幾處需要調整,方便今天下午溝通嗎?
第四步:讀取 Airtable 資料示例
openclaw airtable 資料庫 ai 操作教程的核心步驟,先授權:
/api-gateway auth airtable
授權後查詢資料:
讀取 Airtable 裡「客戶跟進」表格中,狀態為「待跟進」的所有記錄,
列出客戶名稱、聯絡人、上次跟進時間
新增記錄:
在 Airtable 的「客戶跟進」表格新增一條記錄:
客戶名稱:XX科技,聯絡人:李總,狀態:初次接觸,跟進日期:2026-03-30
第五步:HubSpot CRM 操作示例
openclaw hubspot crm ai 自動化的常用場景:
查詢聯絡人:
/api-gateway hubspot search-contact --email zhang@example.com
建立跟進任務:
在 HubSpot 給聯絡人 zhang@example.com 建立一個跟進任務:
任務內容:發送 Q1 產品方案,截止日期:2026-04-05
批量更新線索狀態(結合 AI 分析):
讀取 HubSpot 中本月新增的所有線索,按公司規模分類,
把員工人數超過 500 人的線索狀態改為「高優先級」
第六步:API Gateway vs 直接配置 MCP 的選擇
openclaw oauth 授權不用自己申請 key 是 API Gateway 的核心優勢,但兩種方案各有適用場景:
| 場景 | 推薦方案 |
|---|---|
| 快速接入標準 SaaS 服務(Slack、HubSpot 等) | API Gateway |
| 需要自定義權限範圍或使用企業內網服務 | 直接配置 MCP |
| 公司有自己的 OAuth 應用,需要使用獨立 App | 直接配置 MCP |
| 個人使用者,不想管理 API Key | API Gateway |
| 對資料安全有極高要求,不希望任何憑證經過第三方 | 直接配置 MCP |
常見問題
API Gateway Skill 和直接配置 MCP 有什麼區別?
API Gateway Skill 把 OAuth 憑證管理託管給 ClawHub 的雲端網關,你無需自己申請 App 或儲存 token,適合快速接入主流 SaaS 服務。直接配置 MCP 需要你自己在對應平台建立開發者應用、申請憑證,並在 OpenClaw 配置檔案中手動填寫,流程更繁瑣但完全自主可控,適合企業內部服務或對資料主權有嚴格要求的場景。兩種方式功能上等價,區別在於誰來管理憑證。
用 API Gateway 接 Slack 需要企業帳號嗎?
不需要,免費的 Slack 個人或小團隊帳號同樣支援。API Gateway 使用 Slack 官方 OAuth 授權流程,與帳號類型無關。唯一限制是 Slack 免費版對訊息歷史有 90 天限制,這是 Slack 本身的限制,與 API Gateway 無關。企業付費帳號不受此限制。
授權資訊存在哪裡,安全嗎?
OAuth access token 加密儲存在 ClawHub 的 API Gateway 伺服器上,採用 AES-256 加密,OpenClaw 本地只快取有效期內的短期 token(預設 1 小時)。ClawHub 不會讀取或記錄通過 API Gateway 傳輸的業務資料內容,只負責憑證的刷新和轉發。如果你在 ClawHub 帳號設定中撤銷授權,對應服務的 token 立即失效。
如果某個服務 API 有調用限制,API Gateway 會處理嗎?
會。API Gateway 內建了速率限制保護(Rate Limit Guard),當檢測到接近服務商的調用頻率上限時,會自動排隊和限速,並在 OpenClaw 對話中提示當前配額使用情況。例如 HubSpot 免費版每天 250 次 API 調用,API Gateway 會在剩餘 50 次時發出警告,避免超限導致服務中斷。