如何安装SkillClawmacOS、Linux与Windows跨平台完整教程附6个常见坑【免费下载链接】SkillClawLet Skills Evolve Collectively with Agentic Evolver项目地址: https://gitcode.com/gh_mirrors/sk/SkillClawSkillClaw 是一个让 AI Agent 技能从真实对话中自动进化的开源框架支持 Hermes、OpenClaw、Codex、Claude Code 等主流 Agent。这篇 SkillClaw 安装教程将带你完成 macOS、Linux 与 Windows 三个平台的完整部署从克隆仓库、一键安装、skillclaw setup配置到启动验证并附上 6 个新手最常踩的坑照着做 10 分钟即可跑通。一、安装前准备3个前置要求清单开始之前先确认你的环境满足以下条件前置要求说明️ 操作系统macOS、Linux 或 Windows Python 版本 3.10pyproject.toml 中强制要求 LLM API一个兼容 OpenAI 的 API或 AWS Bedrock 提示只有当你要使用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 会自动完成创建独立的虚拟环境.venv以可编辑模式安装全部依赖pip install -e .[evolve,sharing,server]打印激活命令和下一步操作。脚本还支持--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.pyCLI Agent选none先不改动任何外部 Agent 配置技能目录保持默认~/.skillclaw/skills共享存储先关闭若以后想在同一台机器加 Evolve Server可开启local后端如~/.skillclaw/local-sharePRM关闭先把成本压到最低。五、启动与验证健康检查3步法skillclaw start --daemon skillclaw status验证命令预期结果skillclaw status显示runningcurl http://127.0.0.1:30000/healthz返回{ok: true}skillclaw config show显示正确的上游 URL、模型与端口默认代理端口是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个常见安装坑与解决办法避坑清单坑1Python 版本过低导致安装失败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/activateWindows 是.\.venv\Scripts\Activate.ps1。每个新终端都要重新激活一次。坑3Windows 上直接跑 bash 安装脚本scripts/install_skillclaw.sh只适用于 macOS/LinuxWindows 会因换行符与路径语法报错——请改用第三节的 PowerShell 手动安装。坑4端口 30000 被占用启动失败用skillclaw config proxy.port 30001换一个端口即可改完记得用新端口做健康检查。坑5健康检查端口与配置不一致误以为没装好如果你之前修改过proxy.port直接 curl30000会失败。先用skillclaw config show确认实际端口再执行健康检查。坑6以为必须安装 openclaw 才能用不需要只有选择openclawCLI 集成或服务端agent引擎时才需要npm install -g openclaw。默认的workflow引擎和纯客户端用法完全不依赖它。八、安装小结步骤命令平台克隆仓库git clone https://gitcode.com/gh_mirrors/sk/SkillClaw全平台安装客户端bash scripts/install_skillclaw.shmacOS / Linux配置skillclaw setup全平台启动skillclaw start --daemon全平台验证skillclaw status/healthz检查全平台整个流程只有 5 个核心命令核心入口是 skillclaw/cli.py 中的skillclaw命令。装完之后你只需要像平常一样和 Agent 对话——技能的沉淀、去重与进化都由 SkillClaw 在后台自动完成。祝部署顺利【免费下载链接】SkillClawLet Skills Evolve Collectively with Agentic Evolver项目地址: https://gitcode.com/gh_mirrors/sk/SkillClaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/2 20:52:15 · 阅读 1.2k 如何安装SkillClaw：macOS、Linux与Windows跨平台完整教程（附6个常见坑）
如何安装SkillClawmacOS、Linux与Windows跨平台完整教程附6个常见坑【免费下载链接】SkillClawLet Skills Evolve Collectively with Agentic Evolver项目地址: https://gitcode.com/gh_mirrors/sk/SkillClawSkillClaw 是一个让 AI Agent 技能从真实对话中自动进化的开源框架支持 Hermes、OpenClaw、Codex、Claude Code 等主流 Agent。这篇 SkillClaw 安装教程将带你完成 macOS、Linux 与 Windows 三个平台的完整部署从克隆仓库、一键安装、skillclaw setup配置到启动验证并附上 6 个新手最常踩的坑照着做 10 分钟即可跑通。一、安装前准备3个前置要求清单开始之前先确认你的环境满足以下条件前置要求说明️ 操作系统macOS、Linux 或 Windows Python 版本 3.10pyproject.toml 中强制要求 LLM API一个兼容 OpenAI 的 API或 AWS Bedrock 提示只有当你要使用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 会自动完成创建独立的虚拟环境.venv以可编辑模式安装全部依赖pip install -e .[evolve,sharing,server]打印激活命令和下一步操作。脚本还支持--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.pyCLI Agent选none先不改动任何外部 Agent 配置技能目录保持默认~/.skillclaw/skills共享存储先关闭若以后想在同一台机器加 Evolve Server可开启local后端如~/.skillclaw/local-sharePRM关闭先把成本压到最低。五、启动与验证健康检查3步法skillclaw start --daemon skillclaw status验证命令预期结果skillclaw status显示runningcurl http://127.0.0.1:30000/healthz返回{ok: true}skillclaw config show显示正确的上游 URL、模型与端口默认代理端口是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个常见安装坑与解决办法避坑清单坑1Python 版本过低导致安装失败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/activateWindows 是.\.venv\Scripts\Activate.ps1。每个新终端都要重新激活一次。坑3Windows 上直接跑 bash 安装脚本scripts/install_skillclaw.sh只适用于 macOS/LinuxWindows 会因换行符与路径语法报错——请改用第三节的 PowerShell 手动安装。坑4端口 30000 被占用启动失败用skillclaw config proxy.port 30001换一个端口即可改完记得用新端口做健康检查。坑5健康检查端口与配置不一致误以为没装好如果你之前修改过proxy.port直接 curl30000会失败。先用skillclaw config show确认实际端口再执行健康检查。坑6以为必须安装 openclaw 才能用不需要只有选择openclawCLI 集成或服务端agent引擎时才需要npm install -g openclaw。默认的workflow引擎和纯客户端用法完全不依赖它。八、安装小结步骤命令平台克隆仓库git clone https://gitcode.com/gh_mirrors/sk/SkillClaw全平台安装客户端bash scripts/install_skillclaw.shmacOS / Linux配置skillclaw setup全平台启动skillclaw start --daemon全平台验证skillclaw status/healthz检查全平台整个流程只有 5 个核心命令核心入口是 skillclaw/cli.py 中的skillclaw命令。装完之后你只需要像平常一样和 Agent 对话——技能的沉淀、去重与进化都由 SkillClaw 在后台自动完成。祝部署顺利【免费下载链接】SkillClawLet Skills Evolve Collectively with Agentic Evolver项目地址: https://gitcode.com/gh_mirrors/sk/SkillClaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考