OpenClaw技能skill指南,从Hello World开始
用了这么多次的skill了特别想来谈下这个skill。Skill 到底怎么跑起来的咱们从一个 “Hello World” 开始吧。第一部分技能 (Skills) —— 让助手学会新本领1. 什么是“技能”想象一下您的 AI 助手原本是一个通用的天才但您希望它懂一些特定的“行话”或执行特定的任务比如专门处理公司内部数据或者用特定的语气打招呼。“技能” (Skill)就是为此设计的。本质它是一个文件夹。核心文件文件夹里必须包含一个SKILL.md文件。这个文件就像是一本“说明书”告诉 AI 这个技能是做什么的以及该使用什么工具。扩展性您可以随意添加脚本或资源文件让技能更强大。2. 手把手教您创建第一个技能我们要创建一个名为 “Hello World” 的简单技能让助手学会用特定的方式打招呼。 技能创建流程图是否开始创建文件夹编写 SKILL.md需要自定义工具吗定义工具或脚本跳过此步刷新 OpenClaw测试技能完成️ 具体步骤第一步安家落户创建目录技能通常存放在工作区的skills目录下。在终端执行以下命令为您的新技能建个“家”mkdir-p~/.openclaw/workspace/skills/hello-world第二步编写说明书定义 SKILL.md在上述文件夹中创建一个名为SKILL.md的文件。它由两部分组成头部元数据 (YAML)告诉系统技能的名称和简介。指令内容 (Markdown)告诉 AI 具体该怎么做。文件内容示例--- name: hello_world description: 一个简单的打招呼技能。 --- # Hello World 技能 当用户请求问候时请使用 echo 工具回复Hello from your custom skill!来自您定制技能的问候。第三步添加工具可选如果您需要 AI 执行特殊操作可以在头部定义自定义工具或者直接指示它使用系统自带的工具如 bash 命令行或浏览器。第四步激活技能创建完成后只需对助手说“refresh skills”刷新技能或重启网关。OpenClaw 会自动发现新文件夹并读取说明书技能即刻生效 最佳实践小贴士简明扼要直接告诉模型“做什么”而不是教它“如何成为 AI”。安全第一如果技能涉及运行命令行 (bash)请务必小心防止恶意代码注入。本地测试使用命令openclaw agent --message use my new skill来验证您的技能是否正常工作。共享社区您还可以将写好的技能上传到ClawHub与他人分享。第二部分斜杠指令 (Slash Commands) —— 与助手的快捷沟通指令是您直接向 OpenClaw 网关发送的控制信号。它们通常以/开头例如/help或者是 host 专用的!开头例如!ls。1. 指令系统的两大阵营类型前缀特点示例命令 (Commands)/独立消息执行具体动作或查询状态。/status,/skill hello指令 (Directives)/改变会话行为模式的开关如思考深度、语速。/think,/fast,/verbose2. 指令是如何工作的逻辑解析为了让您理解指令的处理逻辑我们来看下面的流程 指令处理逻辑图AI 模型权限检查网关 (Gateway)用户AI 模型权限检查网关 (Gateway)用户指令作为内联提示不持久化alt[消息仅包含指令 (如: /think high)][消息包含指令 内容 (如: /think high 请解释...)]未授权用户看到的指令会被当作普通文本发给 AI发送消息 (例如: /think high 请解释量子力学)检查发送者权限授权通过应用会话设置 (持久化)回复确认 (已开启高深度思考模式)剥离指令部分仅发送剩余内容 (请解释量子力学)返回回答关键点说明权限控制只有经过授权的发送者在白名单中发出的指令才会被系统识别和执行。否则AI 会把它当成普通聊天内容处理。持久化 vs 一次性如果您只发指令如/fast设置会持续生效直到会话结束。如果您在聊天中带指令如/fast 讲讲笑话指令仅对当前这句话有效。快捷捷径像/help,/whoami这样的命令会立即执行并显示结果不会发送给 AI 模型。3. 常用指令速查表为了方便您使用我们将指令按功能进行了分类整理 基础与状态/help查看帮助。/status显示当前状态包括配额使用情况。/whoami(或/id)查看您的发送者 ID。/commands列出所有可用命令。/usage查看 Token 用量或成本摘要。 模型行为控制 (Directives)/think 级别调整思考深度 (off, minimal, low, medium, high, xhigh)。/fast开启/关闭快速模式。/verbose调整回复的详细程度 (on, full, off)。/reasoning是否展示推理过程。/elevated提升权限模式可跳过执行确认。/model 名称切换使用的 AI 模型。️ 技能与会话管理/skill 名称运行指定技能。/reset(或/new)重置会话或开启新会话。/export-session将会话导出为 HTML。/context查看当前上下文窗口的大小和构成。/subagents管理子代理查看、杀死、生成等。/focus//unfocus(Discord 专用) 绑定或解绑线程到会话。⚙️ 高级配置 (需 Owner 权限)/config读写配置文件。/mcp管理 MCP 服务器配置。/plugins管理插件启用/禁用。/debug运行时调试覆盖。 主机命令 (Host-only)! 命令直接在主机运行 Shell 命令需开启commands.bash。/bash 命令同上另一种写法。!poll/!stop轮询或停止正在运行的后台任务。第三部分配置详解 (Config) —— 掌控全局OpenClaw 的配置非常灵活主要通过 JSON 格式进行设置。以下是核心配置项的通俗解读核心配置结构示例{commands:{native:auto,// 是否注册平台原生指令如 Discord 的 slash commandtext:true,// 是否允许在聊天文本中解析 /指令bash:false,// 【危险】是否允许运行主机 Shell 命令 (! cmd)allowFrom:{// 指令权限白名单*:[user1],// 全局默认允许 user1discord:[user:123]// Discord 渠道特例},useAccessGroups:true// 是否启用访问组策略}}关键配置项说明配置项默认值作用解读commands.texttrue文本指令开关。设为true时您可以在聊天中直接输入/help。即使在 WhatsApp 等不支持原生指令的平台只要此项开启文本指令依然有效。commands.nativeauto原生指令注册。自动在 Discord/Telegram 注册斜杠命令。Slack 需要手动配置设为false可清除已注册的命令。commands.bashfalse主机命令开关。设为true才能使用! ls这类命令。注意安全风险务必配合白名单使用。commands.allowFromnull终极白名单。如果设置了此项系统将只认这里的列表忽略其他渠道的权限设置。使用*代表全局默认。commands.nativeSkillsauto技能原生化。自动将技能注册为平台的原生命令如 Discord 的/skill-name。特殊场景提示多平台差异Discord 和 Telegram 支持原生斜杠命令体验更好Slack 需要在 Slack 后台手动添加每个命令WhatsApp/WebChat 等则完全依赖文本指令 (commands.text)。安全警示开启bash功能时请确保tools.elevated白名单配置正确防止未授权用户执行危险命令。权限优先级allowFrom的优先级最高。一旦配置其他所有的渠道白名单都将失效系统只认allowFrom里的名单。结语Skill 的本质就是“可执行的知识”OpenClaw 的Skill远不止是一个“扩展包”机制。它是一套以自然语言为接口、以代码为能力、以沙箱为保障的智能体扩展架构。它的核心思想是不要限制 AI 能调用什么函数而是教会它如何解决问题。这或许正是下一代 AI 助手的发展方向不是更多 API而是更强的自主编程能力。希望这份指南能帮助您轻松驾驭 OpenClaw Skills如有更多细节需求随时使用/help或在 ClawHub 中探索更多社区技能。