에이전트 런타임

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​

Codex 표면

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

1. 사용자가 Codex 바인딩/제어/스레드/재개/조정/중지를 요청하면, 번들된 codex Plugin이 활성화되어 있을 때 네이티브 /codex 명령 표면을 사용합니다.
2. 사용자가 임베디드 런타임으로서 Codex를 요청하거나 일반적인 구독 기반 Codex 에이전트 경험을 원하면 openai/<model>을 사용합니다.
3. 사용자가 명시적으로 OpenAI 모델에 PI를 선택하면 모델 ref를 openai/<model>로 유지하고, 제공자/모델 런타임 정책을 agentRuntime.id: "pi"로 설정합니다. 선택된 openai-codex 인증 프로필은 내부적으로 PI의 레거시 Codex 인증 전송을 통해 라우팅됩니다.
4. 레거시 구성에 아직 openai-codex/* 모델 ref가 포함되어 있으면 openclaw doctor --fix로 openai/<model>로 복구합니다. doctor는 오래된 모델 ref가 이를 암시한 경우 제공자/모델 범위 agentRuntime.id: "codex"를 추가하여 Codex 인증 경로를 유지합니다.
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에 있을 수 있습니다.
2. 제공자 범위 런타임 정책은 다음 순위이며 models.providers.<provider>.agentRuntime에 있습니다.
3. auto 모드에서는 등록된 Plugin 런타임이 지원되는 제공자/모델 쌍을 청구할 수 있습니다.
4. auto 모드에서 어떤 런타임도 턴을 청구하지 않으면 OpenClaw는 호환성 런타임으로 PI를 사용합니다. 실행이 엄격해야 하는 경우 명시적 런타임 id를 사용하세요.

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

​

호환성 계약

​

상태 레이블

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

​

관련 항목

• Codex 하네스
• Codex 하네스 런타임
• OpenAI
• Agent 하네스 Plugin
• Agent 루프
• 모델
• 상태