第七章：工具、技能、插件与能力扩展
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
| Profile | 场景 |
|---|---|
full |
可信个人助手，能力最强 |
coding |
编程任务，含文件、运行时、Web、会话等 |
messaging |
通道聊天助手，较窄 |
minimal |
极简，只保留基本状态能力 |
示例：
{ 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 行为写技能；需要结构化动作写工具；需要分发一组能力写插件；只是开关或参数变化先改配置。扩展能力前先设计权限边界。