OpenClaw Agent Log Skill

Overview

本 Skill 是 agentlog-auto 和 openclaw-agent 的合并版本，为 OpenClaw Agent 提供统一的存证和 Trace 管理能力。

Architecture

OpenClaw Agent
      ↓
┌─────────────────────────────────┐
│   openclaw-agentlog Skill      │
├─────────────────────────────────┤
│  ┌───────────────────────────┐  │
│  │   Auto-Logging Module    │  │ ← Hooks 自动记录
│  │  - session_start         │  │
│  │  - before_tool_call      │  │
│  │  - after_tool_call       │  │
│  │  - agent_end             │  │
│  └───────────────────────────┘  │
│  ┌───────────────────────────┐  │
│  │   Trace Handoff Module   │  │ ← 任务交接
│  │  - checkAndClaimTrace    │  │
│  │  - claimTrace            │  │
│  │  - completeTrace         │  │
│  └───────────────────────────┘  │
└─────────────────────────────────┘
      ↓
AgentLog Backend (MCP Server)
      ↓
   SQLite DB

Configuration

Environment Variables

AGENTLOG_BACKEND_URL=http://localhost:7892  # Backend API URL
AGENTLOG_MCP_URL=http://localhost:7892      # MCP Server URL
AGENTLOG_AGENT_ID=<agent-name>             # Agent 标识（自动设置）

Optional Configuration

agentlog:
  mcpUrl: "http://localhost:7892"
  autoBindCommit: true      # 自动绑定 Git Commit
  reasoningCapture: true    # 捕获推理过程
  toolCallCapture: true     # 捕获工具调用
  sessionTimeout: 600       # Session 超时(秒)

Hook Events (Auto-Logging)

Trace Handoff API

checkAndClaimTrace

启动时检查并认领 pending traces。

import { checkAndClaimTrace } from 'openclaw-agentlog';

const result = await checkAndClaimTrace('/path/to/workspace', 'architect');
// result: { success: true, traceId: '...', sessionId: '...' }

claimTrace

手动认领指定 trace。

import { claimTrace } from 'openclaw-agentlog';

const result = await claimTrace('TRACE_ID', 'architect', '/path/to/workspace');

completeActiveSession

完成当前 session。

import { completeActiveSession } from 'openclaw-agentlog';

await completeActiveSession('/path/to/workspace');

Skill Functions

Data Flow

1. Agent 启动
   ↓
2. checkAndClaimTrace() → 查找匹配的 pending trace
   ↓
3. 认领后 → 设置 AGENTLOG_TRACE_ID 环境变量
   ↓
4. Hooks 开始自动记录：
   - session_start → 创建 session
   - before_tool_call → 记录参数
   - after_tool_call → 记录结果
   ↓
5. Agent 完成任务 → agent_end → log_intent()
   ↓
6. completeActiveSession() → 清理

Requirements

• OpenClaw Gateway 运行中
• AgentLog Backend 运行中 (port 7892)
• Git 仓库（用于 commit binding）

Deprecation

本 Skill 替代以下已废弃的 Skills：

• agentlog-auto（与 OpenCode 插件重名）
• openclaw-agent（功能已合并）

Troubleshooting

Backend not reachable:

curl http://localhost:7892/health

Session not binding to commits:

• 确保 git 仓库存在
• 确保在 session 结束后 5 分钟内有 commit

Trace not found:

• 检查 sessions.json 是否存在
• 确认 trace 处于 pending 状态