第七章：工具、技能、插件与能力扩展

OpenClaw 的扩展能力由工具、技能、插件三层组成：工具是 Agent 可调用函数，技能是使用工具的方法说明，插件是分发通道、工具、模型 provider、技能和媒体能力的包。

7.1 内置工具

常见工具包括 exec/process、code_execution、browser、web_search/web_fetch、read/write/edit/apply_patch、message、canvas、nodes、cron、gateway、image/image_generate、music_generate、video_generate、tts、sessions_*、subagents、session_status。工具越强，越需要权限控制。

7.2 工具 profile

示例：

{ tools: { profile: "messaging", alsoAllow: ["web_search", "web_fetch"] } }

7.3 allow、deny 与工具组

{
  tools: {
    allow: ["group:fs", "browser", "web_search"],
    deny: ["exec"],
  },
}

deny 优先。常见组：group:runtime、group:fs、group:sessions、group:web、group:ui、group:automation、group:messaging、group:nodes、group:media。

7.4 技能优先级

OpenClaw 加载技能优先级：<workspace>/skills、<workspace>/.agents/skills、~/.agents/skills、~/.openclaw/skills、内置技能、skills.load.extraDirs。同名技能高优先级覆盖低优先级。

7.5 SKILL.md

最小格式：

---
name: image-lab
description: 生成或编辑图片的工作流说明
---

当用户要求生成图片时，先确认尺寸、风格和用途，再调用 image_generate。

技能可通过 metadata 按 OS、二进制、环境变量、配置项 gating。第三方技能应视为不可信内容，安装前阅读。

7.6 ClawHub

openclaw skills install <skill-slug>
openclaw skills update --all

ClawHub 是技能注册中心。安装技能不等于安装安全代码，仍应检查其指令是否会诱导危险工具。

7.7 插件

插件可注册通道、工具、模型 provider、技能、语音、媒体生成、Web search/fetch、诊断等能力。插件应提供 manifest、contracts 和配置 schema，让 Gateway 能发现、校验和在 Control UI 中展示。

7.8 选择原则

只改变 Agent 行为写技能；需要结构化动作写工具；需要分发一组能力写插件；只是开关或参数变化先改配置。扩展能力前先设计权限边界。