PicoClaw Gemini API 接入教程

PicoClaw 是一个超轻量级 AI 助手，可在 10 美元硬件上运行，内存占用 <10MB。本教程将介绍如何为 PicoClaw 配置 Gemini API。

简介

PicoClaw 支持多种方式接入 Gemini API：

• Defapi 平台 (推荐)：半价优惠，无需翻墙，国内可直接访问
• 官方 Google Gemini API：直连官方服务
• OpenRouter：通过第三方路由访问

方法一：Defapi (推荐)

Defapi 是一个 AI API 聚合平台，价格只有官方的半价，非常适合个人开发者和小型项目使用。Defapi 的 Gemini 模型兼容 OpenAI v1/chat/completions 协议，可以直接使用。

1. 获取 Defapi API Key

1. 访问 Defapi 官网 注册账号
2. 在个人中心获取 API Key

2. 配置 PicoClaw

编辑配置文件 ~/.picoclaw/config.json：

{
  "agents": {
    "defaults": {
      "model": "google/gemini-2.0-flash"
    }
  },
  "providers": {
    "openrouter": {
      "api_key": "你的Defapi-Key",
      "api_base": "https://api.defapi.org"
    }
  }
}

3. 支持的 Gemini 模型

4. Defapi 优势

• 半价优惠：比官方价格低 50%
• 无需翻墙：国内可直接访问
• 稳定快速：企业级稳定服务
• 兼容性好：兼容 OpenAI v1/chat/completions 协议

---

方法二：官方 Gemini API

1. 获取 API Key

1. 访问 Google AI Studio
2. 创建 API Key

2. 配置 PicoClaw

{
  "agents": {
    "defaults": {
      "model": "gemini-2.0-flash"
    }
  },
  "providers": {
    "gemini": {
      "api_key": "your-gemini-api-key"
    }
  }
}

如需代理：

{
  "providers": {
    "gemini": {
      "api_key": "your-gemini-api-key",
      "proxy": "http://127.0.0.1:7890"
    }
  }
}

---

方法三：OpenRouter

1. 获取 API Key

访问 OpenRouter 获取 API Key。

2. 配置 PicoClaw

{
  "agents": {
    "defaults": {
      "model": "google/gemini-2.0-flash"
    }
  },
  "providers": {
    "openrouter": {
      "api_key": "sk-or-v1-xxx"
    }
  }
}

如需代理：

{
  "providers": {
    "openrouter": {
      "api_key": "sk-or-v1-xxx",
      "proxy": "http://127.0.0.1:7890"
    }
  }
}

---

验证 PicoClaw 是否正常工作

方法一：直接发消息测试

# 进入 PicoClaw 目录
cd picoclaw

# 测试 Gemini 是否正常工作
picoclaw agent -m "你好，请回复 hello"

如果返回正常回复，说明配置成功！

方法二：启动 Gateway 测试

# 启动网关
picoclaw gateway

# 然后通过配置的聊天渠道 (Telegram/Discord 等) 发送消息测试

方法三：查看日志

# 查看 PicoClaw 日志
docker compose logs -f picoclaw-gateway

---

PicoClaw 常见用例

1. 智能对话助手

配置 Telegram 或 Discord 机器人，打造随时可用的 AI 对话助手。

{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN"
    }
  }
}

2. 代码审查助手

PicoClaw 可以读取代码文件，帮助审查和优化代码。

# 让 AI 审查代码
picoclaw agent -m "请审查 src/main.go 文件的代码质量"

3. 文档生成

利用 AI 自动生成项目文档、API 文档等。

# 生成 README
picoclaw agent -m "为这个项目生成一个 README.md"

4. 定时任务

配置心跳任务，让 AI 定期执行检查或报告。

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

5. 多渠道部署

同时配置多个聊天渠道，实现跨平台 AI 助手。

{
  "channels": {
    "telegram": { "enabled": true },
    "discord": { "enabled": true },
    "qq": { "enabled": true }
  }
}

---

常见问题

1. 返回 "no API key configured"

检查配置文件中 api_key 是否正确填写。

2. 模型不支持

确保使用的模型名称正确，可尝试使用默认模型 gemini-2.0-flash。

3. 网络连接问题

如需代理，在对应 provider 配置中添加 proxy 字段。

---

相关链接

• PicoClaw 官方仓库
• Defapi 官网
• Google AI Studio
• OpenRouter