Skill instalavel
Transforme o TwtAPI em uma Skill que o usuario instala imediatamente
Se voce nao quer que seus usuarios comecem pela documentacao da API e pelo codigo de requisicoes, entregue uma Skill instalavel. O gateway hospedado ja esta pronto, entao basta gerar uma skill_key e concluir uma configuracao curta no OpenClaw ou em um runner compativel.
A configuracao e curta
A Skill publica cuida do ponto de entrada hospedado, entao na maioria dos casos so sao necessarias tres acoes.
Gerar a skill_key no dashboard
Executar clawhub install twtapi
Adicionar TWTAPI_SKILL_KEY em variaveis de ambiente ou no arquivo de config
Por que Skill
Empacotar a API como entrada instalavel acelera a adocao
Uma Skill e melhor para usuarios que querem comecar com TwtAPI rapido, sem integrar primeiro a API bruta.
Menos friccao inicial
O usuario comeca com instalacao e configuracao, em vez de estudar documentacao e montar requests.
Entrega mais parecida com produto
Uma Skill e mais facil de entregar como capacidade pronta do que apenas uma referencia de API.
Autenticacao separada
Uma skill_key dedicada separa o acesso da Skill das credenciais principais da API.
Boa para workflows com agentes
Runners compativeis podem usar as capacidades do TwtAPI diretamente em fluxos assistidos ou agenticos.
Melhores cenarios
Quando uma Skill funciona melhor do que a API bruta
Se o objetivo e adocao rapida, e nao integracao personalizada profunda, a Skill costuma ser mais natural.
Entrega para nao desenvolvedores
Se a pessoa quer a capacidade sem construir sobre a API, o caminho da Skill e mais simples.
Distribuicao interna
Um mesmo comando de instalacao e um mesmo modelo de configuracao servem para varios times.
Agentes e automacao
Se voce precisa das capacidades de Twitter dentro de um runner ou sistema de automacao, o formato Skill encaixa muito bem.
Inicio rapido
A Skill publica instala em 3 passos
A camada de gateway ja esta hospedada, entao do lado do usuario so faltam uma key e uma configuracao local curta.
1. Gerar uma Skill Key
Abra a aba Skill no dashboard e crie ou rotacione uma skill_key com prefixo `tsk-`.
2. Instalar a Skill publica
Execute `clawhub install twtapi` em um ambiente compativel para instalar a Skill publica do TwtAPI.
3. Adicionar config e reiniciar
Defina `TWTAPI_SKILL_KEY` em variaveis de ambiente ou em um arquivo de config e reinicie o runner.
Modelos de instalacao
Esses tres trechos costumam bastar
Voce pode compartilhar estes comandos e modelos como fluxo padrao da Skill publica.
Comando de instalacao
Primeiro instale o pacote publico `twtapi`.
Depois adicione a skill_key gerada e reinicie o cliente ou runner.
clawhub install twtapi
Variavel de ambiente
A forma mais simples e guardar a skill_key em uma variavel de ambiente.
Substitua `tsk-your-skill-key` pelo valor real do dashboard.
export TWTAPI_SKILL_KEY="tsk-your-skill-key"
Modelo de configuracao
Se o cliente usa arquivo de configuracao, voce pode declarar a Skill diretamente nele.
Salve o modelo atualizado e reinicie o runner apos trocar a key de exemplo.
{
"skills": {
"entries": {
"twtapi": {
"enabled": true,
"env": {
"TWTAPI_SKILL_KEY": "tsk-your-skill-key"
}
}
}
}
}Perguntas frequentes
Perguntas comuns
Entregue o TwtAPI como uma Skill instalavel para OpenClaw e runners compativeis. A Skill publica ja inclui um gateway hospedado, entao o usuario precisa apenas de uma skill_key dedicada.
Qual a diferenca entre Skill e MCP?
MCP e para clientes de IA que falam o protocolo MCP. Skill e um formato instalavel, melhor para runners e para uma distribuicao mais simples.
O usuario precisa hospedar o gateway?
Nao. A Skill publica ja inclui o hosted gateway, entao o usuario so precisa da propria skill_key.
Por que usar uma skill_key separada?
Porque isso separa o acesso da Skill das credenciais principais da API e facilita rotacao, controle de acesso e diagnostico.
Ofereca primeiro uma entrada instalavel antes de empurrar o usuario para uma integracao completa de API
Se a sua prioridade e ativacao mais rapida, uma Skill publica costuma ser adotada com mais facilidade do que documentacao de API logo no primeiro dia.