如何安装SkillClaw：macOS、Linux与Windows跨平台完整教程（附6个常见坑）

【免费下载链接】SkillClawLet Skills Evolve Collectively with Agentic Evolver项目地址: https://gitcode.com/gh_mirrors/sk/SkillClaw

SkillClaw 是一个让 AI Agent 技能从真实对话中自动进化的开源框架，支持 Hermes、OpenClaw、Codex、Claude Code 等主流 Agent。这篇 SkillClaw 安装教程将带你完成 macOS、Linux 与 Windows 三个平台的完整部署：从克隆仓库、一键安装、skillclaw setup配置，到启动验证，并附上 6 个新手最常踩的坑，照着做 10 分钟即可跑通。

一、安装前准备：3个前置要求清单

开始之前，先确认你的环境满足以下条件：

💡 提示：只有当你要使用openclawCLI 集成或服务端agent引擎时，才需要额外安装openclaw，新手阶段可以完全跳过。

二、macOS / Linux 一键安装：最快配置方法

这两个平台提供官方 Shell 安装脚本，三条命令搞定：

git clone https://gitcode.com/gh_mirrors/sk/SkillClaw && cd SkillClaw bash scripts/install_skillclaw.sh source .venv/bin/activate

安装脚本 scripts/install_skillclaw.sh 会自动完成：

1. 创建独立的虚拟环境.venv；
2. 以可编辑模式安装全部依赖（pip install -e ".[evolve,sharing,server]"）；
3. 打印激活命令和下一步操作。

脚本还支持--venv-dir自定义虚拟环境位置、--run-setup/--run-start直接串联后续步骤，适合喜欢一步到位的用户。

三、Windows PowerShell 手动安装步骤

⚠️ 注意：仓库目前没有原生的.ps1安装脚本，Windows 需要手动安装，步骤如下：

git clone https://gitcode.com/gh_mirrors/sk/SkillClaw Set-Location SkillClaw python -m venv .venv .\.venv\Scripts\Activate.ps1 python -m pip install -U pip python -m pip install -e ".[evolve,sharing,server]"

安装成功后，skillclaw命令即可在 PowerShell 中使用。如果提示"无法加载脚本"，先执行一次Set-ExecutionPolicy -Scope CurrentUser RemoteSigned。

四、skillclaw setup 配置向导：新手推荐选项

安装完成后，运行配置向导生成本地配置：

skillclaw setup

向导会依次询问：LLM 提供商、模型、本地技能目录、PRM 设置、可选的 CLI Agent 集成、可选的共享存储。新手第一次跑通时，推荐这样选（配置逻辑见 skillclaw/setup_wizard.py）：

• CLI Agent选none，先不改动任何外部 Agent 配置；
• 技能目录保持默认~/.skillclaw/skills；
• 共享存储先关闭；若以后想在同一台机器加 Evolve Server，可开启local后端（如~/.skillclaw/local-share）；
• PRM关闭，先把成本压到最低。

五、启动与验证：健康检查3步法

skillclaw start --daemon skillclaw status

默认代理端口是30000，如果你改过proxy.port，健康检查请以实际配置为准。

到这里，SkillClaw 已经可以作为单用户本地代理使用了——接下来正常和你的 Agent 对话即可，技能进化会在后台无感完成。🎉

六、可选进阶：一条命令开启本地自动进化

想体验"会话记录 → 技能进化 → 回写复用"的完整闭环，在同一台机器上加一个 Evolve Server 即可（前提：setup 时已开启local共享存储）：

skillclaw-evolve-server --use-skillclaw-config --interval 300 --port 8787

团队部署则使用独立安装脚本 scripts/install_skillclaw_server.sh，并基于 evolve_server/evolve_server.env.example 复制出evolve_server/.env，填入存储与 LLM API 配置后启动。Windows 手动安装服务端的命令为python -m pip install -e ".[server]"。

七、6个常见安装坑与解决办法（避坑清单）

坑1：Python 版本过低导致安装失败

SkillClaw 要求 Python >= 3.10。执行python3 --version检查；macOS 老版本系统建议用 Homebrew 升级 Python，或直接指定解释器：bash scripts/install_skillclaw.sh --python /path/to/python3.11。

坑2：忘记激活虚拟环境，报skillclaw: command not found

安装脚本装在.venv里，必须先激活：source .venv/bin/activate（Windows 是.\.venv\Scripts\Activate.ps1）。每个新终端都要重新激活一次。

坑3：Windows 上直接跑 bash 安装脚本

scripts/install_skillclaw.sh只适用于 macOS/Linux，Windows 会因换行符与路径语法报错——请改用第三节的 PowerShell 手动安装。

坑4：端口 30000 被占用，启动失败

用skillclaw config proxy.port 30001换一个端口即可，改完记得用新端口做健康检查。

坑5：健康检查端口与配置不一致，误以为没装好

如果你之前修改过proxy.port，直接 curl30000会失败。先用skillclaw config show确认实际端口，再执行健康检查。

坑6：以为必须安装 openclaw 才能用

不需要！只有选择openclawCLI 集成或服务端agent引擎时才需要npm install -g openclaw。默认的workflow引擎和纯客户端用法完全不依赖它。

八、安装小结

整个流程只有 5 个核心命令，核心入口是 skillclaw/cli.py 中的skillclaw命令。装完之后，你只需要像平常一样和 Agent 对话——技能的沉淀、去重与进化都由 SkillClaw 在后台自动完成。祝部署顺利！🚀

【免费下载链接】SkillClawLet Skills Evolve Collectively with Agentic Evolver项目地址: https://gitcode.com/gh_mirrors/sk/SkillClaw