为 OpenClaw 安装技能（Skills）主要有三种方式，您可以根据习惯选择最适合您的方法。

🛠️ 准备工作：确认环境与版本

无论使用哪种方式，建议先完成以下检查：

1. 确认 OpenClaw 版本

   确保版本 ≥ 2026.2.21，此版本后技能生态趋于稳定。

   bash

   openclaw --version

2. 检查技能目录

   默认路径为 ~/.openclaw/skills/。如果不存在，请手动创建。

   bash

   mkdir -p ~/.openclaw/skills

3. 检查 clawhub工具

   推荐使用 npx clawhub命令，无需全局安装。

   bash

   which npx

   若返回路径，如 /usr/bin/npx，则表示正常

🥇 方法一：使用 clawhub命令行安装 (官方推荐)

此方法适合在服务器或本地终端操作，可以自动处理依赖和校验。

1. 登录 ClawHub (如需)

   部分私有技能需要登录，使用管理员 Token 登录。

   bash

   npx clawhub login --token 你的管理员Token

2. 搜索技能

   查找您需要的技能，例如 memory-manager。

   bash

   npx clawhub search memory-manager

3. 安装技能

   执行安装命令，技能会自动下载到默认目录。

   bash

   npx clawhub install memory-manager

   您也可以指定安装目录：

   bash

   npx clawhub install --dir ~/.openclaw/skills memory-manager

4. 验证安装

   检查技能是否已就绪。

   bash

   openclaw skills check

   openclaw skills list --all

   当看到 memory-manager出现在 Ready to use列表中，即表示安装成功。

📦 方法二：通过 Web 控制台安装

如果您使用的是阿里云一键部署版或 OpenClaw 控制台，此方法更直观。

1. 登录控制台

   在浏览器访问 http://你的服务器IP:18789，使用管理员 Token 登录。

2. 进入技能商店

   在顶部或侧边栏找到 “技能商店 / ClawHub” 入口。

3. 一键安装

   浏览或搜索技能，点击“一键安装”。安装完成后，可在 “已安装技能” 列表中查看其状态是否为“已启用”。

📁 方法三：手动安装 (ZIP包/源码)

此方法适合离线环境或 clawhub命令受限的情况。

1. 从 ZIP 包安装

1. 下载并解压：从 ClawHub 官网或技能页面下载 .zip包并解压。

2. 复制到目录：将解压后的整个技能文件夹复制到 OpenClaw 的技能目录。

   bash

   示例

   unzip memory-manager-1.0.0.zip -d /tmp/skills/

   cp -r /tmp/skills/memory-manager-1.0.0 ~/.openclaw/skills/

3. 验证：执行 openclaw skills check确认安装。

2. 从 GitHub 克隆

1. 克隆仓库：将技能源码克隆到技能目录。

   bash

   git clone https://github.com/username/skill-name.git~/.openclaw/skills/skill-name

2. 安装依赖：根据技能说明，进入目录安装依赖。

   bash

   cd ~/.openclaw/skills/skill-name

   Node.js 项目

   npm install

   Python 项目

   pip3 install -r requirements.txt

3. 验证：执行 openclaw skills check确认安装。

🔑 配置技能密钥 (API Key)

许多技能需要配置密钥才能使用，请遵循以下原则：

• 查阅文档：打开技能的 SKILL.md文件，找到 env:字段列出的所需环境变量，如 TAVILY_API_KEY。

• 安全设置：通过环境变量设置密钥，切勿硬编码在代码中。

  bash

  Linux / macOS

  export TAVILY_API_KEY="你的密钥"

  Windows (PowerShell)

  [System.Environment]::SetEnvironmentVariable('TAVILY_API_KEY', '你的密钥', 'User')

• 重启生效：设置完成后，重启 OpenClaw 服务。

  bash

  npx openclaw gateway restart

🔍 如何验证技能是否生效

1. 使用命令检查

   bash

   openclaw skills check

   openclaw skills list --all

   查看目标技能是否出现在 Ready to use列表中。

2. 在对话中测试

   向 OpenClaw 发送指令，测试技能是否被调用。

   “请使用 memory-manager 技能，记录我们今天的对话要点。”

💡 常见问题与解决

• Skill not found: 检查技能名称是否拼写正确，或尝试使用离线安装方法。

• Rate limit exceeded: clawhub命令请求过于频繁，请等待几分钟后重试，或改用 ZIP 包离线安装。

• Missing requirements: 技能缺少依赖。根据错误提示，使用 npm install或 pip3 install安装所需工具，或安装系统级依赖（如 brew install openai-whisper）。

• 技能不生效:

• 确认 SKILL.md文件存在于技能根目录且 YAML 格式正确。

• 检查脚本文件是否具有可执行权限 (chmod +x scripts/*.sh)。

• 确认所需的环境变量已在系统中正确设置。