OpenClaw技能安装指南：三步添加新功能与插件教程

为OpenClaw安装技能，其本质并非传统意义上的软件安装，而更接近于为其配置一个专用的“工具集”。每个技能都封装了一套特定的任务处理逻辑，但要让这套逻辑顺利执行，必须将其与OpenClaw已获得授权的底层工具（如文件系统访问、网络请求等）进行正确关联。配置得当，它便能自动化地处理资料检索、邮件撰写或表格分析；若配置有误或权限缺失，技能便会陷入“已加载但无法激活”的困境。因此，安装的核心挑战不在于下载过程，而在于后续的环境适配、权限绑定与配置注入这三个关键环节是否精准完成。

通过聊天指令直接安装（最高效的日常方式）

这是最快捷的日常添加方法，尤其适用于已在飞书、WhatsApp或QQ中集成了OpenClaw的场景：

• 在聊天界面输入如 /skill install translator 或 帮我装一个 ta vily-search 技能 的指令，系统将自动拉取技能包并校验其依赖项。
• 若技能需要API密钥（例如搜索、翻译或邮件服务），流程会暂停并提示“请提供 Ta vily API key”，此时直接粘贴并发送密钥即可。
• 遇到涉及系统操作的高风险技能（如 shell-exec、filesystem-write），系统会触发二次安全确认弹窗，必须手动回复“确认安装”方可继续。
• 安装完成后，通过询问 你现在有哪些技能？ 或 translator 怎么用？ 来即时验证技能是否已成功加载并可用。

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

如果你使用的是阿里云、腾讯云的一键部署镜像，或将OpenClaw部署在远程Linux服务器上，通过浏览器操作界面更为直观：

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

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

当需要批量部署技能、集成到CI/CD流水线，或排查依赖冲突时，命令行方式提供了最透明且可靠的控制：

• 首先确保已全局安装 clawhub 命令行工具：npm i -g clawhub。
• 搜索技能：执行 clawhub search "pdf" 可查看所有相关的PDF处理技能及其唯一标识符（例如 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。