跳到主要内容

快速开始

2 分钟内启动 PicoClaw。

获取 API Key

免费 API Key：OpenRouter（每月 20 万 token）· 智谱 AI（每月 20 万 token）

第一步：初始化​

picoclaw onboard

此命令创建工作目录 ~/.picoclaw/ 并生成默认配置文件。

第二步：配置​

编辑 ~/.picoclaw/config.json：

{
  "agents": {
    "defaults": {
      "workspace": "~/.picoclaw/workspace",
      "model": "gpt4",
      "max_tokens": 8192,
      "temperature": 0.7,
      "max_tool_iterations": 20
    }
  },
  "model_list": [
    {
      "model_name": "gpt4",
      "model": "openai/gpt-5.2",
      "api_key": "your-api-key"
    },
    {
      "model_name": "claude",
      "model": "anthropic/claude-sonnet-4-6",
      "api_key": "your-anthropic-key"
    }
  ]
}

详见 Model 配置，查看所有支持的提供商。

第三步：对话​

# 单次对话
picoclaw agent -m "你好，今天天气怎么样？"

# 交互模式
picoclaw agent

完成！你的 AI 助手已准备就绪。

CLI 命令参考​

命令描述
picoclaw onboard初始化配置和工作目录
picoclaw agent -m "..."单次对话
picoclaw agent交互式对话模式
picoclaw gateway启动网关（用于聊天应用）
picoclaw status显示状态
picoclaw cron list列出所有定时任务
picoclaw cron add ...添加定时任务

定时任务​

PicoClaw 通过 cron 工具支持提醒和周期性任务：

  • 一次性提醒："10 分钟后提醒我"
  • 周期性任务："每 2 小时提醒我"
  • Cron 表达式："每天早上 9 点提醒我"

在 Android 上运行（Termux）​

让旧手机变身 AI 助手：

# 注意：请将 v0.1.1 替换为 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

PicoClaw 在 Termux 中运行

故障排查​

网络搜索显示"API 配置问题"​

未配置搜索 API Key 时属于正常情况，PicoClaw 会自动回退到 DuckDuckGo（无需 Key）。

启用 Brave Search（每月 2000 次免费查询）：

{
  "tools": {
    "web": {
      "brave": {
        "enabled": true,
        "api_key": "YOUR_BRAVE_API_KEY"
      }
    }
  }
}

内容过滤错误​

某些提供商（如智谱 AI）有内容过滤，请尝试换一种表达方式或使用其他模型。

Telegram 机器人提示"Conflict: terminated by other getUpdates"​

同一时间只能运行一个 picoclaw gateway 实例，请停止其他实例。

API Key 对比​

服务免费额度用途
OpenRouter每月 20 万 token访问多种模型（Claude、GPT-4 等）
智谱 AI每月 20 万 token适合国内用户
Brave Search每月 2000 次查询网络搜索
Groq免费额度快速推理（Llama、Mixtral）
Cerebras免费额度快速推理（Llama、Qwen）