教程 25

教程 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 次時發出警告,避免超限導致服務中斷。


下一步

  • 教程 26 — 用 Agent Browser 處理需要登入態或 JavaScript 渲染的網頁
  • 教程 24 — 把你的自動化工作流封裝成 Skill 發布到 ClawHub

关注我们,获取最新 AI 动态

在 X 上关注 @lanmiaoai,第一时间获取教程更新、AI 工具推荐。

立即关注