Tools
Tarefa do LLM
llm-task é uma ferramenta opcional de Plugin incluída que executa uma única
chamada de LLM somente com JSON e retorna uma saída estruturada, opcionalmente
validada em relação a um JSON Schema. Ela oferece a mecanismos de fluxo de
trabalho como o Lobster uma etapa de LLM sem exigir código personalizado do
OpenClaw para cada fluxo de trabalho.
Habilitar
- Habilite o Plugin:
{ "plugins": { "entries": { "llm-task": { "enabled": true } } }}- Permita a ferramenta:
{ "tools": { "alsoAllow": ["llm-task"] }}alsoAllow adiciona llm-task ao perfil de ferramentas ativo sem restringir
outras ferramentas principais. Use tools.allow somente se quiser um modo
restritivo de lista de permissões.
Configuração (opcional)
{ "plugins": { "entries": { "llm-task": { "enabled": true, "config": { "defaultProvider": "openai", "defaultModel": "gpt-5.6-sol", "defaultAuthProfileId": "main", "allowedModels": ["openai/gpt-5.6-sol"], "maxTokens": 800, "timeoutMs": 30000 } } } }}allowedModels é uma lista de permissões de strings provider/model; uma
solicitação para qualquer outro modelo é rejeitada. Todas as outras chaves são
valores alternativos por chamada, usados quando a chamada da ferramenta omite
esse parâmetro.
Parâmetros da ferramenta
| Parâmetro | Tipo | Observações |
|---|---|---|
prompt |
string | Obrigatório. Instrução da tarefa para o LLM. |
input |
any | Carga útil opcional; serializada como JSON e anexada ao prompt. |
schema |
object | JSON Schema opcional em relação ao qual a saída analisada deve ser validada. |
provider |
string | Substitui defaultProvider / o provedor padrão do agente. |
model |
string | Substitui defaultModel; aceita IDs de modelo simples, aliases ou uma referência provider/model (um prefixo de provedor duplicado é removido automaticamente). |
thinking |
string | Nível de raciocínio (por exemplo, low, medium); deve ser um dos níveis compatíveis com o modelo resolvido. |
authProfileId |
string | Substitui defaultAuthProfileId. |
temperature |
number | Aplicado quando possível; nem todos os provedores o respeitam. |
maxTokens |
number | Limite máximo de tokens de saída aplicado quando possível. |
timeoutMs |
number | Tempo limite da execução; padrão 30000. |
Saída
Retorna details.json (o JSON analisado e validado pelo esquema), além de
details.provider e details.model, que identificam o que realmente foi
executado.
Exemplo: etapa de fluxo de trabalho do Lobster
Limitação importante
O exemplo abaixo pressupõe que a CLI autônoma do Lobster esteja sendo
executada em um ambiente no qual openclaw.invoke já tenha o URL do Gateway e o
contexto de autenticação corretos.
Para o executor incorporado do Lobster incluído no OpenClaw, esse padrão de CLI aninhada não é confiável no momento:
openclaw.invoke --tool llm-task --action json --args-json '{ ... }'Até que o Lobster incorporado tenha uma ponte compatível com esse fluxo, prefira:
- chamadas diretas da ferramenta
llm-taskfora do Lobster; ou - etapas do Lobster que não dependam de chamadas aninhadas de
openclaw.invoke.
Exemplo da CLI autônoma do Lobster:
openclaw.invoke --tool llm-task --action json --args-json '{ "prompt": "Given the input email, return intent and draft.", "thinking": "low", "input": { "subject": "Hello", "body": "Can you help?" }, "schema": { "type": "object", "properties": { "intent": { "type": "string" }, "draft": { "type": "string" } }, "required": ["intent", "draft"], "additionalProperties": false }}'Observações de segurança
- Somente JSON: o modelo é instruído a retornar apenas um valor JSON, sem blocos de código nem comentários.
- Sem ferramentas: a execução subjacente mantém as ferramentas desabilitadas, portanto o modelo não pode fazer chamadas externas durante a tarefa.
- Trate a saída como não confiável, a menos que você a valide com
schema. - Coloque as aprovações antes de qualquer etapa com efeitos colaterais (enviar, publicar, executar) que consuma essa saída.
