ClawHub

Codex via tmux (WSL2 / Custom Proxy)

Other

Launch long-running Codex (or Claude Code) coding tasks via tmux on WSL2/Linux, bypassing SIGTERM timeouts. Use this skill INSTEAD OF coding-agent whenever: (1) the task may take >60s, (2) you need full-auto Codex execution, (3) you are on WSL2 with a custom OpenAI-compatible proxy (OPENAI_BASE_URL), (4) you want to monitor/steer a background Codex session mid-run, (5) building or extending the MyClaw project, (6) any multi-file code generation task. This skill has higher priority than coding-agent for Codex full-auto workflows on this machine. Triggers: codex tmux, long task, full-auto, MyClaw, background codex, WSL2 coding agent.

Install

openclaw skills install codex-tmux

Codex via tmux (WSL2 / Custom Proxy)

Preferred pattern for all Codex full-auto tasks on this machine. Avoids SIGTERM, supports mid-run steering.

Environment (this machine)

OPENAI_API_KEY="sk-5Ds6eFbTEE1zu5fQ14F4FfB5892b419dB1BfC7292147B9Ef"
OPENAI_BASE_URL="http://152.53.52.170:3003/v1"

Always pass both vars. Do NOT rely on shell inheritance — OpenClaw subprocesses don't source .bashrc.

Standard Launch Pattern

SESSION="codex-<feature>"   # e.g. codex-auth, codex-tools
WORKDIR=~/MyClaw            # or target repo

tmux new-session -d -s "$SESSION" -c "$WORKDIR" \
  "OPENAI_API_KEY='sk-5Ds6e...' OPENAI_BASE_URL='http://152.53.52.170:3003/v1' \
   codex --model gpt-5.3-codex --full-auto '$(cat /tmp/task.txt)'"

Write long prompts to /tmp/task.txt first, then reference via $(cat /tmp/task.txt).

Monitoring

# Check if alive
tmux has-session -t "$SESSION" 2>/dev/null && echo running || echo done

# Tail output (last 50 lines)
tmux capture-pane -t "$SESSION" -p | tail -50

# Or via OpenClaw exec:
exec("tmux capture-pane -t codex-auth -p | tail -30")

Mid-run Steering

tmux send-keys -t "$SESSION" "停一下。先做 API 层，不要改 UI。" Enter
tmux send-keys -t "$SESSION" "类型定义在 src/types.ts，用那个。" Enter

Task JSON Tracking

Write to /tmp/codex-tasks.json to track parallel jobs:

{
  "id": "feat-tools",
  "session": "codex-tools",
  "model": "gpt-5.3-codex",
  "desc": "实现工具系统 exec/read/write/web_fetch",
  "repo": "MyClaw",
  "startedAt": 1772433000000,
  "status": "running"
}

Completion Check

Poll every 2–3 min via:

tmux has-session -t "$SESSION" 2>/dev/null || echo "DONE"
git -C "$WORKDIR" log --oneline -3

Codex "完成" = tmux session 自动退出 + git commit 存在。

Cleanup

tmux kill-session -t "$SESSION" 2>/dev/null
git worktree prune

MyClaw-Specific Notes