Repository navigation
v2.2.0 — Agent-First Edge Installer
🎯 v2.2.0 — Agent-First Edge Installer
安装 ClawShell 只需对 AI Agent 说一句话。这是 ClawShell 安装方式的根本性变革。
🤖 Agent-First 安装器 (edge/installer/)
核心改造:安装器的主要使用者从人类转为 AI Agent,人类降级为"凭证提供者"。
Agent 安装流程
用户对 Agent 说:"安装 ClawShell"
↓
Agent 自动: 检测环境 → 克隆 → 安装依赖
↓
Agent 暂停问用户: "请提供 模型名称 + API Key"
↓
Agent 自动: 配置注入 → 自检 → 报告能力
新增模块
| 模块 | 文件 | 功能 |
|---|---|---|
| SystemDetector | detector.py |
10 AI Agents + 8 Coding IDEs 自动发现 |
| ConfigAutoInjector | configurator.py |
MCP 配置自动注入 (Hermes/Wukong/OpenClaw) |
| InstallationChecklist | checklist.py |
最小交互式凭证收集 (仅 2 项) |
| SelfCheckReporter | reporter.py |
安装后 Markdown 自检报告 |
| ClawShellEdgeInstaller | installer.py |
核心安装编排引擎 |
| CLI | cli.py |
5 种模式: install/check/detect/config/agent-mode |
| Agent Guide | AGENT_MODE.md |
Agent 可读可执行的 6-Phase 安装指引 |
一键安装脚本
scripts/install.sh— Linux/macOS/WSL 通用脚本 (Agent JSON 静默模式 + 人类降级)scripts/install.ps1— Windows PowerShell 安装器
Agent 模式特性
- 🤖 Agent 优先 — 对 AI Agent 说"请帮我完成安装与配置:https://github.com/jorinyang/clawshell"
- 📋 唯一人类交互 — Phase 1 一次性索要模型名 + API Key (端点自动匹配)
- 📊 静默 JSON 输出 —
bash install.sh --agent输出机器可解析 JSON - 🔄 语义化退出码 — 10=Python缺失, 11=Git缺失, 20=Clone失败, 21=凭据缺失
🚀 安装器 CLI
# 环境检测 (10 agents + 8 IDEs)
python3 -m edge.installer detect
# 配置注入
python3 -m edge.installer config
# 自检报告
python3 -m edge.installer check
# Agent 模式指引
python3 -m edge.installer agent-mode
# 一键安装
python3 -m edge.installer install📊 测试
test_capability_coverage.py 80/80 PASS
test_comprehensive_v2.py 62/62 PASS
原有全部测试 444/444 PASS
───────────────────────────────────
总计 586/586 PASS
🔗 相关更新
- 官网
clawshell.club更新: Agent 安装 + CLI 安装双卡片布局 - README.md 重写为 Agent-First
- 引擎数量: 19 (新增 CloudCronSupervisor + DispatchRouter)