← Voltar para o Índice

Ecossistema RiCode Para OpenClaw

Este documento descreve o ecossistema multiagente criado para ser reaplicado em futuros ambientes OpenClaw, garantindo clareza entre planejamento e execução.

Objetivo

Criar um fluxo confiável com dois agentes separados por papel:

• Planner (Ricode): Entende o pedido, organiza o trabalho, define critérios e delega.
• Executor (Coding Agent): Executa somente o plano recebido e devolve evidências.

Princípios de Arquitetura

Planner (Planejador)

Responsabilidades incluem receber o objetivo do usuário, quebrar em etapas, definir critérios de aceite e delegar ao executor. Ele planeja, não executa.

Executor

Responsabilidades incluem receber o plano estruturado, executar as etapas recebidas e registrar evidências. Ele executa, não replaneja.

Configuração Operacional

Modelos e Autenticação

• Planner: Recomendado deepseek/deepseek-reasoner (via token) ou openai/gpt-5.1-codex.
• Executor: Recomendado openai-codex/gpt-5.1-codex (via OAuth login-auth).

Layout de Workspaces

~/.openclaw/workspace (Geral)
~/.openclaw/workspace-planner (Instruções do Planejador)
~/.openclaw/workspace-executor (Contexto do Executor)

Configuração JSON (openclaw.json)

Abaixo está o exemplo real de configuração dos agentes Planner e Executor (com dados sensíveis ocultos):

{
  "tools": {
    "sessions": {
      "visibility": "all"
    },
    "agentToAgent": {
      "enabled": true,
      "allow": ["main", "planner", "executor"]
    }
  },
  "agents": {
    "defaults": {
      "sandbox": {
        "sessionToolsVisibility": "all"
      }
    },
    "list": [
      {
        "id": "main",
        "default": true,
        "name": "main",
        "workspace": "/root/.openclaw/workspace",
        "model": "openai/gpt-5.1-codex"
      },
      {
        "id": "planner",
        "name": "planner",
        "workspace": "/root/.openclaw/workspace-planner",
        "model": {
          "primary": "deepseek/deepseek-reasoner",
          "fallbacks": ["openai/gpt-5.1-codex"]
        },
        "sandbox": {
          "mode": "all",
          "workspaceAccess": "rw",
          "scope": "agent"
        },
        "tools": {
          "profile": "minimal",
          "alsoAllow": ["read", "write", "edit", "web_search", "web_fetch", "sessions_send", "session_status"]
        }
      },
      {
        "id": "executor",
        "name": "executor",
        "workspace": "/root/.openclaw/workspace-executor",
        "model": "openai-codex/gpt-5.1-codex",
        "sandbox": {
          "mode": "all",
          "workspaceAccess": "rw",
          "scope": "agent"
        },
        "tools": {
          "profile": "coding",
          "alsoAllow": ["sessions_send", "session_status"]
        }
      }
    ]
  }
}

Problemas Comuns e Correções (Troubleshooting)

• Gateway com Drift: Se o handoff falhar, use openclaw gateway install --force.
• Sessão entre Agentes Invisível: Garantir que tools.sessions.visibility esteja setado como "all" no config.
• Warning de apply_patch: Habilitar applyPatch explicitamente para o modelo do executor.

---