Open-Claw

Fornecedor: Open-Claw Nome de instalação: open-claw Status: Prévia Configuração nativa: ~/.openclaw/openclaw.json

InstalaçãoCopy Anchor Link

apothem install --harness open-claw

O adaptador grava o arquivo de configuração global de usuário do OpenClaw, projeta o perfil compartilhado em um documento de perfil e instala os cohorts de suporte do Apothem sob a raiz do harness. A configuração nativa do OpenClaw é JSON; o materializador renderiza uma chave, skills.load.extraDirs, e um arquivo existente mantém as suas outras chaves.

Arquivos gravados: ~/.openclaw/openclaw.json, o documento de perfil ~/.openclaw/apothem/rules/00-apothem-profile.md e arquivos de suporte sob ~/.openclaw/.apothem/support/

O documento de perfil termina com uma seção de arquivos de suporte do Apothem que nomeia o diretório absoluto sob ~/.openclaw/.apothem/support/ em relação ao qual cada citação no estilo do repositório (rules/<name>.md, templates/..., hooks/...) é resolvida.

Mapeamento do perfil para a configuração nativaCopy Anchor Link

O adaptador redige uma chave de configuração. Ele adiciona ~/.openclaw/.apothem/support/skills a skills.load.extraDirs, a lista de diretórios de skills extras que o OpenClaw lê, que é como o OpenClaw encontra as skills instaladas. A entrada vai depois de quaisquer entradas que você já liste, e as suas outras chaves permanecem como estão. A identidade, as preferências e as regras do perfil vão para o documento de perfil. Os comandos, skills, regras, templates e prompts de hook compartilhados são instalados como material de suporte sob ~/.openclaw/.apothem/support/.

Notas de compatibilidadeCopy Anchor Link

Adaptador em prévia. O OpenClaw carrega as skills do Apothem por meio de skills.load.extraDirs, mas não carrega por conta própria o restante da árvore de suporte nem o documento de perfil: nenhum de seus arquivos de instruções do workspace, nem sua configuração, aponta para lá; por isso, após a instalação, o OpenClaw roda sem as regras nem os servidores MCP do Apothem.

Conflitos de nome. O OpenClaw lê skills destas fontes, da maior precedência para a menor, e quando o mesmo nome de skill aparece em mais de um lugar a fonte mais alta vence: a pasta skills/ do workspace, a pasta .agents/skills/ do workspace, ~/.agents/skills (somente com o diretório de estado padrão), a pasta skills/ do diretório de estado (~/.openclaw/skills por padrão), as skills de workshop, as skills incluídas e de custodian e, por último, as pastas listadas em skills.load.extraDirs junto com as skills de plugins. O diretório do Apothem é uma entrada de extraDirs, então uma skill de mesmo nome que você mantenha em qualquer uma das fontes anteriores é a que o OpenClaw usa, e a cópia do Apothem dessa skill fica sem uso no disco. O Apothem grava somente em openclaw.json e sob ~/.openclaw/.apothem/support/, nunca nessas pastas anteriores, então a instalação, a atualização e a desinstalação não substituem uma skill que você mantenha ali.

agents.defaults.skills é a lista de permissão de nomes de skills; o Apothem não a edita, então, se você mantiver uma, verifique se ela nomeia as skills do Apothem que você deseja. apothem update mantém as chaves que você adiciona a openclaw.json. Os servidores MCP ficam no bloco mcp.servers da configuração do OpenClaw, que você gerencia com openclaw mcp add e os subcomandos relacionados; o adaptador não grava entradas ali. (Comportamento do OpenClaw conforme suas documentações de skills, configuração de skills e extensões de configuração, lidas em 2026-10-24, e sua documentação de CLI de MCP, lida em 2026-10-02.)

Comentários em openclaw.json. O OpenClaw lê sua configuração como JSON5, e o Apothem reescreve o arquivo como JSON simples. Quando o arquivo contém comentários ou outra sintaxe JSON5 e a entrada está ausente, o Apothem deixa o arquivo intacto e a instalação é interrompida com uma mensagem que nomeia a chave. Mescle você mesmo esta entrada no seu arquivo, ou converta o arquivo para JSON simples, e depois execute a instalação novamente:

{
  "skills": {
    "load": {
      "extraDirs": ["~/.openclaw/.apothem/support/skills"]
    }
  }
}

Uma entrada que você mesmo adiciona conta como sua: a desinstalação a mantém no lugar.

VerificaçãoCopy Anchor Link

apothem verify --harness open-claw

O comando verify confirma que:

1. A configuração nativa existe no caminho esperado.
2. Cada destino gerenciado existe; os arquivos gerenciados não estão vazios, e as configurações JSON ou YAML podem ser analisadas. Adicione --profile PATH para também confirmar que os arquivos instalados correspondem a esse perfil.
3. skills.load.extraDirs na configuração nativa lista ~/.openclaw/.apothem/support/skills. Sem essa entrada, o OpenClaw não carrega as skills instaladas; apothem update a adiciona de volta.
4. A rotina de verificação específica do adaptador informa sucesso.

AtualizaçãoCopy Anchor Link

apothem update --harness open-claw

Deriva novamente o documento de perfil a partir do estado atual do perfil compartilhado e atualiza os arquivos de suporte; openclaw.json mantém as chaves que já tem, e a entrada do Apothem em skills.load.extraDirs continua listada uma única vez, não importa quantas vezes você atualize. Execute após editar ~/.config/apothem/profile.yaml ou atualizar o pacote do Apothem instalado.

DesinstalaçãoCopy Anchor Link

apothem uninstall --harness open-claw

Remove o que o adaptador adicionou: sua entrada em skills.load.extraDirs, o documento de perfil e a árvore de suporte. As suas próprias chaves em openclaw.json permanecem, incluindo as suas próprias entradas de extraDirs, e o arquivo é excluído somente quando o Apothem o criou e nada seu restou. O YAML do perfil compartilhado e o motor do Apothem não são afetados.

Conformity gateCopy Anchor Link

python -m apothem.conformity.gate --all .

Solução de problemasCopy Anchor Link

Ajustes de configuraçãoCopy Anchor Link

Veja tambémCopy Anchor Link

• Todos os harnesses — o catálogo completo de ferramentas suportadas
• Guia de instalação — instale o Apothem neste harness
• Referência de apothem harnesses — liste e inspecione adaptadores pela CLI