Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
Python agent-contextagent-memoryagent-pluginsagentic-ragcontext-databasedsh-pluginknowledge-basememorymemory-managementself-evolvingvector-database
"""
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}