Skip to content

Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.

5.1 KB
Raw Blame
"""
OpenClaw CLI 客户端封装 - 使用 openclaw agent 命令
"""

import glob
import json
import logging
import os
import subprocess
import time
from typing import Any, Dict, Optional

try:
    from .cli_diagnostics import format_openclaw_cli_failure
except ImportError:  # pragma: no cover - direct test utility import
    from cli_diagnostics import format_openclaw_cli_failure

logger = logging.getLogger(__name__)

OPENCLAW_HOME = os.path.expanduser("~/.openclaw")
SESSION_LOCK_TIMEOUT = 15
SESSION_LOCK_POLL_INTERVAL = 0.5


def _find_session_lock(session_id: str) -> Optional[str]:
    for pattern in [
        os.path.join(OPENCLAW_HOME, "agents", "*", "sessions", f"{session_id}.jsonl.lock"),
        os.path.join(OPENCLAW_HOME, "agents", "main", "sessions", f"{session_id}.jsonl.lock"),
    ]:
        matches = glob.glob(pattern)
        if matches:
            return matches[0]
    return None


def _wait_for_session_lock_release(session_id: str, timeout: float = SESSION_LOCK_TIMEOUT) -> bool:
    lock_path = _find_session_lock(session_id)
    if lock_path is None:
        return True
    start = time.time()
    while time.time() - start < timeout:
        if not os.path.exists(lock_path):
            logger.info(f"Session lock released: {lock_path}")
            return True
        time.sleep(SESSION_LOCK_POLL_INTERVAL)
    logger.warning(f"Session lock still held after {timeout}s: {lock_path}")
    return False


class OpenClawCLIClient:
    """
    OpenClaw CLI 客户端
    """

    def __init__(self, session_id: Optional[str] = None):
        """
        初始化客户端
        """
        self.session_id = session_id or "test_session_default"
        self.timeout = 180

    def send_message(
        self,
        message: str,
        session_id: Optional[str] = None,
        agent_id: Optional[str] = None,
        timeout: Optional[int] = None,
    ) -> Dict[str, Any]:
        """
        使用 openclaw agent 命令发送消息
        """
        target_session_id = session_id or self.session_id
        cmd_timeout = timeout or self.timeout

        cmd = [
            "openclaw",
            "agent",
            "--session-id",
            target_session_id,
            "--message",
            message,
            "--json",
        ]

        if agent_id:
            cmd.insert(2, "--agent")
            cmd.insert(3, agent_id)

        try:
            logger.info("=" * 80)
            logger.info("📤 使用 CLI 发送请求到 OpenClaw")
            logger.info("=" * 80)
            logger.info(f"Session ID: {target_session_id}")
            logger.info(f"Agent ID: {agent_id or 'default'}")
            logger.info(f"输入消息: {message}")
            logger.info(f"完整命令: {' '.join(cmd)}")

            lock_released = _wait_for_session_lock_release(target_session_id)
            if not lock_released:
                logger.warning("Session lock not released, request may fail with lock timeout")

            logger.info(f"⏳ 等待响应 (超时: {cmd_timeout}秒)...")

            result = subprocess.run(cmd, capture_output=True, text=True, timeout=cmd_timeout)

            logger.info(f"✅ 命令执行完成 - 返回码: {result.returncode}")

            _wait_for_session_lock_release(target_session_id)

            if result.returncode != 0:
                error_msg = format_openclaw_cli_failure(
                    "命令执行失败", result.stderr, result.returncode
                )
                logger.error("=" * 80)
                logger.error(error_msg)
                logger.error("=" * 80)
                return {"error": error_msg, "success": False}

            if not result.stdout.strip():
                error_msg = format_openclaw_cli_failure(
                    "命令返回空输出", result.stderr, result.returncode
                )
                logger.error("=" * 80)
                logger.error(error_msg)
                logger.error("=" * 80)
                return {"error": error_msg, "success": False}

            try:
                response_data = json.loads(result.stdout)
            except json.JSONDecodeError:
                response_text = result.stdout.strip()
                response_data = {"output": response_text, "success": True}

            logger.info("=" * 80)
            logger.info("📥 OpenClaw 响应内容:")
            logger.info("=" * 80)

            if isinstance(response_data, dict):
                logger.info(json.dumps(response_data, ensure_ascii=False, indent=2))
            else:
                logger.info(str(response_data))

            logger.info("=" * 80)

            return response_data

        except subprocess.TimeoutExpired:
            error_msg = f"命令执行超时 (超时: {cmd_timeout}秒)"
            logger.error("=" * 80)
            logger.error(error_msg)
            logger.error("=" * 80)
            return {"error": error_msg, "success": False}
        except Exception as e:
            error_msg = f"执行命令异常: {str(e)}"
            logger.error("=" * 80)
            logger.error(error_msg)
            logger.error("=" * 80)
            return {"error": error_msg, "success": False}