차이점

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

• before 및 after 텍스트
• 통합 patch

• 캔버스 표시용 Gateway 뷰어 URL
• 메시지 전달용 렌더링된 파일 경로(PNG 또는 PDF)
• 한 번의 호출로 두 출력 모두

​

빠른 시작

openclaw plugins install diffs

{
  plugins: {
    entries: {
      diffs: {
        enabled: true,
      },
    },
  },
}

​

내장 시스템 지침 비활성화

{
  plugins: {
    entries: {
      diffs: {
        enabled: true,
        hooks: {
          allowPromptInjection: false,
        },
      },
    },
  },
}

​

일반적인 에이전트 워크플로

​

입력 예시

{
  "before": "# Hello\n\nOne",
  "after": "# Hello\n\nTwo",
  "path": "docs/example.md",
  "mode": "view"
}

{
  "patch": "diff --git a/src/example.ts b/src/example.ts\n--- a/src/example.ts\n+++ b/src/example.ts\n@@ -1 +1 @@\n-const x = 1;\n+const x = 2;\n",
  "mode": "both"
}

​

도구 입력 참조

​

출력 details 계약

​

접힌 변경되지 않은 섹션

• 뷰어는 N unmodified lines와 같은 행을 표시할 수 있습니다.
• 해당 행의 확장 컨트롤은 조건부이며 모든 입력 종류에서 보장되지는 않습니다.
• 확장 컨트롤은 렌더링된 diff에 확장 가능한 컨텍스트 데이터가 있을 때 나타나며, 이는 이전 및 이후 입력에서 일반적입니다.
• 많은 통합 패치 입력의 경우 생략된 컨텍스트 본문을 파싱된 패치 hunk에서 사용할 수 없으므로, 확장 컨트롤 없이 행이 나타날 수 있습니다. 이는 예상된 동작입니다.
• expandUnchanged는 확장 가능한 컨텍스트가 있을 때만 적용됩니다.

​

Plugin 기본값

{
  plugins: {
    entries: {
      diffs: {
        enabled: true,
        config: {
          defaults: {
            fontFamily: "Fira Code",
            fontSize: 15,
            lineSpacing: 1.6,
            layout: "unified",
            showLineNumbers: true,
            diffIndicators: "bars",
            wordWrap: true,
            background: true,
            theme: "dark",
            fileFormat: "png",
            fileQuality: "standard",
            fileScale: 2,
            fileMaxWidth: 960,
            mode: "both",
            ttlSeconds: 21600,
          },
        },
      },
    },
  },
}

• fontFamily
• fontSize
• lineSpacing
• layout
• showLineNumbers
• diffIndicators
• wordWrap
• background
• theme
• fileFormat
• fileQuality
• fileScale
• fileMaxWidth
• mode
• ttlSeconds

​

영구 뷰어 URL 설정

{
  plugins: {
    entries: {
      diffs: {
        enabled: true,
        config: {
          viewerBaseUrl: "https://gateway.example.com/openclaw",
        },
      },
    },
  },
}

​

보안 설정

{
  plugins: {
    entries: {
      diffs: {
        enabled: true,
        config: {
          security: {
            allowRemoteViewer: false,
          },
        },
      },
    },
  },
}

​

아티팩트 수명 주기 및 저장소

• 아티팩트는 임시 하위 폴더 $TMPDIR/openclaw-diffs 아래에 저장됩니다.
• 뷰어 아티팩트 메타데이터에는 다음이 포함됩니다.
  • 임의 아티팩트 ID(20개의 16진수 문자)
  • 임의 토큰(48개의 16진수 문자)
  • createdAt 및 expiresAt
  • 저장된 viewer.html 경로
• 지정하지 않으면 기본 아티팩트 TTL은 30분입니다.
• 허용되는 최대 뷰어 TTL은 6시간입니다.
• 정리는 아티팩트 생성 후 기회적으로 실행됩니다.
• 만료된 아티팩트는 삭제됩니다.
• 메타데이터가 없는 경우 fallback 정리는 24시간보다 오래된 오래된 폴더를 제거합니다.

​

뷰어 URL 및 네트워크 동작

• /plugins/diffs/view/{artifactId}/{token}

• /plugins/diffs/assets/viewer.js
• /plugins/diffs/assets/viewer-runtime.js

• 도구 호출 baseUrl이 제공되면 엄격한 검증 후 사용됩니다.
• 그렇지 않고 Plugin viewerBaseUrl이 구성되어 있으면 이를 사용합니다.
• 둘 중 어느 재정의도 없으면 뷰어 URL은 local loopback 127.0.0.1을 기본값으로 사용합니다.
• Gateway 바인드 모드가 custom이고 gateway.customBindHost가 설정되어 있으면 해당 호스트가 사용됩니다.

• http:// 또는 https://여야 합니다.
• Query와 hash는 거부됩니다.
• Origin과 선택적 기본 경로가 허용됩니다.

​

보안 모델

​

파일 모드의 브라우저 요구 사항

• Diff PNG/PDF rendering requires a Chromium-compatible browser...

​

문제 해결

​

운영 지침

• 캔버스에서 로컬 대화형 검토에는 mode: "view"를 선호하세요.
• 첨부 파일이 필요한 아웃바운드 채팅 채널에는 mode: "file"을 선호하세요.
• 배포에 원격 뷰어 URL이 필요하지 않으면 allowRemoteViewer를 비활성화 상태로 유지하세요.
• 민감한 diff에는 명시적으로 짧은 ttlSeconds를 설정하세요.
• 필요하지 않은 경우 diff 입력에 비밀 정보를 보내지 마세요.
• 채널이 이미지를 강하게 압축하는 경우(예: Telegram 또는 WhatsApp) PDF 출력(fileFormat: "pdf")을 선호하세요.

​

관련 항목

• 브라우저
• Plugin
• 도구 개요