教程 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 次时发出警告,避免超限导致服务中断。