persistent-code-terminal

OpenClaw 的持久化编码终端。它为每个项目创建一个独立的 tmux 会话：

-code-session

这使得以终端为第一优先级的 AI 编码（Codex CLI / Claude Code / 任意 CLI 工具）更加可靠，并且对移动设备/SSH 友好：

• 可随时分离（detach）与重新连接（reattach），不丢失输出
• 跨轮次保持 Shell 状态
• 持续运行长时间任务（如开发服务器、watch 模式等）

OpenClaw 自然语言路由

当用户意图是“在此仓库中使用自然语言驱动 Codex CLI”时，应首先经由此技能进行路由。

智能自动触发机制：

• 路由开关：openclaw.config.dev.autoCodeRouting（默认为 false）
• 启用后，将编码工作流消息通过以下方式路由：
  • {baseDir}/bin/persistent-code-terminal-route.sh ""
• 该路由脚本执行以下逻辑：
  • 意图识别（代码变更 / 修复 / 测试 / 构建 / 提交 / 推送 / Codex 相关表述）
  • 安全过滤（必须位于 Git 仓库内 + 含明确动作动词；若用户输入含 不要执行，只分析 则绕过执行）
  • 执行链：
    • persistent-code-terminal-auto.sh --max-retries 3 --instruction ""
    • persistent-code-terminal-summary.sh --lines 120
  • 依赖缺失时（tmux/codex）提供 doctor 式引导。

多项目路由支持：

• 单条消息可包含多个项目任务，以换行符 / ； / ; 分隔
• 支持的匹配模式：
  • 给 项目
  • 给项目：
  • 为 修复/增加/修改 ...
  • 项目 ...； 项目 ...
• 各项目任务按顺序串行执行：
  • start.sh --project
  • auto.sh --max-retries 3 --instruction ""
  • summary.sh --lines 120 --json
• 无效或未知项目的任务将被标记为失败，但不会阻塞其余任务的执行。

触发快捷方式（推荐）：

• 若用户消息以 codex 开头，则将剩余文本视为指令。
• 执行：
  • {baseDir}/bin/persistent-code-terminal-codex-exec.sh ""
• 随后报告状态：
  • {baseDir}/bin/persistent-code-terminal-status.sh
  • {baseDir}/bin/persistent-code-terminal-summary.sh --lines 120

在聊天驱动型运行中推荐的执行模式：

• start.sh（或由 send.sh 隐式自动创建）
• 对 Codex 驱动型工作使用 codex-exec.sh ""
• 使用 status.sh / summary.sh 进行简洁的进度汇报

若用户说“检查项目/继续会话/跑测试并总结”，请直接调用本技能对应脚本，无需让用户手动输入冗长的 Shell 命令。

核心模型（必须遵循）

start → send → read → decide

1. 启动/确保会话存在：

• {baseDir}/bin/persistent-code-terminal-start.sh

2. 发送 ONE 条命令：

• {baseDir}/bin/persistent-code-terminal-send.sh ""
  • 执行完成后追加面板哨兵标记：__PCT_EXIT_CODE__N
  • 支持参数：--timeout 、--dry-run、--phase

3. 读取输出：

• {baseDir}/bin/persistent-code-terminal-read.sh
  • 解析最新哨兵标记，并更新 .pct-state.json

4. 快速检查状态（可选）：

• {baseDir}/bin/persistent-code-terminal-status.sh
• {baseDir}/bin/persistent-code-terminal-summary.sh --lines 120
• {baseDir}/bin/persistent-code-terminal-doctor.sh
• {baseDir}/bin/persistent-code-terminal-list.sh（列出所有 *-code-session）
• {baseDir}/bin/persistent-code-terminal-switch.sh --project

状态文件：

• .pct-state.json（位于当前项目目录下）
• 字段包括：projectDir、session、lastCommand、lastExitCode、phase、updatedAt

结构化输出支持：

• {baseDir}/bin/persistent-code-terminal-read.sh --json
• {baseDir}/bin/persistent-code-terminal-summary.sh --json
• {baseDir}/bin/persistent-code-terminal-auto.sh --json

Codex 优先工作流（单次执行）

若已将 Codex CLI 安装为 codex 命令，推荐使用：

• {baseDir}/bin/persistent-code-terminal-codex-exec.sh ""
• 默认行为使用：
  • codex exec --full-auto --sandbox workspace-write --cd ""
• 可在指令前传入额外标志：
  • {baseDir}/bin/persistent-code-terminal-codex-exec.sh --json -o /tmp/codex.json ""
• 设置环境变量 PCT_CODEX_NO_DEFAULT_FLAGS=1 可禁用默认标志。

示例：

• {baseDir}/bin/persistent-code-terminal-codex-exec.sh "Implement feature X. Ensure build and tests pass. Commit and push to current branch. Do NOT force push."

安全性

• 除非用户明确要求，否则绝不执行 git push --force
• 确保密钥等敏感信息不出现在终端输出中
• 优先使用特性分支；除非用户明确要求，否则避免直接向 main/master 分支推送
• 对于网络或特权操作（例如 git push），须遵循当前生效的 Codex 审批策略与 sandbox 策略