에이전트 런타임

• 내장 하네스는 OpenClaw의 준비된 에이전트 루프 안에서 실행됩니다. 현재는 내장 openclaw 런타임과 codex, copilot 같은 등록된 Plugin 하네스가 여기에 해당합니다.
• CLI 백엔드는 모델 참조를 표준으로 유지하면서 로컬 CLI 프로세스를 실행합니다. 예를 들어 모델 범위 agentRuntime.id: "claude-cli"가 있는 anthropic/claude-opus-4-8은 “Anthropic 모델을 선택하고 Claude CLI를 통해 실행한다”는 뜻입니다. claude-cli는 내장 하네스 id가 아니며 AgentHarness 선택에 전달해서는 안 됩니다.

​

Codex 표면

{
  agents: {
    defaults: {
      model: "openai/gpt-5.5",
    },
  },
}

1. 사용자가 Codex bind/control/thread/resume/steer/stop을 요청하면, 번들된 codex Plugin이 활성화된 경우 네이티브 /codex 명령 표면을 사용합니다.
2. 사용자가 내장 런타임으로서의 Codex를 요청하거나 일반적인 구독 기반 Codex 에이전트 경험을 원하면 openai/<model>을 사용합니다.
3. 사용자가 명시적으로 OpenAI 모델에 OpenClaw를 선택하면 모델 참조를 openai/<model>로 유지하고 프로바이더/모델 런타임 정책을 agentRuntime.id: "openclaw"로 설정합니다. 선택된 openai OAuth 프로필은 내부적으로 OpenClaw의 Codex 인증 전송을 통해 라우팅됩니다.
4. 레거시 구성에 아직 레거시 Codex 모델 참조가 포함되어 있으면 openclaw doctor --fix로 openai/<model>로 복구합니다. doctor는 이전 모델 참조가 이를 암시한 위치에 프로바이더/모델 범위 agentRuntime.id: "codex"를 추가하여 Codex 인증 경로를 유지합니다. 레거시 codex-cli/* 모델 참조도 동일한 openai/<model> Codex 앱 서버 경로로 복구됩니다. OpenClaw는 더 이상 번들된 Codex CLI 백엔드를 유지하지 않습니다.
5. 사용자가 명시적으로 ACP, acpx 또는 Codex ACP 어댑터라고 말하면 runtime: "acp" 및 agentId: "codex"와 함께 ACP를 사용합니다.
6. 요청이 Claude Code, Gemini CLI, OpenCode, Cursor, Droid 또는 다른 외부 하네스에 관한 것이라면 네이티브 서브 에이전트 런타임이 아니라 ACP/acpx를 사용합니다.

​

런타임 소유권

• OpenClaw가 표면을 소유하면 OpenClaw는 일반적인 Plugin 훅 동작을 제공할 수 있습니다.
• 네이티브 런타임이 표면을 소유하면 OpenClaw에는 런타임 이벤트 또는 네이티브 훅이 필요합니다.
• 네이티브 런타임이 표준 스레드 상태를 소유하면 OpenClaw는 지원되지 않는 내부를 다시 쓰지 말고 컨텍스트를 미러링하고 투영해야 합니다.

​

런타임 선택

1. 모델 범위 런타임 정책이 우선합니다. 이는 구성된 프로바이더 모델 항목이나 agents.defaults.models["provider/model"].agentRuntime / agents.list[].models["provider/model"].agentRuntime에 위치할 수 있습니다. agents.defaults.models["vllm/*"].agentRuntime 같은 프로바이더 와일드카드는 정확한 모델 정책 이후에 적용되므로, 동적으로 검색된 프로바이더 모델이 정확한 모델별 예외를 덮어쓰지 않고 하나의 런타임을 공유할 수 있습니다.
2. 그다음에는 models.providers.<provider>.agentRuntime의 프로바이더 범위 런타임 정책이 적용됩니다.
3. auto 모드에서는 등록된 Plugin 런타임이 지원되는 프로바이더/모델 쌍을 클레임할 수 있습니다.
4. auto 모드에서 어떤 런타임도 턴을 클레임하지 않으면 OpenClaw는 호환성 런타임으로 openclaw를 사용합니다. 실행이 엄격해야 하는 경우 명시적인 런타임 id를 사용하세요.

{
  agents: {
    defaults: {
      model: "anthropic/claude-opus-4-8",
      models: {
        "anthropic/claude-opus-4-8": {
          agentRuntime: { id: "claude-cli" },
        },
      },
    },
  },
}

​

GitHub Copilot 에이전트 런타임

{
  agents: {
    defaults: {
      model: "github-copilot/gpt-5.5",
      models: {
        "github-copilot/gpt-5.5": {
          agentRuntime: { id: "copilot" },
        },
      },
    },
  },
}

​

호환성 계약

​

상태 레이블

• openai/gpt-5.5 같은 모델 참조는 선택된 공급자/모델을 알려줍니다.
• codex 같은 런타임 ID는 어떤 루프가 턴을 실행하는지 알려줍니다.
• Telegram 또는 Discord 같은 채널 레이블은 대화가 이루어지는 위치를 알려줍니다.

​

관련 항목

• Codex 하네스
• Codex 하네스 런타임
• GitHub Copilot 에이전트 런타임
• OpenAI
• 에이전트 하네스 Plugin
• 에이전트 루프
• 모델
• 상태