Frequently Asked Questions

{
  "model_list": [
    {
      "model_name": "gpt4",
      "model": "openai/gpt-5.2",
      "api_key": "your-api-key"
    }
  ],
  "agents": {
    "defaults": {
      "model": "gpt4"
    }
  }
}

# One-shot message
picoclaw agent -m "What is 2+2?"

# Interactive mode
picoclaw agent

picoclaw gateway
# Then message your bot on Telegram, Discord, WhatsApp, etc.

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

# Periodic Tasks

- Check my email for important messages
- Review my calendar for upcoming events
- Search for AI news and summarize

# Via CLI
picoclaw cron add "Remind me to call mom" "in 1 hour"
picoclaw cron list

# Via chat
"Remind me in 10 minutes to check the oven"
"Remind me every day at 9am to review my schedule"

# Install Ollama
curl -fsSL https://ollama.com/install.sh | sh

# Pull a model
ollama pull llama3

# Configure PicoClaw
{
  "model_list": [
    {
      "model_name": "local-llama",
      "model": "ollama/llama3"
    }
  ]
}

{
  "model_list": [
    {
      "model_name": "gpt4",
      "model": "openai/gpt-5.2",
      "api_key": "sk-..."
    },
    {
      "model_name": "claude",
      "model": "anthropic/claude-sonnet-4.6",
      "api_key": "sk-ant-..."
    },
    {
      "model_name": "local",
      "model": "ollama/llama3"
    }
  ],
  "agents": {
    "defaults": {
      "model": "gpt4"  // Default model
    }
  }
}

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

You are PicoClaw, a helpful AI assistant.
You are efficient, accurate, and friendly.

You respond concisely and professionally.
You prioritize user needs and ask clarifying questions.

When writing code, always include comments.
When searching, summarize findings concisely.

{
  "name": "check_email",
  "description": "Check email for important messages",
  "parameters": {
    "type": "object",
    "properties": {
      "filter": {
        "type": "string",
        "description": "Filter criteria (e.g., 'from:[email protected]')"
      }
    }
  },
  "handler": "skills/email_checker.sh"
}

export PICOCLAW_CONFIG=/path/to/instance1/config.json
picoclaw gateway

{
  "agents": {
    "defaults": {
      "workspace": "~/.picoclaw/workspace1"
    }
  }
}

{
  "gateway": {
    "host": "127.0.0.1",
    "port": 18790  // Use different port for each instance
  }
}