OpenClaw技能安装教程：轻松添加新功能指南

为OpenClaw安装技能，本质上并非传统意义上的软件安装，更像是为其配置一个专属的“智能工具箱”。每个技能都封装了一套预定义的任务处理逻辑，但要让这套逻辑真正发挥作用，必须与它已获得授权的核心工具（如文件读写、网络请求、API调用等）协同工作。安装得当，它便能自动高效地帮你完成资料检索、邮件撰写、表格分析等任务；若安装不当，或相关权限未正确配置，技能就可能陷入“已加载但无法执行”的尴尬状态。因此，安装过程的核心关键，不在于下载速度的快慢，而在于后续的环境适配、权限绑定与配置注入这三个关键步骤是否精准到位。

通过聊天指令直接安装（最常用方式）

这种方式最适合日常快速添加新功能，尤其当您已在飞书、WhatsApp或QQ等平台成功连接OpenClaw后：

• 在聊天窗口中直接输入类似 /skill install translator 或 帮我安装一个 ta vily-search 技能 的指令，系统将自动拉取技能包并校验其相关依赖。
• 若技能需要额外的API密钥（例如搜索、翻译、邮箱服务），它会暂停流程并提示“请提供 Ta vily API key”，此时您只需直接粘贴并发送密钥即可。
• 若遇到涉及系统操作的高危技能（例如 shell-exec、filesystem-write），系统会进行二次安全确认弹窗，必须手动回复“确认安装”指令才会继续执行。
• 安装完成后，您可以通过询问 你现在有哪些可用技能？ 或 translator 技能具体怎么使用？ 来即时验证技能是否已成功激活并生效。

通过Web控制台图形化安装（云服务器环境首选）

如果您使用的是阿里云、腾讯云等平台的一键部署镜像，或将OpenClaw部署在远程Linux服务器上，通过浏览器访问Web控制台进行操作将更为直观便捷：

• 在浏览器中打开 http://[您的服务器IP地址]:18789 以进入OpenClaw管理控制台界面。
• 点击左侧导航菜单的「Skills 管理」→「+ 添加技能」按钮，在弹出的输入框中填入目标技能名称（例如 email-qq、excel-xlsx）。
• 点击安装后，页面会实时显示技能包的下载进度与依赖安装日志；安装成功后，技能列表将自动刷新并显示新添加的技能。
• 请注意，部分技能图标旁可能会显示 ⚠️ 警告标识，这通常意味着该技能缺少必要的底层工具权限（例如文件读写功能未开启），此时需要先前往「Tools 设置」页面中勾选并启用对应的能力授权。

使用命令行批量安装与管理（面向开发者与运维人员）

当需要批量安装多个技能、进行CI/CD持续集成，或排查技能间的依赖冲突时，命令行方式提供了最透明且可靠的操作途径：

• 首先，请确保已全局安装 clawhub 命令行工具：npm i -g clawhub。
• 搜索可用技能：执行 clawhub search "pdf" 命令，可以查看所有与PDF处理相关的技能及其唯一标识slug（例如 pdf-extractor-v2）。
• 安装指定技能：运行 clawhub install pdf-extractor-v2 命令，支持使用 --force 参数强制覆盖旧版本。
• 更新全部技能：执行 clawhub update --all；卸载特定技能：使用 clawhub uninstall translator 命令。

手动上传技能包安装（适用于断网、限频或定制开发场景）

当ClawHub官方仓库接口响应缓慢、遭遇访问限流，或者您需要调试自己修改过的定制化技能时，手动上传安装是可靠的备选方案：

• 从官方技能仓库 https://clawhub.openclaw.ai 下载对应的.zip格式技能压缩包，解压后会得到一个包含 SKILL.md 说明文件及Python/JS脚本的文件夹。
• 将整个技能文件夹复制到OpenClaw的技能专用目录下：
  • macOS/Linux系统：~/.openclaw/skills/
  • Windows系统：C:\Users\[您的用户名]\AppData\Roaming\npm\node_modules\openclaw\skills\
• 执行 openclaw gateway restart 命令以重启网关服务，使新技能能够成功注册到系统内部。
• 如果该技能依赖额外的第三方模块（例如邮件发送技能需要 nodemailer），您还需要在技能目录下手动补装依赖：执行 npm install nodemailer 命令。