picoclaw-lite-agent

Configure, debug, and extend the PicoClaw AI assistant CLI and gateway.

Updated Jun 24, 2026
One-click install
npx skills add https://github.com/qiushido/picoclaw-lite --skill picoclaw-lite-agent-qiushido
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: picoclaw-lite-agent
Source: https://github.com/qiushido/picoclaw-lite/tree/main/workspace/skills/picoclaw-lite-agent
Command: npx skills add https://github.com/qiushido/picoclaw-lite --skill picoclaw-lite-agent-qiushido

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Working on PicoClaw itself requires knowing its exact CLI commands, config.json schema, provider matrix, session routing rules, and repository layout, and guessing wrong leads to broken configs and misdiagnosed bugs. ## Core Features & Use Cases - CLI and Config Guidance: Covers onboard, auth, model, skills, MCP, cron, gateway, and status commands plus config.json and .security.yml conventions. - Provider and Tooling Reference: Documents 30+ LLM providers, built-in tool families, subagent orchestration, voice/TTS setup, and slash commands. - Debugging and Contribution Workflows: Provides a PicoClaw-native troubleshooting sequence, log locations, repository map, and contribution rules. - Use Case: A user reports "model not found in model_list" after editing their config; use this Skill to check agents.defaults.model_name against model_list entries and verify PICOCLAW_CONFIG before proposing a fix. ## Quick Start Ask the agent to help you configure a new model provider in PicoClaw or debug why a skill is not loading.

Frequently Asked Questions about picoclaw-lite-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new model provider in PicoClaw?

Add an entry to model_list in config.json with provider, model, and api_keys, or run picoclaw-lite model add with --api-base and --api-key for OpenAI-compatible endpoints. For openai, anthropic, and antigravity, picoclaw-lite auth login provides helper OAuth flows.

How do I configure MCP servers in PicoClaw?

Use picoclaw-lite mcp add to register a server command, then verify with picoclaw-lite mcp list, show, and test. The CLI only manages tools.mcp.servers configuration; the gateway host loads and runs the servers at runtime.

Why is my PicoClaw skill not appearing in the skills list?

Check that the directory name is a valid lowercase-or-hyphen skill name, that SKILL.md exists, and that frontmatter name and description are present. Also confirm the skill lives under workspace skills, global skills, or builtin roots, since loading follows that priority order.

Does PicoClaw support local models like Ollama?

Yes, PicoClaw supports ollama, lmstudio, vllm, and litellm through local OpenAI-compatible endpoints, typically without API keys. Add a model_list entry pointing at the local endpoint and set agents.defaults.model_name to match.

Where are PicoClaw gateway logs stored?

Gateway logs are written to ~/.picoclaw-lite/logs/gateway.log and gateway_panic.log, or under $PICOCLAW_HOME/logs if PICOCLAW_HOME is overridden. Run picoclaw-lite gateway --debug for verbose output, adding --no-truncate for full prompt and tool payload inspection.

Why do my PicoClaw config edits not take effect?

Check whether PICOCLAW_CONFIG or PICOCLAW_HOME point to a different config file than the one you edited, and whether sensitive values belong in .security.yml instead of config.json. Also confirm whether you are testing the CLI path, the gateway path, or both.