Capabilities

集成

10分钟

通过插件、工具和 Skills,把 OpenClaw 连接到生产力应用、浏览器、开发者工具、搜索服务、媒体服务和远程设备。

集成是三个扩展层共同产生的结果:

  • tools 让 Agent 能行动
  • skills 教 Agent 某个服务的工作流
  • plugins 增加运行时能力和凭证处理

不要假设每个集成都有一个内置 integrations 命令。很多能力是通过 skill 或 plugin 安装后,再以普通工具形式暴露出来。

生产力应用

常见集成包括:

  • Gmail
  • Google Calendar
  • Google Drive
  • Slack
  • Discord
  • Linear
  • GitHub
  • Obsidian 或本地 notes vault
  • Apple Notes / Reminders

通用流程:

  1. 安装或启用能力
  2. 安全授权凭证
  3. 定义 Agent 可以做什么
  4. 先测试只读动作
  5. 手动流程稳定后再加自动化

Google Workspace 示例

Google Workspace 通常通过 skill 或 plugin-backed provider 路径提供,而不是单一 core command。

bash
openclaw skills search google
openclaw plugins list
openclaw doctor

先用只读 prompt:

text
List my next three calendar events. Do not create or edit anything.

明确权限边界后,再做 draft、label 或创建日程。

浏览器集成

Browser 工具是没有 API 的 Web app 的通用 fallback。

适合:

  • 需要登录态的 dashboard
  • 表单填写并等待确认
  • 只有 UI 的后台系统
  • 需要导航的调研
  • 静态抓取无法处理的页面

静态内容优先用 web_fetch 或搜索 provider。

开发者工具

开发者集成通常组合 tools 和 skills:

  • GitHub / GitLab 工作流
  • Linear issue 管理
  • release note 起草
  • CI/CD webhook 通知
  • code review rubric
  • ACP-backed coding agents

破坏性动作要保留确认步骤。

搜索与研究 Provider

OpenClaw 支持多种搜索路径,例如 Brave、DuckDuckGo、Exa、Firecrawl、Gemini、Kimi、Ollama、Parallel、Perplexity、SearXNG、Tavily 以及 provider-specific web-grounded APIs。

Key-free 或 free hosted provider 应该显式选择,不要依赖意外 fallback。

媒体与语音服务

媒体集成可以增加:

  • 图片生成
  • 视频生成
  • 音乐生成
  • speech-to-text
  • text-to-speech
  • 语音通话
  • realtime talk modes

这些能力通常依赖 provider 凭证、plugin 可用性和渠道支持。

远程设备

Nodes 把一个 Gateway 延伸到其他设备。节点可以暴露 camera、screen、location、Canvas、talk mode 或平台特定动作。

bash
openclaw devices list
openclaw devices approve <requestId>
openclaw nodes status

Integration Design Rules

  1. 从只读开始。
  2. 把 secrets 存在 prompt 文件之外。
  3. 尽量使用 SecretRefs 或 provider auth profiles。
  4. Skill instructions 保持窄范围。
  5. 代码支撑的能力优先用 plugins。
  6. 手动任务稳定后再加自动化。
  7. 记录并审查副作用。

集成架构

一个可靠集成不只是 API 调用。它还需要凭证、策略、工具暴露、可读工作流、观测和外部服务变化后的恢复路径。

继续实践

集成 的核心概念已经读完

如果你想把理解变成可复用的能力,可以到 AgentWay 继续练习