SkillClaw

环境要求

• macOS / Linux 可用仓库自带 shell 安装脚本；Windows 需手动创建虚拟环境安装
• 需要 Python 环境（Windows 手动路径使用 python -m venv 与 pip）
• 需要一个上游 OpenAI 兼容 LLM 服务及其 API Key（如 Atlas Cloud）
• 可选：共享存储 local / oss / s3 的访问凭证（多人共用技能库时需要）
• 可选：服务端使用 --engine agent 时需 Node.js，用于 npm install -g openclaw

安装与启动步骤

1. 1克隆并安装客户端

   macOS/Linux 用仓库自带安装脚本建立 .venv 并激活，已克隆源码可跳过 git clone。

   git clone https://github.com/AMAP-ML/SkillClaw.git && cd SkillClaw
   bash scripts/install_skillclaw.sh
   source .venv/bin/activate

   复制

2. 2Windows 手动安装

   仓库暂无原生 .ps1 安装脚本，需手动建虚拟环境并用 pip 安装 evolve、sharing、server 三个扩展。

   git clone https://github.com/AMAP-ML/SkillClaw.git
   Set-Location SkillClaw
   python -m venv .venv
   ..venvScriptsActivate.ps1
   python -m pip install -U pip
   python -m pip install -e ".[evolve,sharing,server]"

   复制

3. 3生成配置文件

   运行向导，依次选择 provider、model、本地技能目录、PRM 设置、可选的 CLI 智能体集成与共享存储。

   skillclaw setup

   复制

4. 4启动客户端代理

   以守护进程方式启动本地代理并查看状态；此时已是可用的单用户本地代理，无需进化服务端。

   skillclaw start --daemon
   skillclaw status

   复制

5. 5健康检查

   读取实际配置的 proxy.port 再请求健康接口，默认端口为 30000，不要写死端口。

   PROXY_PORT="$(skillclaw config proxy.port | awk '{print $2}')"
   curl "http://127.0.0.1:${PROXY_PORT}/healthz"

   复制

6. 6启动本地进化服务

   在已启用 local 共享存储的前提下，单机跑通会话采集到技能复用的闭环，可用 list-remote 查看。

   skillclaw-evolve-server --use-skillclaw-config --interval 300 --port 8787
   skillclaw skills list-remote

   复制

7. 7部署共享服务端

   团队共用时只在能访问共享存储和上游 LLM 的机器上跑一个服务端，客户端仍只装客户端。

   git clone https://github.com/AMAP-ML/SkillClaw.git && cd SkillClaw
   bash scripts/install_skillclaw_server.sh
   source .venv-server/bin/activate
   cp evolve_server/evolve_server.env.example evolve_server/.env
   skillclaw-evolve-server --port 8787 --interval 300 --storage-backend oss --oss-endpoint "$EVOLVE_STORAGE_ENDPOINT" --oss-bucket "$EVOLVE_STORAGE_BUCKET" --group-id my-group

   复制

关键配置

如何确认成功

执行 skillclaw status 显示正常，且 curl http://127.0.0.1:/healthz 返回健康响应。

常见问题

注意事项

• 客户端与服务端只通过共享存储（local、oss、s3）交互，不直接通信
• 服务端 .env 由 evolve_server.env.example 复制而来，需自行填写 OSS/S3 端点、桶等真实凭证
• Atlas Cloud 预设使用 chat-compatible 转发，便于 Codex 客户端走 Responses-to-chat 桥接
• 首次最小化运行建议：CLI 智能体选 none、关闭共享存储、关闭 PRM