PicoClaw: Assistente de IA Ultra-Eficiente em Go

Hardware de $10 · 10MB de RAM · Boot em 1s · 皮皮虾，我们走！

🦐 PicoClaw é um assistente pessoal de IA ultra-leve inspirado no nanobot, reescrito do zero em Go por meio de um processo de "auto-inicialização" (self-bootstrapping) — onde o próprio agente de IA conduziu toda a migração de arquitetura e otimização de código.

⚡️ Extremamente leve: Roda em hardware de apenas $10 com <10MB de RAM. Isso é 99% menos memória que o OpenClaw e 98% mais barato que um Mac mini!

Caution

🚨 DECLARAÇÃO DE SEGURANÇA & CANAIS OFICIAIS

SEM CRIPTOMOEDAS: O PicoClaw NÃO possui nenhum token/moeda oficial. Todas as alegações no pump.fun ou outras plataformas de negociação são GOLPES.
DOMÍNIO OFICIAL: O ÚNICO site oficial é o picoclaw.io, e o site da empresa é o sipeed.com.
Aviso: Muitos domínios .ai/.org/.com/.net/... foram registrados por terceiros, não são nossos.
Aviso: O PicoClaw está em fase inicial de desenvolvimento e pode ter problemas de segurança de rede não resolvidos. Não implante em ambientes de produção antes da versão v1.0.
Nota: O PicoClaw recentemente fez merge de muitos PRs, o que pode resultar em maior consumo de memória (10-20MB) nas versões mais recentes. Planejamos priorizar a otimização de recursos assim que o conjunto de funcionalidades estiver estável.

📢 Novidades

2026-02-16 🎉 PicoClaw atingiu 12K stars em uma semana! Obrigado a todos pelo apoio! O PicoClaw está crescendo mais rápido do que jamais imaginamos. Dado o alto volume de PRs, precisamos urgentemente de maintainers da comunidade. Nossos papéis de voluntários e roadmap foram publicados oficialmente aqui — estamos ansiosos para ter você a bordo!

2026-02-13 🎉 PicoClaw atingiu 5000 stars em 4 dias! Obrigado à comunidade! Estamos finalizando o Roadmap do Projeto e configurando o Grupo de Desenvolvedores para acelerar o desenvolvimento do PicoClaw.

🚀 Chamada para Ação: Envie suas solicitações de funcionalidades nas GitHub Discussions. Revisaremos e priorizaremos na próxima reunião semanal.

2026-02-09 🎉 PicoClaw lançado oficialmente! Construído em 1 dia para trazer Agentes de IA para hardware de $10 com <10MB de RAM. 🦐 PicoClaw, Partiu!

✨ Funcionalidades

🪶 Ultra-Leve: Consumo de memória <10MB — 99% menor que o Clawdbot para funcionalidades essenciais.

💰 Custo Mínimo: Eficiente o suficiente para rodar em hardware de $10 — 98% mais barato que um Mac mini.

⚡️ Inicialização Relámpago: Tempo de inicialização 400X mais rápido, boot em 1 segundo mesmo em CPU single-core de 0.6GHz.

🌍 Portabilidade Real: Um único binário auto-contido para RISC-V, ARM e x86. Um clique e já era!

🤖 Auto-Construído por IA: Implementação nativa em Go de forma autônoma — 95% do núcleo gerado pelo Agente com refinamento humano no loop.

	OpenClaw	NanoBot	PicoClaw
Linguagem	TypeScript	Python	Go
RAM	>1GB	>100MB	< 10MB
Inicialização (CPU 0.8GHz)	>500s	>30s	<1s
Custo	Mac Mini $599	Maioria dos SBC Linux ~$50	Qualquer placa Linux A partir de $10

🦾 Demonstração

🛠️ Fluxos de Trabalho Padrão do Assistente

🧩 Engenharia Full-Stack	🗂️ Gerenciamento de Logs & Planejamento	🔎 Busca Web & Aprendizado

Desenvolver • Implantar • Escalar	Agendar • Automatizar • Memorizar	Descobrir • Analisar • Tendências

📱 Rode em celulares Android antigos

Dê uma segunda vida ao seu celular de dez anos atrás! Transforme-o em um assistente de IA inteligente com o PicoClaw. Início rápido:

Instale o Termux (Disponível no F-Droid ou Google Play).
Execute os comandos

# Nota: Substitua v0.1.1 pela versao mais recente da pagina de Releases
wget https://github.com/sipeed/picoclaw/releases/download/v0.1.1/picoclaw-linux-arm64
chmod +x picoclaw-linux-arm64
pkg install proot
termux-chroot ./picoclaw-linux-arm64 onboard

Depois siga as instruções na seção "Início Rápido" para completar a configuração!

🐜 Implantação Inovadora com Baixo Consumo

O PicoClaw pode ser implantado em praticamente qualquer dispositivo Linux!

$9.9 LicheeRV-Nano versão E (Ethernet) ou W (WiFi6), para Assistente Doméstico Minimalista
$30~50 NanoKVM, ou $100 NanoKVM-Pro para Manutenção Automatizada de Servidores
$50 MaixCAM ou $100 MaixCAM2 para Monitoramento Inteligente

picoclaw_detect_person.mp4

🌟 Mais cenários de implantação aguardam você!

📦 Instalação

Instalar com binário pré-compilado

Baixe o binário para sua plataforma na página de releases.

Instalar a partir do código-fonte (funcionalidades mais recentes, recomendado para desenvolvimento)

git clone https://github.com/sipeed/picoclaw.git

cd picoclaw
make deps

# Build, sem necessidade de instalar
make build

# Build para multiplas plataformas
make build-all

# Build e Instalar
make install

🐳 Docker Compose

Você tambêm pode rodar o PicoClaw usando Docker Compose sem instalar nada localmente.

# 1. Clone este repositorio
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw

# 2. Primeiro uso — gera docker/data/config.json automaticamente e para
docker compose -f docker/docker-compose.yml --profile gateway up
# O contêiner exibe "First-run setup complete." e para.

# 3. Configure suas API keys
vim docker/data/config.json   # Chaves de API do provedor, tokens de bot, etc.

# 4. Iniciar
docker compose -f docker/docker-compose.yml --profile gateway up -d

Tip

Usuários Docker: Por padrão, o Gateway ouve em 127.0.0.1, o que não é acessível a partir do host. Se você precisar acessar os endpoints de integridade ou expor portas, defina PICOCLAW_GATEWAY_HOST=0.0.0.0 em seu ambiente ou atualize o config.json.

# 5. Ver logs
docker compose -f docker/docker-compose.yml logs -f picoclaw-gateway

# 6. Parar
docker compose -f docker/docker-compose.yml --profile gateway down

Modo Agente (Execução única)

# Fazer uma pergunta
docker compose -f docker/docker-compose.yml run --rm picoclaw-agent -m "Quanto e 2+2?"

# Modo interativo
docker compose -f docker/docker-compose.yml run --rm picoclaw-agent

Atualizar

docker compose -f docker/docker-compose.yml pull
docker compose -f docker/docker-compose.yml --profile gateway up -d

🚀 Início Rápido

Tip

Configure sua API key em ~/.picoclaw/config.json. Obtenha API keys: OpenRouter (LLM) · Zhipu (LLM) Busca web e opcional — obtenha a Brave Search API gratuita (2000 consultas grátis/mês) ou use o fallback automático integrado.

1. Inicializar

picoclaw onboard

2. Configurar (~/.picoclaw/config.json)

{
  "model_list": [
    {
      "model_name": "gpt4",
      "model": "openai/gpt-5.2",
      "api_key": "sk-your-openai-key",
      "request_timeout": 300,
      "api_base": "https://api.openai.com/v1"
    }
  ],
  "agents": {
    "defaults": {
      "model_name": "gpt4"
    }
  },
  "tools": {
    "web": {
      "brave": {
        "enabled": false,
        "api_key": "YOUR_BRAVE_API_KEY",
        "max_results": 5
      },
      "duckduckgo": {
        "enabled": true,
        "max_results": 5
      }
    }
  }
}

Novo: O formato de configuração model_list permite adicionar provedores sem alterar código. Veja Configuração de Modelo para detalhes. request_timeout é opcional e usa segundos. Se omitido ou definido como <= 0, o PicoClaw usa o timeout padrão (120s).

3. Obter API Keys

Provedor de LLM: OpenRouter · Zhipu · Anthropic · OpenAI · Gemini
Busca Web (opcional): Brave Search - Plano gratuito disponível (2000 consultas/mês)

Nota: Veja config.example.json para um modelo de configuração completo.

4. Conversar

picoclaw agent -m "Quanto e 2+2?"

Pronto! Você tem um assistente de IA funcionando em 2 minutos.

💬 Integração com Apps de Chat

Converse com seu PicoClaw via Telegram, Discord, DingTalk, LINE ou WeCom.

Canal	Nível de Configuração
Telegram	Fácil (apenas um token)
Discord	Fácil (bot token + intents)
QQ	Fácil (AppID + AppSecret)
DingTalk	Médio (credenciais do app)
LINE	Médio (credenciais + webhook URL)
WeCom AI Bot	Médio (Token + chave AES)

Telegram (Recomendado)

1. Criar o bot

Abra o Telegram, busque @BotFather
Envie /newbot, siga as instruções
Copie o token

2. Configurar

{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN",
      "allow_from": ["YOUR_USER_ID"]
    }
  }
}

Obtenha seu User ID pelo @userinfobot no Telegram.

3. Executar

picoclaw gateway

Discord

1. Criar o bot

Acesse https://discord.com/developers/applications
Crie um aplicativo → Bot → Add Bot
Copie o token do bot

2. Habilitar Intents

Nas configurações do Bot, habilite MESSAGE CONTENT INTENT
(Opcional) Habilite SERVER MEMBERS INTENT se quiser usar lista de permissões baseada em dados dos membros

3. Obter seu User ID

Configurações do Discord → Avançado → habilite Modo Desenvolvedor
Clique com botão direito no seu avatar → Copiar ID do Usuário

4. Configurar

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN",
      "allow_from": ["YOUR_USER_ID"]
    }
  }
}

5. Convidar o bot

OAuth2 → URL Generator
Scopes: bot
Bot Permissions: Send Messages, Read Message History
Abra a URL de convite gerada e adicione o bot ao seu servidor

6. Executar

picoclaw gateway

1. Criar o bot

Acesse a QQ Open Platform
Crie um aplicativo → Obtenha AppID e AppSecret

2. Configurar

{
  "channels": {
    "qq": {
      "enabled": true,
      "app_id": "YOUR_APP_ID",
      "app_secret": "YOUR_APP_SECRET",
      "allow_from": []
    }
  }
}

Deixe allow_from vazio para permitir todos os usuários, ou especifique números QQ para restringir o acesso.

3. Executar

picoclaw gateway

DingTalk

1. Criar o bot

Acesse a Open Platform
Crie um app interno
Copie o Client ID e Client Secret

2. Configurar

{
  "channels": {
    "dingtalk": {
      "enabled": true,
      "client_id": "YOUR_CLIENT_ID",
      "client_secret": "YOUR_CLIENT_SECRET",
      "allow_from": []
    }
  }
}

Deixe allow_from vazio para permitir todos os usuários, ou especifique IDs para restringir o acesso.

3. Executar

picoclaw gateway

LINE

1. Criar uma Conta Oficial LINE

Acesse o LINE Developers Console
Crie um provider → Crie um canal Messaging API
Copie o Channel Secret e o Channel Access Token

2. Configurar

{
  "channels": {
    "line": {
      "enabled": true,
      "channel_secret": "YOUR_CHANNEL_SECRET",
      "channel_access_token": "YOUR_CHANNEL_ACCESS_TOKEN",
      "webhook_host": "0.0.0.0",
      "webhook_port": 18791,
      "webhook_path": "/webhook/line",
      "allow_from": []
    }
  }
}

3. Configurar URL do Webhook

O LINE requer HTTPS para webhooks. Use um reverse proxy ou tunnel:

# Exemplo com ngrok
ngrok http 18791

Em seguida, configure a Webhook URL no LINE Developers Console para https://seu-dominio/webhook/line e habilite Use webhook.

4. Executar

picoclaw gateway

Em chats de grupo, o bot responde apenas quando mencionado com @. As respostas citam a mensagem original.

Docker Compose: Adicione ports: ["18791:18791"] ao serviço picoclaw-gateway para expor a porta do webhook.

WeCom (WeChat Work)

O PicoClaw suporta três tipos de integração WeCom:

Opção 1: WeCom Bot (Robô) - Configuração mais fácil, suporta chats em grupo Opção 2: WeCom App (Aplicativo Personalizado) - Mais recursos, mensagens proativas, somente chat privado Opção 3: WeCom AI Bot (Robô Inteligente) - Bot IA oficial, respostas em streaming, suporta grupo e privado

Veja o Guia de Configuração WeCom AI Bot para instruções detalhadas.

Configuração Rápida - WeCom Bot:

1. Criar um bot

Acesse o Console de Administração WeCom → Chat em Grupo → Adicionar Bot de Grupo
Copie a URL do webhook (formato: https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx)

2. Configurar

{
  "channels": {
    "wecom": {
      "enabled": true,
      "token": "YOUR_TOKEN",
      "encoding_aes_key": "YOUR_ENCODING_AES_KEY",
      "webhook_url": "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=YOUR_KEY",
      "webhook_host": "0.0.0.0",
      "webhook_port": 18793,
      "webhook_path": "/webhook/wecom",
      "allow_from": []
    }
  }
}

Configuração Rápida - WeCom App:

1. Criar um aplicativo

Acesse o Console de Administração WeCom → Gerenciamento de Aplicativos → Criar Aplicativo
Copie o AgentId e o Secret
Acesse a página "Minha Empresa", copie o CorpID

2. Configurar recebimento de mensagens

Nos detalhes do aplicativo, clique em "Receber Mensagens" → "Configurar API"
Defina a URL como http://your-server:18792/webhook/wecom-app
Gere o Token e o EncodingAESKey

3. Configurar

{
  "channels": {
    "wecom_app": {
      "enabled": true,
      "corp_id": "wwxxxxxxxxxxxxxxxx",
      "corp_secret": "YOUR_CORP_SECRET",
      "agent_id": 1000002,
      "token": "YOUR_TOKEN",
      "encoding_aes_key": "YOUR_ENCODING_AES_KEY",
      "webhook_host": "0.0.0.0",
      "webhook_port": 18792,
      "webhook_path": "/webhook/wecom-app",
      "allow_from": []
    }
  }
}

4. Executar

picoclaw gateway

Nota: O WeCom App requer a abertura da porta 18792 para callbacks de webhook. Use um proxy reverso para HTTPS em produção.

Configuração Rápida - WeCom AI Bot:

1. Criar um AI Bot

Acesse o Console de Administração WeCom → Gerenciamento de Aplicativos → AI Bot
Configure a URL de callback: http://your-server:18791/webhook/wecom-aibot
Copie o Token e gere o EncodingAESKey

2. Configurar

{
  "channels": {
    "wecom_aibot": {
      "enabled": true,
      "token": "YOUR_TOKEN",
      "encoding_aes_key": "YOUR_43_CHAR_ENCODING_AES_KEY",
      "webhook_path": "/webhook/wecom-aibot",
      "allow_from": [],
      "welcome_message": "Olá! Como posso ajudá-lo?"
    }
  }
}

3. Executar

picoclaw gateway

Nota: O WeCom AI Bot usa protocolo de pull em streaming — sem preocupações com timeout de resposta. Tarefas longas (>5,5 min) alternam automaticamente para entrega via response_url.

Junte-se a Rede Social de Agentes

Conecte o PicoClaw a Rede Social de Agentes simplesmente enviando uma única mensagem via CLI ou qualquer App de Chat integrado.

Leia https://clawdchat.ai/skill.md e siga as instruções para entrar no ClawdChat.ai

⚙️ Configuração Detalhada

Arquivo de configuração: ~/.picoclaw/config.json

Estrutura do Workspace

O PicoClaw armazena dados no workspace configurado (padrão: ~/.picoclaw/workspace):

~/.picoclaw/workspace/
├── sessions/          # Sessoes de conversa e historico
├── memory/            # Memoria de longo prazo (MEMORY.md)
├── state/             # Estado persistente (ultimo canal, etc.)
├── cron/              # Banco de dados de tarefas agendadas
├── skills/            # Skills personalizadas
├── AGENTS.md          # Guia de comportamento do Agente
├── HEARTBEAT.md       # Prompts de tarefas periodicas (verificado a cada 30 min)
├── IDENTITY.md        # Identidade do Agente
├── SOUL.md            # Alma do Agente
├── TOOLS.md           # Descrição das ferramentas
└── USER.md            # Preferencias do usuario

🔒 Sandbox de Segurança

O PicoClaw roda em um ambiente sandbox por padrão. O agente so pode acessar arquivos e executar comandos dentro do workspace configurado.

Configuração Padrão

{
  "agents": {
    "defaults": {
      "workspace": "~/.picoclaw/workspace",
      "restrict_to_workspace": true
    }
  }
}

Opção	Padrão	Descrição
`workspace`	`~/.picoclaw/workspace`	Diretório de trabalho do agente
`restrict_to_workspace`	`true`	Restringir acesso de arquivos/comandos ao workspace

Ferramentas Protegidas

Quando restrict_to_workspace: true, as seguintes ferramentas são restritas ao sandbox:

Ferramenta	Função	Restrição
`read_file`	Ler arquivos	Apenas arquivos dentro do workspace
`write_file`	Escrever arquivos	Apenas arquivos dentro do workspace
`list_dir`	Listar diretorios	Apenas diretorios dentro do workspace
`edit_file`	Editar arquivos	Apenas arquivos dentro do workspace
`append_file`	Adicionar a arquivos	Apenas arquivos dentro do workspace
`exec`	Executar comandos	Caminhos dos comandos devem estar dentro do workspace

Proteção Adicional do Exec

Mesmo com restrict_to_workspace: false, a ferramenta exec bloqueia estes comandos perigosos:

rm -rf, del /f, rmdir /s — Exclusão em massa
format, mkfs, diskpart — Formatação de disco
dd if= — Criação de imagem de disco
Escrita em /dev/sd[a-z] — Escrita direta no disco
shutdown, reboot, poweroff — Desligamento do sistema
Fork bomb :(){ :|:& };:

Exemplos de Erro

[ERROR] tool: Tool execution failed
{tool=exec, error=Command blocked by safety guard (path outside working dir)}

[ERROR] tool: Tool execution failed
{tool=exec, error=Command blocked by safety guard (dangerous pattern detected)}

Desabilitar Restrições (Risco de Segurança)

Se você precisa que o agente acesse caminhos fora do workspace:

Método 1: Arquivo de configuração

{
  "agents": {
    "defaults": {
      "restrict_to_workspace": false
    }
  }
}

Método 2: Variável de ambiente

export PICOCLAW_AGENTS_DEFAULTS_RESTRICT_TO_WORKSPACE=false

⚠️ Aviso: Desabilitar esta restrição permite que o agente acesse qualquer caminho no seu sistema. Use com cuidado apenas em ambientes controlados.

Consistência do Limite de Segurança

A configuração restrict_to_workspace se aplica consistentemente em todos os caminhos de execução:

Caminho de Execução	Limite de Segurança
Agente Principal	`restrict_to_workspace` ✅
Subagente / Spawn	Herda a mesma restrição ✅
Tarefas Heartbeat	Herda a mesma restrição ✅

Todos os caminhos compartilham a mesma restrição de workspace — nao há como contornar o limite de segurança por meio de subagentes ou tarefas agendadas.

Heartbeat (Tarefas Periódicas)

O PicoClaw pode executar tarefas periódicas automaticamente. Crie um arquivo HEARTBEAT.md no seu workspace:

# Tarefas Periodicas

- Verificar meu email para mensagens importantes
- Revisar minha agenda para proximos eventos
- Verificar a previsao do tempo

O agente lerá este arquivo a cada 30 minutos (configurável) e executará as tarefas usando as ferramentas disponíveis.

Tarefas Assincronas com Spawn

Para tarefas de longa duração (busca web, chamadas de API), use a ferramenta spawn para criar um subagente:

# Tarefas Periódicas

## Tarefas Rápidas (resposta direta)
- Informar hora atual

## Tarefas Longas (usar spawn para async)
- Buscar notícias de IA na web e resumir
- Verificar email e reportar mensagens importantes

Comportamentos principais:

Funcionalidade	Descrição
spawn	Cria subagente assíncrono, não bloqueia o heartbeat
Contexto independente	Subagente tem seu próprio contexto, sem histórico de sessão
Ferramenta message	Subagente se comunica diretamente com o usuário via ferramenta message
Não-bloqueante	Após o spawn, o heartbeat continua para a próxima tarefa

Como Funciona a Comunicação do Subagente

Heartbeat dispara
    ↓
Agente lê HEARTBEAT.md
    ↓
Para tarefa longa: spawn subagente
    ↓                           ↓
Continua próxima tarefa    Subagente trabalha independentemente
    ↓                           ↓
Todas tarefas concluídas   Subagente usa ferramenta "message"
    ↓                           ↓
Responde HEARTBEAT_OK      Usuário recebe resultado diretamente

O subagente tem acesso às ferramentas (message, web_search, etc.) e pode se comunicar com o usuário independentemente sem passar pelo agente principal.

Configuração:

{
  "heartbeat": {
    "enabled": true,
    "interval": 30
  }
}

Opção	Padrão	Descrição
`enabled`	`true`	Habilitar/desabilitar heartbeat
`interval`	`30`	Intervalo de verificação em minutos (min: 5)

Variáveis de ambiente:

PICOCLAW_HEARTBEAT_ENABLED=false para desabilitar
PICOCLAW_HEARTBEAT_INTERVAL=60 para alterar o intervalo

Provedores

Note

O Groq fornece transcrição de voz gratuita via Whisper. Se configurado, mensagens de voz do Telegram serão automaticamente transcritas.

Provedor	Finalidade	Obter API Key
`gemini`	LLM (Gemini direto)	aistudio.google.com
`zhipu`	LLM (Zhipu direto)	bigmodel.cn
`openrouter` (Em teste)	LLM (recomendado, acesso a todos os modelos)	openrouter.ai
`anthropic` (Em teste)	LLM (Claude direto)	console.anthropic.com
`openai` (Em teste)	LLM (GPT direto)	platform.openai.com
`deepseek` (Em teste)	LLM (DeepSeek direto)	platform.deepseek.com
`qwen`	Alibaba Qwen	dashscope.console.aliyun.com
`cerebras`	Cerebras	cerebras.ai
`groq`	LLM + Transcrição de voz (Whisper)	console.groq.com

Configuração Zhipu

1. Obter API key

Obtenha a API key

2. Configurar

{
  "agents": {
    "defaults": {
      "workspace": "~/.picoclaw/workspace",
      "model": "glm-4.7",
      "max_tokens": 8192,
      "temperature": 0.7,
      "max_tool_iterations": 20
    }
  },
  "providers": {
    "zhipu": {
      "api_key": "Sua API Key",
      "api_base": "https://open.bigmodel.cn/api/paas/v4"
    }
  }
}

3. Executar

picoclaw agent -m "Ola, como vai?"

Exemplo de configuraçao completa

{
  "agents": {
    "defaults": {
      "model": "anthropic/claude-opus-4-5"
    }
  },
  "providers": {
    "openrouter": {
      "api_key": "sk-or-v1-xxx"
    },
    "groq": {
      "api_key": "gsk_xxx"
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "123456:ABC...",
      "allow_from": ["123456789"]
    },
    "discord": {
      "enabled": true,
      "token": "",
      "allow_from": [""]
    },
    "whatsapp": {
      "enabled": false
    },
    "feishu": {
      "enabled": false,
      "app_id": "cli_xxx",
      "app_secret": "xxx",
      "encrypt_key": "",
      "verification_token": "",
      "allow_from": []
    },
    "qq": {
      "enabled": false,
      "app_id": "",
      "app_secret": "",
      "allow_from": []
    }
  },
  "tools": {
    "web": {
      "brave": {
        "enabled": false,
        "api_key": "BSA...",
        "max_results": 5
      },
      "duckduckgo": {
        "enabled": true,
        "max_results": 5
      }
    },
    "cron": {
      "exec_timeout_minutes": 5
    }
  },
  "heartbeat": {
    "enabled": true,
    "interval": 30
  }
}

Configuração de Modelo (model_list)

Novidade! PicoClaw agora usa uma abordagem de configuração centrada no modelo. Basta especificar o formato fornecedor/modelo (ex: zhipu/glm-4.7) para adicionar novos provedores—nenhuma alteração de código necessária!

Este design também possibilita o suporte multi-agent com seleção flexível de provedores:

Diferentes agentes, diferentes provedores : Cada agente pode usar seu próprio provedor LLM
Modelos de fallback : Configure modelos primários e de reserva para resiliência
Balanceamento de carga : Distribua solicitações entre múltiplos endpoints
Configuração centralizada : Gerencie todos os provedores em um só lugar

📋 Todos os Fornecedores Suportados

Fornecedor	Prefixo `model`	API Base Padrão	Protocolo	Chave API
OpenAI	`openai/`	`https://api.openai.com/v1`	OpenAI	Obter Chave
Anthropic	`anthropic/`	`https://api.anthropic.com/v1`	Anthropic	Obter Chave
Zhipu AI (GLM)	`zhipu/`	`https://open.bigmodel.cn/api/paas/v4`	OpenAI	Obter Chave
DeepSeek	`deepseek/`	`https://api.deepseek.com/v1`	OpenAI	Obter Chave
Google Gemini	`gemini/`	`https://generativelanguage.googleapis.com/v1beta`	OpenAI	Obter Chave
Groq	`groq/`	`https://api.groq.com/openai/v1`	OpenAI	Obter Chave
Moonshot	`moonshot/`	`https://api.moonshot.cn/v1`	OpenAI	Obter Chave
Qwen (Alibaba)	`qwen/`	`https://dashscope.aliyuncs.com/compatible-mode/v1`	OpenAI	Obter Chave
NVIDIA	`nvidia/`	`https://integrate.api.nvidia.com/v1`	OpenAI	Obter Chave
Ollama	`ollama/`	`http://localhost:11434/v1`	OpenAI	Local (sem chave necessária)
OpenRouter	`openrouter/`	`https://openrouter.ai/api/v1`	OpenAI	Obter Chave
VLLM	`vllm/`	`http://localhost:8000/v1`	OpenAI	Local
Cerebras	`cerebras/`	`https://api.cerebras.ai/v1`	OpenAI	Obter Chave
Volcengine	`volcengine/`	`https://ark.cn-beijing.volces.com/api/v3`	OpenAI	Obter Chave
ShengsuanYun	`shengsuanyun/`	`https://router.shengsuanyun.com/api/v1`	OpenAI	-
Antigravity	`antigravity/`	Google Cloud	Custom	Apenas OAuth
GitHub Copilot	`github-copilot/`	`localhost:4321`	gRPC	-

Configuração Básica

{
  "model_list": [
    {
      "model_name": "gpt-5.2",
      "model": "openai/gpt-5.2",
      "api_key": "sk-your-openai-key"
    },
    {
      "model_name": "claude-sonnet-4.6",
      "model": "anthropic/claude-sonnet-4.6",
      "api_key": "sk-ant-your-key"
    },
    {
      "model_name": "glm-4.7",
      "model": "zhipu/glm-4.7",
      "api_key": "your-zhipu-key"
    }
  ],
  "agents": {
    "defaults": {
      "model": "gpt-5.2"
    }
  }
}

Exemplos por Fornecedor

OpenAI

{
  "model_name": "gpt-5.2",
  "model": "openai/gpt-5.2",
  "api_key": "sk-..."
}

Zhipu AI (GLM)

{
  "model_name": "glm-4.7",
  "model": "zhipu/glm-4.7",
  "api_key": "your-key"
}

Anthropic (com OAuth)

{
  "model_name": "claude-sonnet-4.6",
  "model": "anthropic/claude-sonnet-4.6",
  "auth_method": "oauth"
}

Execute picoclaw auth login --provider anthropic para configurar credenciais OAuth.

Proxy/API personalizada

{
  "model_name": "my-custom-model",
  "model": "openai/custom-model",
  "api_base": "https://my-proxy.com/v1",
  "api_key": "sk-...",
  "request_timeout": 300
}

Balanceamento de Carga

Configure vários endpoints para o mesmo nome de modelo—PicoClaw fará round-robin automaticamente entre eles:

{
  "model_list": [
    {
      "model_name": "gpt-5.2",
      "model": "openai/gpt-5.2",
      "api_base": "https://api1.example.com/v1",
      "api_key": "sk-key1"
    },
    {
      "model_name": "gpt-5.2",
      "model": "openai/gpt-5.2",
      "api_base": "https://api2.example.com/v1",
      "api_key": "sk-key2"
    }
  ]
}

Migração da Configuração Legada `providers`

A configuração antiga providers está descontinuada mas ainda é suportada para compatibilidade reversa.

Configuração Antiga (descontinuada):

{
  "providers": {
    "zhipu": {
      "api_key": "your-key",
      "api_base": "https://open.bigmodel.cn/api/paas/v4"
    }
  },
  "agents": {
    "defaults": {
      "provider": "zhipu",
      "model": "glm-4.7"
    }
  }
}

Nova Configuração (recomendada):

{
  "model_list": [
    {
      "model_name": "glm-4.7",
      "model": "zhipu/glm-4.7",
      "api_key": "your-key"
    }
  ],
  "agents": {
    "defaults": {
      "model": "glm-4.7"
    }
  }
}

Para o guia de migração detalhado, consulte docs/migration/model-list-migration.md.

Referência CLI

Comando	Descrição
`picoclaw onboard`	Inicializar configuração & workspace
`picoclaw agent -m "..."`	Conversar com o agente
`picoclaw agent`	Modo de chat interativo
`picoclaw gateway`	Iniciar o gateway (para bots de chat)
`picoclaw status`	Mostrar status
`picoclaw cron list`	Listar todas as tarefas agendadas
`picoclaw cron add ...`	Adicionar uma tarefa agendada

Tarefas Agendadas / Lembretes

O PicoClaw suporta lembretes agendados e tarefas recorrentes por meio da ferramenta cron:

Lembretes únicos: "Remind me in 10 minutes" (Me lembre em 10 minutos) → dispara uma vez após 10min
Tarefas recorrentes: "Remind me every 2 hours" (Me lembre a cada 2 horas) → dispara a cada 2 horas
Expressões Cron: "Remind me at 9am daily" (Me lembre às 9h todos os dias) → usa expressão cron

As tarefas são armazenadas em ~/.picoclaw/workspace/cron/ e processadas automaticamente.

🤝 Contribuir & Roadmap

PRs são bem-vindos! O código-fonte é intencionalmente pequeno e legível. 🤗

Roadmap em breve...

Grupo de desenvolvedores em formação. Requisito de entrada: Pelo menos 1 PR com merge.

Grupos de usuários:

Discord: https://discord.gg/V4sAZ9XWpN

🐛 Solução de Problemas

Busca web mostra "API 配置问题"

Isso é normal se você ainda não configurou uma API key de busca. O PicoClaw fornecerá links úteis para busca manual.

Para habilitar a busca web:

Opção 1 (Recomendado): Obtenha uma API key gratuita em https://brave.com/search/api (2000 consultas grátis/mês) para os melhores resultados.
Opção 2 (Sem Cartão de Crédito): Se você não tem uma key, o sistema automaticamente usa o DuckDuckGo como fallback (sem necessidade de key).

Adicione a key em ~/.picoclaw/config.json se usar o Brave:

{
  "tools": {
    "web": {
      "brave": {
        "enabled": false,
        "api_key": "YOUR_BRAVE_API_KEY",
        "max_results": 5
      },
      "duckduckgo": {
        "enabled": true,
        "max_results": 5
      }
    }
  }
}

Erros de filtragem de conteúdo

Alguns provedores (como Zhipu) possuem filtragem de conteúdo. Tente reformular sua pergunta ou use um modelo diferente.

Bot do Telegram diz "Conflict: terminated by other getUpdates"

Isso acontece quando outra instância do bot está em execução. Certifique-se de que apenas um picoclaw gateway esteja rodando por vez.

📝 Comparação de API Keys

Serviço	Plano Gratuito	Caso de Uso
OpenRouter	200K tokens/mês	Múltiplos modelos (Claude, GPT-4, etc.)
Zhipu	200K tokens/mês	Melhor para usuários chineses
Brave Search	2000 consultas/mês	Funcionalidade de busca web
Groq	Plano gratuito disponível	Inferência ultra-rápida (Llama, Mixtral)
Cerebras	Plano gratuito disponível	Inferência ultra-rápida (Llama 3.3 70B)

FilesExpand file tree

README.pt-br.md

Latest commit

History

README.pt-br.md

File metadata and controls

PicoClaw: Assistente de IA Ultra-Eficiente em Go

Hardware de $10 · 10MB de RAM · Boot em 1s · 皮皮虾，我们走！

📢 Novidades

✨ Funcionalidades

🦾 Demonstração

🛠️ Fluxos de Trabalho Padrão do Assistente

📱 Rode em celulares Android antigos

🐜 Implantação Inovadora com Baixo Consumo

📦 Instalação

Instalar com binário pré-compilado

Instalar a partir do código-fonte (funcionalidades mais recentes, recomendado para desenvolvimento)

🐳 Docker Compose

Modo Agente (Execução única)

Atualizar

🚀 Início Rápido

💬 Integração com Apps de Chat

Junte-se a Rede Social de Agentes

⚙️ Configuração Detalhada

Estrutura do Workspace

🔒 Sandbox de Segurança

Configuração Padrão

Ferramentas Protegidas

Proteção Adicional do Exec

Exemplos de Erro

Desabilitar Restrições (Risco de Segurança)

Consistência do Limite de Segurança

Heartbeat (Tarefas Periódicas)

Tarefas Assincronas com Spawn

Como Funciona a Comunicação do Subagente

Provedores

Configuração de Modelo (model_list)

📋 Todos os Fornecedores Suportados

Configuração Básica

Exemplos por Fornecedor

Balanceamento de Carga

Migração da Configuração Legada providers

Referência CLI

Tarefas Agendadas / Lembretes

🤝 Contribuir & Roadmap

🐛 Solução de Problemas

Busca web mostra "API 配置问题"

Erros de filtragem de conteúdo

Bot do Telegram diz "Conflict: terminated by other getUpdates"

📝 Comparação de API Keys

Migração da Configuração Legada `providers`