Skip to content

Commit f3beede

Browse files
loong10kloong10k
committed
feat(cli): 对齐 openclaw CLI 参考补齐 26 个缺失命令（同 3.0.x，JDK 8 零适配直通）
1 parent d0938cb commit f3beede

14 files changed

Lines changed: 2420 additions & 0 deletions

‎src/main/java/io/github/easy4j/openclaw/cli/OpenClawCli.java‎

Lines changed: 349 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -607,6 +607,355 @@ public OpenClawCliResult execute(OpenClawCliRequest request) {
607607
return executor.execute(request);
608608
}
609609

610+
// ============================================================
611+
// 文档化缺口补齐（CLI 参考对齐）
612+
// ============================================================
613+
614+
/**
615+
* 通过执行器运行 {@code openclaw attach} 子命令。
616+
*
617+
* @param args 附加参数；可传 {@code CliSubArgs.empty()}
618+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
619+
*/
620+
public OpenClawCliResult attach(CliSubArgs args) {
621+
return run("attach", args);
622+
}
623+
624+
/**
625+
* 通过执行器运行 {@code openclaw audit} 子命令。
626+
*
627+
* @param args 附加参数；可传 {@code CliSubArgs.empty()}
628+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
629+
*/
630+
public OpenClawCliResult audit(CliSubArgs args) {
631+
return run("audit", args);
632+
}
633+
634+
/**
635+
* 通过执行器运行 {@code openclaw browser} 子命令；status/start/navigate 等
636+
* 完整子命令树以「一级子命令 + 自由参数」形态透传。
637+
*
638+
* @param args 浏览器子命令与参数
639+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
640+
*/
641+
public OpenClawCliResult browser(SubcommandOptions args) {
642+
return run("browser", args);
643+
}
644+
645+
/**
646+
* 通过执行器运行 {@code openclaw claws} 子命令。
647+
*
648+
* @param args 附加参数；可传 {@code CliSubArgs.empty()}
649+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
650+
*/
651+
public OpenClawCliResult claws(CliSubArgs args) {
652+
return run("claws", args);
653+
}
654+
655+
/**
656+
* 通过执行器运行 {@code openclaw connect} 子命令。
657+
*
658+
* @param args 附加参数；可传 {@code CliSubArgs.empty()}
659+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
660+
*/
661+
public OpenClawCliResult connect(CliSubArgs args) {
662+
return run("connect", args);
663+
}
664+
665+
/**
666+
* 通过执行器运行 {@code openclaw dns} 子命令（文档化动作为 {@code setup}）。
667+
*
668+
* @param args DNS 选项
669+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
670+
*/
671+
public OpenClawCliResult dns(DnsOptions args) {
672+
return run("dns", args);
673+
}
674+
675+
/**
676+
* 通过执行器运行 {@code openclaw docs} 子命令。
677+
*
678+
* @param args 附加参数；可传 {@code CliSubArgs.empty()}
679+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
680+
*/
681+
public OpenClawCliResult docs(CliSubArgs args) {
682+
return run("docs", args);
683+
}
684+
685+
/**
686+
* 通过执行器运行 {@code openclaw fleet} 子命令（create/backup/restore 等
687+
* 十二个文档化动作）。
688+
*
689+
* @param args fleet 选项
690+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
691+
*/
692+
public OpenClawCliResult fleet(FleetOptions args) {
693+
return run("fleet", args);
694+
}
695+
696+
/**
697+
* 通过执行器运行 {@code openclaw infer} 子命令（alias {@code capability}）；
698+
* model/image/audio/tts/video/web/embedding 子树以自由参数透传。
699+
*
700+
* @param args infer 子命令与参数
701+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
702+
*/
703+
public OpenClawCliResult infer(SubcommandOptions args) {
704+
return run("infer", args);
705+
}
706+
707+
/**
708+
* 通过执行器运行 {@code openclaw memory status}。
709+
*
710+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
711+
*/
712+
public OpenClawCliResult memoryStatus() {
713+
return run("memory", MemoryOptions.builder().verb(MemoryOptions.Verb.STATUS).build());
714+
}
715+
716+
/**
717+
* 通过执行器运行 {@code openclaw memory index}。
718+
*
719+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
720+
*/
721+
public OpenClawCliResult memoryIndex() {
722+
return run("memory", MemoryOptions.builder().verb(MemoryOptions.Verb.INDEX).build());
723+
}
724+
725+
/**
726+
* 通过执行器运行 {@code openclaw memory search <query>}。
727+
*
728+
* @param query 搜索串
729+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
730+
*/
731+
public OpenClawCliResult memorySearch(String query) {
732+
return run("memory", MemoryOptions.builder().verb(MemoryOptions.Verb.SEARCH).operand(query).build());
733+
}
734+
735+
/**
736+
* 通过执行器运行 {@code openclaw path} 子命令（resolve/find/set/validate/emit）。
737+
*
738+
* @param args path 选项
739+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
740+
*/
741+
public OpenClawCliResult path(PathOptions args) {
742+
return run("path", args);
743+
}
744+
745+
/**
746+
* 通过执行器运行 {@code openclaw policy} 子命令（可选插件）。
747+
*
748+
* @param args 附加参数；可传 {@code CliSubArgs.empty()}
749+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
750+
*/
751+
public OpenClawCliResult policy(CliSubArgs args) {
752+
return run("policy", args);
753+
}
754+
755+
/**
756+
* 通过执行器运行 {@code openclaw promos list}。
757+
*
758+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
759+
*/
760+
public OpenClawCliResult promosList() {
761+
return run("promos", PromosOptions.builder().verb(PromosOptions.Verb.LIST).build());
762+
}
763+
764+
/**
765+
* 通过执行器运行 {@code openclaw promos claim <slug>}。
766+
*
767+
* @param slug 促销标识
768+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
769+
*/
770+
public OpenClawCliResult promosClaim(String slug) {
771+
return run("promos", PromosOptions.builder().verb(PromosOptions.Verb.CLAIM).operand(slug).build());
772+
}
773+
774+
/**
775+
* 通过执行器运行 {@code openclaw resume} 子命令。
776+
*
777+
* @param args 附加参数；可传 {@code CliSubArgs.empty()}
778+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
779+
*/
780+
public OpenClawCliResult resume(CliSubArgs args) {
781+
return run("resume", args);
782+
}
783+
784+
/**
785+
* 通过执行器运行 {@code openclaw sandbox} 子命令（list/recreate/explain）。
786+
*
787+
* @param args sandbox 选项
788+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
789+
*/
790+
public OpenClawCliResult sandbox(SandboxOptions args) {
791+
return run("sandbox", args);
792+
}
793+
794+
/**
795+
* 通过执行器运行 {@code openclaw setup} 子命令（交互式引导）。
796+
*
797+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
798+
*/
799+
public OpenClawCliResult setup() {
800+
return run("setup", SetupOptions.builder().build());
801+
}
802+
803+
/**
804+
* 通过执行器运行 {@code openclaw setup --baseline}（跳过引导，直接建基线）。
805+
*
806+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
807+
*/
808+
public OpenClawCliResult setupBaseline() {
809+
return run("setup", SetupOptions.builder().baseline(true).build());
810+
}
811+
812+
/**
813+
* 通过执行器运行 {@code openclaw tasks} 子命令（list/audit/maintenance 等）。
814+
*
815+
* @param args tasks 选项
816+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
817+
*/
818+
public OpenClawCliResult tasks(TasksOptions args) {
819+
return run("tasks", args);
820+
}
821+
822+
/**
823+
* 通过执行器运行 {@code openclaw transcripts list}。
824+
*
825+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
826+
*/
827+
public OpenClawCliResult transcriptsList() {
828+
return run("transcripts", TranscriptsOptions.builder().verb(TranscriptsOptions.Verb.LIST).build());
829+
}
830+
831+
/**
832+
* 通过执行器运行 {@code openclaw transcripts show <id>}。
833+
*
834+
* @param id 转录标识
835+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
836+
*/
837+
public OpenClawCliResult transcriptsShow(String id) {
838+
return run("transcripts", TranscriptsOptions.builder().verb(TranscriptsOptions.Verb.SHOW).operand(id).build());
839+
}
840+
841+
/**
842+
* 通过执行器运行 {@code openclaw transcripts path}。
843+
*
844+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
845+
*/
846+
public OpenClawCliResult transcriptsPath() {
847+
return run("transcripts", TranscriptsOptions.builder().verb(TranscriptsOptions.Verb.PATH).build());
848+
}
849+
850+
/**
851+
* 通过执行器运行 {@code openclaw triage} 子命令。
852+
*
853+
* @param args 附加参数；可传 {@code CliSubArgs.empty()}
854+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
855+
*/
856+
public OpenClawCliResult triage(CliSubArgs args) {
857+
return run("triage", args);
858+
}
859+
860+
/**
861+
* 通过执行器运行 {@code openclaw voicecall} 子命令（可选插件）。
862+
*
863+
* @param args 附加参数；可传 {@code CliSubArgs.empty()}
864+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
865+
*/
866+
public OpenClawCliResult voicecall(CliSubArgs args) {
867+
return run("voicecall", args);
868+
}
869+
870+
/**
871+
* 通过执行器运行 {@code openclaw webhooks gmail setup}。
872+
*
873+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
874+
*/
875+
public OpenClawCliResult webhooksGmailSetup() {
876+
return run("webhooks", WebhooksOptions.builder().verb(WebhooksOptions.Verb.GMAIL_SETUP).build());
877+
}
878+
879+
/**
880+
* 通过执行器运行 {@code openclaw webhooks gmail run}。
881+
*
882+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
883+
*/
884+
public OpenClawCliResult webhooksGmailRun() {
885+
return run("webhooks", WebhooksOptions.builder().verb(WebhooksOptions.Verb.GMAIL_RUN).build());
886+
}
887+
888+
/**
889+
* 通过执行器运行 {@code openclaw wiki} 子命令；status/doctor/init/compile 等
890+
* 子树以「一级子命令 + 自由参数」形态透传。
891+
*
892+
* @param args wiki 子命令与参数
893+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
894+
*/
895+
public OpenClawCliResult wiki(SubcommandOptions args) {
896+
return run("wiki", args);
897+
}
898+
899+
/**
900+
* 通过执行器运行 {@code openclaw workboard list}。
901+
*
902+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
903+
*/
904+
public OpenClawCliResult workboardList() {
905+
return run("workboard", WorkboardOptions.builder().verb(WorkboardOptions.Verb.LIST).build());
906+
}
907+
908+
/**
909+
* 通过执行器运行 {@code openclaw workboard create <args...>}。
910+
*
911+
* @param args 创建参数
912+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
913+
*/
914+
public OpenClawCliResult workboardCreate(CliSubArgs args) {
915+
return run("workboard", WorkboardOptions.builder()
916+
.verb(WorkboardOptions.Verb.CREATE).arguments(args.toSubcommandArguments()).build());
917+
}
918+
919+
/**
920+
* 通过执行器运行 {@code openclaw workboard show <id>}。
921+
*
922+
* @param id 看板标识
923+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
924+
*/
925+
public OpenClawCliResult workboardShow(String id) {
926+
return run("workboard", WorkboardOptions.builder().verb(WorkboardOptions.Verb.SHOW).operand(id).build());
927+
}
928+
929+
/**
930+
* 通过执行器运行 {@code openclaw workboard dispatch <id>}。
931+
*
932+
* @param id 看板标识
933+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
934+
*/
935+
public OpenClawCliResult workboardDispatch(String id) {
936+
return run("workboard", WorkboardOptions.builder().verb(WorkboardOptions.Verb.DISPATCH).operand(id).build());
937+
}
938+
939+
/**
940+
* 通过执行器运行 {@code openclaw worker} 子命令。
941+
*
942+
* @param args 附加参数；可传 {@code CliSubArgs.empty()}
943+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
944+
*/
945+
public OpenClawCliResult worker(CliSubArgs args) {
946+
return run("worker", args);
947+
}
948+
949+
/**
950+
* 通过执行器运行 {@code openclaw file-transfer} 子命令（可选插件）。
951+
*
952+
* @param args 附加参数；可传 {@code CliSubArgs.empty()}
953+
* @return 包含子进程退出码、标准输出和标准错误的执行结果
954+
*/
955+
public OpenClawCliResult fileTransfer(CliSubArgs args) {
956+
return run("file-transfer", args);
957+
}
958+
610959
/**
611960
* 按 {@code openclaw <top-level> <sub-arguments...>} 顺序组装并执行子命令。
612961
*

0 commit comments

Comments
 (0)