docs: add comprehensive OpenClaw Javadocs

Author: loong10k

src/main/java/io/github/easy4j/openclaw/HttpCallCancellation.java

@@ -1,16 +1,19 @@
 package io.github.easy4j.openclaw;
 
 /**
- * 将调用方取消信号绑定到底层 HTTP Call。
+ * HTTP 取消信号接口。实现方注册 Call.cancel 回调，并返回请求结束时用于注销该回调的句柄。
+ *
+ * @author <a href="https://github.com/loong10k">Loong Wan</a>
+ * @since 1.0.0
  */
 @FunctionalInterface
 public interface HttpCallCancellation {
 
     /**
-     * 注册取消动作。
+     * 接收并处理 Cancel 生命周期事件；实现不会改变事件顺序。
      *
-     * @param callback 取消时执行的动作
-     * @return 请求结束后用于注销动作的句柄
+     * @param callback 取消或事件回调
+     * @return 请求终止后用于注销取消回调的句柄
      */
     AutoCloseable onCancel(Runnable callback);
 }

src/main/java/io/github/easy4j/openclaw/HttpResponseMode.java

@@ -1,16 +1,25 @@
 package io.github.easy4j.openclaw;
 
 /**
- * HTTP 对话响应模式。
+ * HTTP 响应消费模式，区分一次性读取完整响应、持续消费流以及由客户端按端点自动选择。
+ *
+ * @author <a href="https://github.com/loong10k">Loong Wan</a>
+ * @since 1.0.0
  */
 public enum HttpResponseMode {
 
-    /** 等待完整响应后一次性返回。 */
+    /**
+     * 选择 `blocking` 协议模式；序列化时使用该固定取值。
+     */
     BLOCKING,
 
-    /** 消费 Provider SSE 并逐段回调。 */
+    /**
+     * 选择 `stream` 协议模式；序列化时使用该固定取值。
+     */
     STREAM,
 
-    /** 由调用方根据结构化输出、工具调用等请求特征选择。 */
+    /**
+     * 选择 `auto` 协议模式；序列化时使用该固定取值。
+     */
     AUTO
 }

src/main/java/io/github/easy4j/openclaw/OpenClawCliConfig.java

@@ -3,56 +3,51 @@
 import lombok.Data;
 
 /**
- * OpenClaw local CLI client configuration.
- * <p>
- * Covers {@code openclaw} executable,timeout,concurrency,working directory CLI .
- * </p>
+ * 本地 CLI 通道配置，定义可执行文件、工作目录、启动探测、命令超时和最大并发子进程数。
  *
- * @author [@Loong Wan](https://github.com/loong10k)
+ * @author <a href="https://github.com/loong10k">Loong Wan</a>
  * @since 1.0.0
  */
 @Data
 public class OpenClawCliConfig {
 
     /**
- * Whether to enable CLI system.
- * <p>When false,skips CLI .</p>
+     * 是否创建并开放对应通信通道；关闭后门面不会初始化该子系统。
      */
     private boolean enabled = true;
 
     /**
- * At startupWhether to probe {@code openclaw --version}.
+     * 是否在客户端构造阶段执行可用性探测；默认关闭以避免启动阻塞。
      */
     private boolean startupCheckEnabled = false;
 
     /**
- * CLI Whether to fail fast(interrupts construction).
- * <p>Defaults to false only logs a warning;productionwhen true.</p>
+     * 启动探测失败时是否中断客户端构造；关闭时仅记录警告。
      */
     private boolean failFastOnUnavailable = false;
 
     /**
- * executable name
+     * 本地 openclaw 可执行文件名或绝对路径。
      */
     private String executable = "openclaw";
 
     /**
- * agent timeout(seconds)
+     * 单次 CLI 命令默认超时，单位为秒。
      */
     private int timeout = 300;
 
     /**
- * CLI subprocessworking directory;When empty, JVM directory.
+     * CLI 子进程工作目录；为空时继承当前 JVM 工作目录。
      */
     private String workingDirectory;
 
     /**
- * CLI subprocessmaximum concurrency; 0 CPU 2 value.
+     * 允许同时运行的 CLI 子进程数；非正数使用按 CPU 核心数计算的默认值。
      */
     private int maxConcurrentExecutions = 0;
 
     /**
- * timeout(seconds)
+     * 执行 openclaw --version 启动探测的超时，单位为秒。
      */
     private int probeTimeoutSeconds = 5;