+
+ PicoClaw: Asistente de IA Ultra-Eficiente en Go
+ +Hardware por 10$ · 10MB de RAM · Arranque en 1s · 皮皮虾，我们走！
+ +
+ 
+ 
-SipeedIO-black?style=flat&logo=x&logoColor=white){kind=icon}
+ 
+
+
+
+
+
|
+
+ |
+
+
+ |
+
+
+## 🦾 Demonstration
+
+### 🛠️ Standard Assistant Workflows
+
+🧩 Full-Stack Engineer |
+ 🗂️ Logging & Planning Management |
+ 🔎 Web Search & Learning |
+
|---|---|---|
|
+
|
+
|
+
| Develop • Deploy • Scale | +Schedule • Automate • Memory | +Discovery • Insights • Trends | +
+
+### 🐜 Innovative Low-Footprint Deploy
+
+¡PicoClaw puede ser instalado en casi cualquier dispositivo Linux!
+
+- $9.9 [LicheeRV-Nano](https://www.aliexpress.com/item/1005006519668532.html) versión E(Ethernet) o W(WiFi6), para un Asistente del Hogar Mínimo
+- $30~50 [NanoKVM](https://www.aliexpress.com/item/1005007369816019.html), o $100 [NanoKVM-Pro](https://www.aliexpress.com/item/1005010048471263.html) para Mantenimiento Automatizado de Servidores
+- $50 [MaixCAM](https://www.aliexpress.com/item/1005008053333693.html) o $100 [MaixCAM2](https://www.kickstarter.com/projects/zepan/maixcam2-build-your-next-gen-4k-ai-camera) para Monitoreo Inteligente
+
+
Únete a la Red Social de Agente (Agent Social Network)
+
+Conecta Picoclaw a la red social global Agent Social Network solo mandando también un único mensaje desde la CLI principal o desde cualquier Chat App vinculada e integrada al mismo.
+
+**Lee con atención `https://clawdchat.ai/skill.md` y guíate por la información mostrada de la página para unirte a [ClawdChat.ai](https://clawdchat.ai)**
+
+## ⚙️ Ajustes y Configuración
+
+Fichero index de configuración: `~/.picoclaw/config.json`
+
+### Variables de Entorno y Variables Locales
+
+A través de las variables de entorno puedes sobrescribir parámetros por defecto de los directorios preestablecidos. Resultando en algo altamente provechoso y aconsejable al desarrollar en puertos de instalaciones portátiles, despliegues docker encapsulados, para probar un picoclaw como un host temporal en formato de system service. Dichas dependientes controlarán direcciones de pathing (rutas estables de carpeta) por separado.
+
+| Variable | Descripción | Directorio Default |
+|-------------------|-----------------------------------------------------------------------------------------------------------------------------------------|---------------------------|
+| `PICOCLAW_CONFIG` | Sobrescribe toda la ruta al file original `.json` de configuración inicial principal. Le permite a tu picoclaw saber por propia carga en `config.json` cuál parámetro montar y levantar primero e ignora y exime las otras dependencias del ecosistema general. | `~/.picoclaw/config.json` |
+| `PICOCLAW_HOME` | Interviene sobrescribiendo a su homólogo nativo y original de base de datos base (root) desde las particiones del picoclaw alojado ahí. Realiza también cambios alternos dentro del árbol de localización pre-estructurada por omisión del actual `workspace` entre más registros. | `~/.picoclaw` |
+
+**Ejemplos:**
+
+```bash
+# Iniciar picoclaw usando un layout específico con configuración propia apartada
+# La ruta general del folder y de workspace son procesadas y evaluadas luego de cargar lo estipulado para ese archivo config base
+PICOCLAW_CONFIG=/etc/picoclaw/production.json picoclaw gateway
+
+# Ejecuta el picoclaw pero reubicando donde residirán sus dependencias de todos tus datas e info a nivel local como en la base -> /opt/picoclaw
+# Su índice y el Config en sí por pre-carga son reubicados con -> ~/.picoclaw/config.json
+# Luego la terminal del Workspace te generará su resultado final en -> /opt/picoclaw/workspace
+PICOCLAW_HOME=/opt/picoclaw picoclaw agent
+
+# Usar ambos a la en conjunto a la par para realizar un Setup completamente estructurado y customizado por el usuario a la medida
+PICOCLAW_HOME=/srv/picoclaw PICOCLAW_CONFIG=/srv/picoclaw/main.json picoclaw gateway
+```
+
+### Esquema de Directorio y Workspace
+
+PicoClaw mantiene los valores internos almacenados mediante y del modo configurado que hayas designado (el inicial es: `~/.picoclaw/workspace`):
+
+```
+~/.picoclaw/workspace/
+├── sessions/ # Tus sesiones del diálogo individual o grupal conversado en el tiempo y su histórico
+├── memory/ # Datos en variables de resguardo de a Memoria con largo término y contexto local (MEMORY.md)
+├── state/ # El state actual de pre-uso interactivo guardado del usuario (del último chat, etc.)
+├── cron/ # Trabajos pre-cargados a nivel de datos por su database en forma base y listado prehecho
+├── skills/ # Todo el panel base por skills y facultades únicas personalizadas (skills)
+├── AGENTS.md # Fichero guía guía o parámetro a comportamientos o instrucciones dictaminadas a la IA
+├── HEARTBEAT.md # Parámetros por cronómetros para revisar (revisa cada 30 mn pre-asignado de fabrica)
+├── IDENTITY.md # Preceptos propios del AI / Base principal
+├── SOUL.md # Estructura referida al sistema abstracto al que reza del tipo soul y de cognición de rol general
+└── USER.md # Preferencias designadas e instruídas de un User particular del sistema (y al agente)
+```
+
+### Fuentes directas y Skills Sources Extras
+
+De igual magnitud, aquí listamos dónde puedes encontrar o por origen dónde de forma de origen por omisión las "skills" principales radican (loads base/global):
+
+1. `~/.picoclaw/workspace/skills` (workspace de base)
+2. `~/.picoclaw/skills` (en un uso por red en global)
+3. `
+
+## 🐛 Problemas de Bug O de Falla General y de cómo se Resuelven (Troubleshooting)
+
+### La función usada al querer pre revisar del buscar de la "Web" "web search error", dice referir sobre "Configuración en origin por API Key issue conflict o falta en sí para buscar de origen en base al configuration error base por no API (API key configuration issue)"
+
+Señala un algo simple natural sin cuidado porque resulta muy normal a ti siempre en lo general (si lo ves), si esto no o es en sí la base en configuraciones hechas o simplemente porque nunca o ni porque siquiera haya pre cargado antes uno configurando una origin api del engine o base para Web. PicoClaw igual de forma útil por pre format sin intercesión nativa si le dejas, proporcionará en links enlaces de utilidad directa pre armada en vez en caso manual proporcionarle links "manual searching".
+
+#### Niveles, Preceptos sobre Proveedores (Prioridad) Sobre Las Diferentes Búsquedas
+
+Por defecto pre selecciona y acciona sin o con una sobre elección un sistema o listado con sus prioridades eligidas base este PicoClaw o prioriza o asienta una origin pre base buscando por su propia ruta (best available search provider algorithm routing format in this order origin):
+1. **Perplexity** (Siempre a condición natural de ser con un uso general de 'enabled' o habilitadas si lo de pre cargaste el "API key pre en base configurado" y originado - de base provisto e Inteligente IA que da los rastros indexados "citations citations base")
+2. **Brave Search** (Siempre y a la a condición igual estar lo 'enabled' de base al API pre configurado base original "key configured") - Uno respetando del usuario origin a origin privacidad original y pago un tanto base ("Privacy-focused paid API en $5/1000 origin pre base queries")
+3. **SearXNG** (Estando también 'enabled' su habilitación y origin o URL en `base_url` estando también o si "configured") - El servicio general alojado hosteado mediante una forma original a tu o y/o en todo o local "metasearch aggregating 70+ base en pre uso u pre engine list" (es gratis).
+4. **DuckDuckGo** (Habilitación base e "enabled, de forma nativa por en caso y fallback total por defecto default fall fallback route pre origin default a origen al fallo general) - Por si se lo hace u se usa no o necesita requerir ser provisto al base API Key a ninguna key origin o token de nada ni (No origin al API origin key ni base requerimiento al required list" gratis también).
+
+#### Algunas de Diversa Variedad por Múltiples Configuraciones Opciones sobre Tus "Buscadores u Exploración a nivel en y del uso general por web (Web Search base en options config Configuration o Settings en configuraciones u base configuration Options en web Options Configuration Option en Configuration) "
+
+**Opción Inicial Variante 1 de opción prioritaria 1 (Base Result General Mejorada Pre opción "Best Results" general en el top general y origin top)**: IA basada por el potente Perplexity AI Search motor o Engine
+```json
+{
+ "tools": {
+ "web": {
+ "perplexity": {
+ "enabled": true,
+ "api_key": "YOUR_PERPLEXITY_API_KEY",
+ "max_results": 5
+ }
+ }
+ }
+}
+```
+
+**Variante segunda U la Opción origin en base 2 Variante (Su de base Paid Base a Paid API uso origin a API "Paid Origin" o Paid Origin a la en Paid uso API de Paid pre origin API Origin para Paid de Opciones a Paid Para Paid API Usage a API en API Paid en base origen o modelo Pago API Origin API Base Paid API base API origin de la Opciones Paid u Opciones a modo Paid Use de Pago o "Paid u Paid pre origin API origin u uso o uso origen de u Base uso de Paid base Paid a Uso Opciones Usage Opciones Usage en Uso "Paid base Use de Opciones API o Pago Paid Usage de API a API en Paid Usage Opciones de Paid base Paid API base a Uso Opciones a Pago Paid")**: Genera u obtén de forma desde u en tu Origin key en forma Origin (en [https://brave.com/search/api](https://brave.com/search/api)) un Key o de llave en de base (origin token key a API key token) de origin ("Get an API a Base a Key API en Origin: $5 en / 1000 de Base a queries pre en "queries $5 a / 1000 base de las queries/mes $5 base $6 mes ~5$ dólares a o hasta 6 / mensuales" al /~ $5-6 de o /$ base a origin de "month base mensuales" de month / $5-mes a los mes /mes $ mensuales month a / mensuales / y de mes -/ de month/ mensuales month")
+```json
+{
+ "tools": {
+ "web": {
+ "brave": {
+ "enabled": true,
+ "api_key": "YOUR_BRAVE_API_KEY",
+ "max_results": 5
+ }
+ }
+ }
+}
+```
+
+**Alternativa Para Variación Para la Base u y Opción o en su Variante Tres en base o 3 a la 3 o Variante Opciones de Base o Uso Variante y 3 u (Pre Instalada u Base o Y En Tu Entorno Origin Self base para su Opción Self en Opciones y de u Host de la misma Instalado "Self-Hosted base de Hosted Instalado u Self o Host "Opciones Self en y origin uso a Uso origin o Opciones Hosted Instalada Origin o Hosted Instalada Opciones a Hosted Opciones Opciones u de la Host origin u en self alojado mismo host" u Opciones Opciones Hosted ")**: Puedes Desplegar tú también tú solo tú a base o pre base un pre host de Opciones base o de propio (su origin Opciones Origin) su uso propio uso el instanciador ("instance Opciones de [SearXNG](https://github.com/searxng/searxng)" Opciones)
+```json
+{
+ "tools": {
+ "web": {
+ "searxng": {
+ "enabled": true,
+ "base_url": "http://your-server:8888",
+ "max_results": 5
+ }
+ }
+ }
+}
+```
+
+Beneficios de usar SearXNG:
+- **Cero costo**: Sin tarifas de API ni límites de tasa de peticiones.
+- **Centrado en la privacidad**: Alojado por ti mismo, sin rastreos.
+- **Varios resultados**: Consulta en más de 70 motores de búsqueda simultáneamente.
+- **Perfecto para máquinas virtuales (VM) en la nube**: Soluciona problemas de bloqueo de IP en centros de datos (Oracle Cloud, GCP, AWS, Azure).
+- **No requiere API key**: Solamente despliega y configura la URL base.
+
+**Opción 4 (No Requiere Configuración)**: DuckDuckGo está habilitado por defecto como opción de respaldo (no necesita API key).
+
+Agrega la clave a `~/.picoclaw/config.json` si usas Brave:
+
+```json
+{
+ "tools": {
+ "web": {
+ "brave": {
+ "enabled": false,
+ "api_key": "YOUR_BRAVE_API_KEY",
+ "max_results": 5
+ },
+ "duckduckgo": {
+ "enabled": true,
+ "max_results": 5
+ },
+ "perplexity": {
+ "enabled": false,
+ "api_key": "YOUR_PERPLEXITY_API_KEY",
+ "max_results": 5
+ },
+ "searxng": {
+ "enabled": false,
+ "base_url": "http://your-searxng-instance:8888",
+ "max_results": 5
+ }
+ }
+ }
+}
+```
+
+### Obtengo errores de filtrado de contenido
+
+Algunos proveedores (como Zhipu) tienen filtros de contenido. Intenta reformular tu consulta o usar un modelo diferente.
+
+### El bot de Telegram dice "Conflict: terminated by other getUpdates"
+
+Esto ocurre cuando hay otra instancia del bot en ejecución. Asegúrate de tener un solo `picoclaw gateway` corriendo a la vez.
+
+---
+
+## 📝 Comparación de Apis (API Key)
+
+| Servicio | Nivel Gratuito | Caso de Uso |
+| ---------------- | ------------------------ | ------------------------------------- |
+| **OpenRouter** | 200K tokens/mes | Múltiples modelos (Claude, GPT-4, etc.) |
+| **Volcengine CodingPlan** | ¥9.9/primer mes | Ideal para usuarios chinos, múltiples modelos SOTA (Doubao, DeepSeek, etc.) |
+| **Zhipu** | 200K tokens/mes | Adecuado para usuarios chinos |
+| **Brave Search** | De Pago ($5/1000 búsquedas) | Funcionalidad de búsqueda en la red |
+| **SearXNG** | Ilimitado (Autoalojado) | Metabuscador centrado en la privacidad (70+ motores) |
+| **Groq** | Nivel gratuito disponible| Inferencia súper rápida (Llama, Mixtral) |
+| **Cerebras** | Nivel gratuito disponible| Inferencia súper rápida (Llama, Qwen, etc.) |
+| **LongCat** | Hasta 5M tokens/día | Inferencia rápida (nivel gratuito) |
+
+---
+
+
+
-[中文](README.zh.md) | [日本語](README.ja.md) | [Português](README.pt-br.md) | [Tiếng Việt](README.vi.md) | [Français](README.fr.md) | **English**
+[Español](README.es.md) | [中文](README.zh.md) | [日本語](README.ja.md) | [Português](README.pt-br.md) | [Tiếng Việt](README.vi.md) | [Français](README.fr.md) | **English**
+ 
+ 
