你问 → AI 回答 → 你再问 → AI 再回答

传统 AI：  输入问题 → 输出答案
AI Agent： 输入目标 → 规划步骤 → 调用工具 → 完成任务

2023 年 —— AutoGPT 引爆 Agent 概念
  ↓
2024 年 —— Claude Code、GPT-4 带工具使用；Agent 框架百花齐放
  ↓
2025 年 —— MCP 协议标准化；OpenAI Operator、Claude Computer Use 发布
  ↓
2026 年 —— OpenClaw 成为现象级开源项目（GitHub 300K+ Stars）
           → Agent 从"实验品"变成了"基础设施"

1. 收到用户消息
2. 理解任务（Reasoning）
3. 决定要做什么（Planning）
4. 调用工具执行（Acting）
5. 观察执行结果（Observing）
6. 决定下一步（Reasoning again）
7. ... 循环直到任务完成

OpenClaw = LLM（大脑）× Channels（渠道）× Tools（工具）× Skills（技能）
         = 一个完整的 AI Agent 运行时

# 克隆仓库
git clone https://github.com/cw1997/gemini-operator.git
cd gemini-operator
 
# 安装依赖
pip install -r requirements.txt
 
# 设置 Gemini API Key
export GEMINI_API_KEY="your-api-key-here"
 
# 运行
python gemini_operator.py

import getpass
import json
import os
import platform
import subprocess
import sys
 
import google.generativeai as genai
from google.api_core import exceptions as google_api_exceptions

用户输入自然语言
      ↓
detect_os() → 检测操作系统
      ↓
build_model() → 构建带 OS 特定 System Prompt 的 Gemini 模型
      ↓
ask_gemini() → 调用 Gemini API，解析 JSON 响应
      ↓
prompt_user_action() → 展示命令，让用户 y/n/e 确认
      ↓
run_command() → 在对应 Shell 中执行命令
      ↓
显示执行结果

def detect_os() -> str:
    system = platform.system().lower()
    if system == "windows":
        return "windows"
    if system == "darwin":
        return "macos"
    return "linux"

OS_SHELL_NAME = {
    "windows": "Windows Command Prompt (cmd.exe)",
    "macos": "macOS bash/zsh shell",
    "linux": "Linux bash shell",
}

SYSTEM_PROMPT_TEMPLATE = """\
You are a command-line expert.  The user is running {os_display}.
 
When the user describes a task in natural language, you must respond with a
JSON object (no markdown fences, no extra commentary) with exactly two keys:
 
  "command"     – the single shell command (or short pipeline) to accomplish
                  the task on {os_display}, suitable for copy-paste execution.
  "explanation" – a concise, plain-English explanation of what the command
                  does, including any side-effects the user should be aware of.
 
Rules:
- Use only commands that are available by default on {os_display}.
- For Windows use cmd.exe syntax; for macOS/Linux use bash/sh syntax.
- Never produce multiple alternative commands – pick the best single command.
- If the task cannot be safely expressed as a single command, chain with &&
  (Linux/macOS) or & (Windows).
- Output ONLY the raw JSON object, nothing else.
"""

def build_model(
    api_key: str, current_os: str, model_name: str
) -> genai.GenerativeModel:
    genai.configure(api_key=api_key)
    system_prompt = SYSTEM_PROMPT_TEMPLATE.format(
        os_display=OS_SHELL_NAME[current_os]
    )
    return genai.GenerativeModel(
        model_name=model_name,
        system_instruction=system_prompt,
    )

def ask_gemini(model: genai.GenerativeModel, prompt: str) -> tuple[str, str]:
    response = model.generate_content(prompt)
    raw = response.text.strip()
 
    # 如果模型加了 markdown 代码块标记，剥除掉
    if raw.startswith("```"):
        lines = raw.splitlines()
        raw = "\n".join(
            line for line in lines if not line.startswith("```")
        ).strip()
 
    try:
        data = json.loads(raw)
    except json.JSONDecodeError as exc:
        raise ValueError(
            f"Gemini returned non-JSON output:\n{raw}"
        ) from exc
 
    command = data.get("command", "").strip()
    explanation = data.get("explanation", "").strip()
 
    if not command:
        raise ValueError("Gemini returned an empty command.")
 
    return command, explanation

def prompt_user_action(command: str) -> str:
    print()
    print(_colour("┌─ Command to execute " + "─" * 45, CYAN))
    print(_colour("│  ", CYAN) + _colour(command, YELLOW, BOLD))
    print(_colour("└" + "─" * 66, CYAN))
    print(_colour("⚠  Review the command carefully before executing it.", YELLOW))
    print()
    print(
        _colour("[y]", GREEN) + " Execute   "
        + _colour("[n]", RED) + " Cancel   "
        + _colour("[e]", YELLOW) + " Edit command"
    )
 
    while True:
        choice = input(_colour("Your choice [y/n/e]: ", BOLD)).strip().lower()
 
        if choice in ("y", "yes", ""):
            return command
        if choice in ("n", "no"):
            return ""
        if choice in ("e", "edit"):
            print(_colour(f"Current command: {command}", CYAN))
            edited = input(...).strip()
            if not edited:
                return command
            return edited
        print(_colour("Please enter y, n, or e.", RED))

def run_command(command: str, current_os: str) -> int:
    if current_os == "windows":
        result = subprocess.run(["cmd.exe", "/C", command])
    else:
        result = subprocess.run(["/bin/bash", "-c", command])
    return result.returncode

def resolve_api_key() -> str:
    key = os.environ.get("GEMINI_API_KEY", "").strip()
    if key:
        return key
 
    print(_colour("GEMINI_API_KEY is not set. Paste your Gemini API key ...", YELLOW, BOLD))
    while True:
        key = getpass.getpass("API key: ").strip()
        if key:
            return key
        print(_colour("Key cannot be empty.", RED))

def fetch_models_via_sdk(api_key: str) -> list[str]:
    genai.configure(api_key=api_key)
    found: list[str] = []
    for m in genai.list_models():
        methods = getattr(m, "supported_generation_methods", None) or []
        if "generateContent" not in methods:
            continue
        found.append(_model_id_from_list_name(m.name))
    return sorted(set(found))

RESET = "\033[0m"
BOLD = "\033[1m"
GREEN = "\033[32m"
YELLOW = "\033[33m"
CYAN = "\033[36m"
RED = "\033[31m"
MAGENTA = "\033[35m"
 
def _colour(text: str, *codes: str) -> str:
    if sys.stdout.isatty():
        return "".join(codes) + text + RESET
    return text

程序启动
    │
    ├─ 1. resolve_api_key()
    │   ├─ 检查环境变量 GEMINI_API_KEY
    │   └─ 如果没有，交互式输入
    │
    ├─ 2. detect_os()
    │   └─ 返回 "windows" / "macos" / "linux"
    │
    ├─ 3. resolve_model_name()
    │   ├─ 检查环境变量 GEMINI_MODEL
    │   ├─ 如果没有，调用 fetch_models_via_sdk() 枚举可用模型
    │   └─ 交互式选择模型
    │
    ├─ 4. build_model()
    │   └─ 创建带 OS 特定 System Prompt 的 Gemini 模型
    │
    ├─ 5. print_banner() → 显示启动信息
    │
    └─ 进入主循环（REPL）
            │
            ├─ 等待用户输入
            │
            ├─ 检查 exit/quit 命令
            │
            ├─ 6. ask_gemini()
            │   ├─ 调用 Gemini API
            │   ├─ 解析 JSON 响应
            │   └─ 返回 (command, explanation)
            │
            ├─ 显示 explanation（命令说明）
            │
            ├─ 7. prompt_user_action()
            │   ├─ [y] → 执行
            │   ├─ [n] → 取消
            │   └─ [e] → 编辑
            │
            ├─ 8. run_command()
            │   ├─ Windows: cmd.exe /C
            │   └─ Linux/macOS: /bin/bash -c
            │
            └─ 显示执行结果（成功/失败/退出码）
                    │
                    └─ 回到循环开始，等待下一条指令

╔══════════════════════════════════════════════════════════════════╗
║              gemini-operator  –  AI Shell Assistant             ║
╚══════════════════════════════════════════════════════════════════╝
 
Detected OS: Linux (bash)
Model: gemini-flash-lite-latest
 
gemini-operator> 查看当前目录下有哪些文件
 
ℹ  Explanation:
   Lists all files and directories in the current directory with details.
 
┌─ Command to execute ─────────────────────────────────────────────
│  ls -la
└──────────────────────────────────────────────────────────────────
⚠  Review the command carefully before executing it.
 
[y] Execute   [n] Cancel   [e] Edit command
Your choice [y/n/e]: y
 
▶ Running: ls -la
────────────────────────────────────────────────────────────────────
total 420
drwxr-xr-x  1 user user   0 Jun 13 03:46 .
drwxr-xr-x  1 user user   0 Jun 13 03:46 ..
-rw-r--r--  1 user user  91 Jun 13 03:46 gemini_operator.py
-rw-r--r--  1 user user  20 Jun 13 03:46 requirements.txt
✔ Command completed successfully.
 
gemini-operator> 查看内存使用情况
 
ℹ  Explanation:
   Displays memory usage statistics in human-readable format.
 
┌─ Command to execute ─────────────────────────────────────────────
│  free -h
└──────────────────────────────────────────────────────────────────
 
[y] Execute   [n] Cancel   [e] Edit command
Your choice [y/n/e]: y
 
▶ Running: free -h
────────────────────────────────────────────────────────────────────
              total        used        free      shared  buff/cache   available
Mem:           31Gi        12Gi        14Gi       1.2Gi       4.5Gi        17Gi
Swap:         8.0Gi       1.2Gi       6.8Gi
✔ Command completed successfully.
 
gemini-operator> 退出
Goodbye!