Command Output Display
/install command-output-display
Command Output Display - 命令输出展示技能
核心原则
用户应该能像坐在你旁边看你操作终端一样，看到每一个命令和它的完整输出！
📋 展示规范
1. 命令执行前
格式：
$ \x3Ccommand>
说明：
- 使用
$前缀表示要执行的命令 - 如果是多行命令，完整展示
- 如果有注释，用
#标注
示例：
$ systemctl --user status openclaw-gateway-boss.service --no-pager
$ cat > /tmp/test.json \x3C\x3C 'EOF'
{
"config": "value"
}
EOF
2. 命令执行后
格式：
# 输出：
\x3Ccommand output here>
说明：
- 使用
# 输出：标记输出开始 - 完整展示 stdout 和 stderr
- 保持原始格式（包括颜色代码如果有的话）
- 不要截断重要信息
示例：
# 输出：
● openclaw-gateway-boss.service - OpenClaw Gateway - Boss (爪爪机器人)
Loaded: loaded (/home/admin/.config/systemd/user/openclaw-gateway-boss.service; enabled)
Active: active (running) since Thu 2026-03-12 16:04:48 CST
Main PID: 5820 (MainThread)
3. 错误输出
格式：
# 输出（错误）：
\x3Cerror output>
# 错误信息：
- 退出码：\x3Cexit code>
- 详细说明：\x3Cdetails>
示例：
# 输出（错误）：
Job for openclaw-gateway-boss.service failed because the control process exited with error code.
# 错误信息：
- 退出码：1
- 服务状态：failed
- 可能原因：配置文件不存在
🎯 完整流程示例
示例 1: 服务管理
📝 目标：检查 boss 网关服务状态
执行命令：
```bash
$ systemctl --user status openclaw-gateway-boss.service --no-pager -n 10
输出：
● openclaw-gateway-boss.service - OpenClaw Gateway - Boss (爪爪机器人) Loaded: loaded (/home/admin/.config/systemd/user/openclaw-gateway-boss.service; enabled; vendor preset: enabled) Active: active (running) since Thu 2026-03-12 16:04:48 CST; 6s ago Main PID: 5820 (MainThread) CGroup: /user.slice/user-1000.slice/[email protected]/openclaw-gateway-boss.service └─5820 /usr/bin/node /opt/openclaw/dist/index.js gateway
Mar 12 16:04:48 iZbp14orusdl51yeoyqk9yZ systemd[992]: Started OpenClaw Gateway - Boss (爪爪机器人).
✅ 服务运行正常
### 示例 2: 文件操作
📝 目标：创建配置文件
执行命令：
$ cat > /home/admin/.openclaw/openclaw-boss.json \x3C\x3C 'EOF'
{
"gateway": {
"port": 19922,
"mode": "local"
}
}
EOF
输出：
（无输出表示成功）
验证文件：
$ ls -lh /home/admin/.openclaw/openclaw-boss.json
输出：
-rw-r--r-- 1 admin admin 6.0K Mar 12 17:50 /home/admin/.openclaw/openclaw-boss.json
✅ 文件创建成功，大小 6KB
### 示例 3: 多步骤操作
📝 任务：配置新网关
━━━━━━━━━━━━━━━━━━━━━━━━━━━ 步骤 1/4: 创建目录 ━━━━━━━━━━━━━━━━━━━━━━━━━━━
执行命令：
$ mkdir -p /home/admin/.openclaw/agents/boss
输出：
（无输出）
✅ 完成
━━━━━━━━━━━━━━━━━━━━━━━━━━━ 步骤 2/4: 复制 agent 配置 ━━━━━━━━━━━━━━━━━━━━━━━━━━━
执行命令：
$ cp -r /home/admin/.openclaw/agents/main/* /home/admin/.openclaw/agents/boss/
输出：
（无输出）
✅ 完成
━━━━━━━━━━━━━━━━━━━━━━━━━━━ 步骤 3/4: 创建配置文件 ━━━━━━━━━━━━━━━━━━━━━━━━━━━
[展示文件内容...]
✅ 配置文件已创建
━━━━━━━━━━━━━━━━━━━━━━━━━━━ 步骤 4/4: 验证结构 ━━━━━━━━━━━━━━━━━━━━━━━━━━━
执行命令：
$ tree -L 2 /home/admin/.openclaw/agents/boss/
输出：
/home/admin/.openclaw/agents/boss/ ├── agent │ └── agent.json └── sessions └── sessions.json
✅ 目录结构正确
━━━━━━━━━━━━━━━━━━━━━━━━━━━ 总结：所有步骤完成！ ━━━━━━━━━━━━━━━━━━━━━━━━━━━
### 示例 4: 调试问题
⚠️ 服务启动失败，正在调试...
📝 步骤 1: 查看服务状态
执行命令：
$ systemctl --user status openclaw-gateway-boss.service --no-pager
输出：
● openclaw-gateway-boss.service - OpenClaw Gateway - Boss Loaded: loaded Active: failed (Result: exit-code) Main PID: 1234 (code=exited, status=1/FAILURE)
❌ 服务启动失败
📝 步骤 2: 查看详细日志
执行命令：
$ journalctl --user -u openclaw-gateway-boss.service -n 20 --no-pager
输出：
Mar 12 16:05:14 node[1234]: error: unknown option '--config' Mar 12 16:05:14 systemd[992]: openclaw-gateway-boss.service: Failed with result 'exit-code'.
🔍 发现问题：命令行参数 --config 不被支持
📝 步骤 3: 检查正确的参数
执行命令：
$ node /opt/openclaw/dist/index.js gateway --help
输出：
Usage: gateway [options]
Options: --port \x3Cport> Gateway port (default: 10041) --verbose Enable verbose logging --help Show help
✅ 应该使用 --port 而不是 --config
## 🛠️ 特殊情况处理
### 1. 长输出
如果输出很长（超过 50 行）：
```bash
# 输出（前 50 行）：
[显示前 50 行]
... (共 234 行，需要看完整输出吗？)
2. 二进制输出
如果命令产生二进制输出或乱码：
# 输出：
[二进制数据，已跳过]
# 文件信息：
-rwxr-xr-x 1 admin admin 1.2M Mar 12 17:50 binary_file
3. 交互式命令
如果需要用户交互：
⚠️ 这个命令需要交互输入：
```bash
$ openclaw channels login
输出：
? 选择渠道类型：
❯ WhatsApp
Telegram
Discord
需要你在终端亲自操作，我没法代劳。要我继续其他步骤吗？
### 4. 后台命令
如果命令在后台运行：
📝 启动后台服务...
执行命令：
$ systemctl --user start openclaw-gateway.service &
输出：
[后台运行中...]
等待 3 秒后检查状态：
$ systemctl --user is-active openclaw-gateway.service
输出：
active
✅ 服务已在后台启动
## 📊 输出解读
不要只展示输出，还要帮助解读：
```bash
# 输出：
tcp 0 0 0.0.0.0:19922 0.0.0.0:* LISTEN 5820/openclaw-gatew
# 解读：
- 端口 19922 正在监听
- 进程 ID: 5820
- 绑定地址：0.0.0.0 (所有接口)
✅ 网关已成功启动
✅ 检查清单
执行命令后，确保：
- 展示了完整的命令
- 展示了完整的输出
- 包含了错误信息（如果有）
- 提供了解读或总结
- 格式清晰易读
目标： 让用户感觉就像坐在你旁边，看着你在终端上操作一样！
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install command-output-display - 安装完成后，直接呼叫该 Skill 的名称或使用
/command-output-display触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
Command Output Display 是什么？
展示完整终端命令及其全部输出，包括正常、错误、长输出、交互和后台运行，格式清晰易读，便于理解和调试。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 177 次。
如何安装 Command Output Display？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install command-output-display」即可一键安装，无需额外配置。
Command Output Display 是免费的吗？
是的，Command Output Display 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Command Output Display 支持哪些平台？
Command Output Display 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Command Output Display？
由 pikaqiuyaya（@pikaqiuyaya）开发并维护，当前版本 v1.0.0。