教程 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 工具推荐。

立即关注