Official Verified

kimi_cli_headless_execution

教 OpenClaw 在自动化脚本、后台任务、CI/CD、无 TTY 环境等非交互场景中，正确使用 Kimi Code CLI 的 `-p/--prompt`、`--print`、`--quiet`、`--wire` 等参数完成无头执行。涵盖命令构造、自动审批控制、输出格式选择、会话管理、错误处理与安全护栏。

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/aiyouwolegequ/kimi-cli-headless-execution

Download Source Code (.zip)

Skill: Kimi CLI 无头执行操作手册

Overview

Kimi Code CLI 默认以交互式 Shell/TUI 模式启动，但在自动化场景中需要无头执行（不进入交互界面，传入提示词后直接输出结果并退出）。本 Skill 指导 Agent 在需要调用 kimi 命令完成后台任务时，如何构造正确的无头执行命令，确保输出可控、错误可处理、操作安全。

Core Mission

执行本 Skill 时，最终必须做到：

构造出可在当前环境直接执行的 kimi 无头命令
根据场景选择最合适的输出模式（--quiet 快速文本 / --print 完整过程 / --wire 服务化）
明确是否启用自动审批（--yolo）并告知用户风险
处理命令执行结果或错误，给出下一步建议

Trigger Conditions

在以下情况下必须触发本 Skill：

用户要求 Agent 使用 Kimi CLI 自动完成某个任务（如“让 Kimi CLI 无头重构这段代码”、“用 Kimi CLI 分析当前目录的 bug”）
任务需要运行在 无 TTY 环境、后台脚本 或 CI/CD 流水线 中
用户询问 Kimi CLI 是否支持无头模式 / 非交互执行 / 自动化调用
Agent 自身需要通过 kimi 命令行工具调用 Kimi 模型能力，而不是通过 API 直接请求

Non-Trigger Cases

以下情况不应套用本 Skill 的完整执行流程：

用户只是问 Kimi CLI 的安装、登录、配置方法（直接文字回答即可）
用户想手动和 Kimi CLI 进行交互式聊天（建议用户直接运行 kimi）
当前环境未安装 kimi 命令，且用户未要求安装（应先提示安装或换用 API）
用户要求比较 Kimi CLI 与其他 CLI 工具的优缺点（纯问答场景）

Pre-Flight Check

在构造命令前，必须先确认：

命令是否存在：运行 which kimi 或 kimi --version，确认 Kimi CLI 已安装
是否需要登录：若用户未配置 API Key 且未通过 kimi login 登录，需提示用户先完成认证
工作目录是否正确：若任务涉及特定项目路径，必须显式使用 --work-dir PATH
是否需要文件修改权限：若 Kimi CLI 需要自动修改文件/执行 Shell，必须加 --yolo（并告知风险）

Command Reference

基础无头执行（最常用）

参数	简写	说明
`--prompt TEXT`	`-p`	传入用户提示，不进入交互模式
`--command TEXT`	`-c`	`--prompt` 的别名
`--print`		以 Print 模式运行（非交互式），隐式启用 `--yolo`
`--quiet`		等价于 `--print --output-format text --final-message-only`
`--yolo`	`-y`	自动批准所有文件修改和 Shell 命令执行
`--work-dir PATH`	`-w`	指定工作目录
`--model NAME`	`-m`	指定模型，覆盖配置文件
`--continue`	`-C`	继续当前工作目录的上一个会话
`--session ID` / `--resume ID`	`-S` / `-r`	恢复指定会话
`--output-format FORMAT`		仅在 `--print` 下有效：`text`（默认）或 `stream-json`
`--final-message-only`		仅在 `--print` 下有效：只输出最终 assistant 消息
`--wire`		以 Wire 服务器模式运行（实验性），适合程序集成

关键模式选择策略

快速单次问答（推荐默认）：kimi -p "任务描述" --quiet
- 优点：输出最干净，直接返回最终结论，适合脚本捕获
- 缺点：不展示中间思考/工具调用过程
需要观察完整过程：kimi -p "任务描述" --print
- 优点：能看到 Kimi CLI 使用的工具、执行的命令、读取的文件
- 缺点：输出较长，包含中间步骤，需 Agent 自行过滤关键信息
需要结构化/流式输出：kimi -p "任务描述" --print --output-format stream-json
- 优点：每行一个 JSON 对象，便于程序解析
- 缺点：需要额外的 JSON 解析逻辑
长任务/多轮迭代：kimi -p "任务描述" --print --max-ralph-iterations N
- 开启 Ralph 循环模式，让 Agent 反复迭代直到完成任务或达到上限
服务化/后台常驻：kimi --wire
- 启动 Wire 协议服务器，供本地客户端（如 IDE 插件、其他 Agent）通过协议通信
- 不接受初始提示词，需要配合 Wire 客户端使用

Execution Policy

执行时必须按以下顺序构造命令：

Step 1：确定执行模式

根据用户需求选择输出模式：

只需要最终结果 → --quiet
需要查看 Kimi 的分析/操作过程 → --print
需要程序解析 → --print --output-format stream-json

Step 2：确定是否需要自动审批

若任务涉及读写文件、执行 Shell 命令、安装依赖等需要审批的操作：

无头模式下必须加 --yolo（或依赖 --print 隐式启用 --yolo）
但在加之前，必须向用户声明风险："YOLO 模式下所有文件修改和命令都会自动执行，请确认是否继续？"

Step 3：确定工作目录

若任务与当前目录无关，或需要操作特定项目：

显式添加 --work-dir "目标路径"

Step 4：确定会话策略

全新单次任务：不加会话参数
继续之前的上下文：加 --continue
恢复指定会话：加 --session <ID>

Read Full Documentation on GitHub

Metadata

Author@aiyouwolegequ

Stars4473

Updated2026-05-01

View Author Profile

AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill

Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-aiyouwolegequ-kimi-cli-headless-execution": {
      "enabled": true,
      "auto_update": true
    }
  }
}

Related Skills