PicoClaw Claude API 接入教程

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

简介

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

• Defapi 平台 (推荐)：半价优惠，支持 Claude 全模型
• 官方 Anthropic API：直连官方服务
• OpenRouter：通过第三方路由访问
• Claude CLI：本地无需 API Key

方法一：Defapi (推荐)

Defapi 是一个 AI API 聚合平台，价格只有官方的半价，非常适合个人开发者和小型项目使用。

1. 获取 Defapi API Key

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

2. 配置 PicoClaw

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

{
  "agents": {
    "defaults": {
      "model": "anthropic/claude-sonnet-4-5-20250929"
    }
  },
  "providers": {
    "openrouter": {
      "api_key": "你的Defapi-Key",
      "api_base": "https://api.defapi.org"
    }
  }
}

3. 支持的 Claude 模型

4. Defapi 优势

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

---

方法二：官方 Anthropic API

1. 获取 API Key

1. 访问 Anthropic Console
2. 创建 API Key

2. 配置 PicoClaw

{
  "agents": {
    "defaults": {
      "model": "claude-sonnet-4-5-20250929"
    }
  },
  "providers": {
    "anthropic": {
      "api_key": "sk-ant-api03-xxx"
    }
  }
}

---

方法三：OpenRouter

1. 获取 API Key

访问 OpenRouter 获取 API Key。

2. 配置 PicoClaw

{
  "agents": {
    "defaults": {
      "model": "anthropic/claude-opus-4-6"
    }
  },
  "providers": {
    "openrouter": {
      "api_key": "sk-or-v1-xxx"
    }
  }
}

如需代理：

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

---

方法四：Claude CLI (本地)

如果你已安装 Claude Code CLI，可以使用本地 CLI 无需 API Key。

配置

{
  "agents": {
    "defaults": {
      "provider": "claude-cli",
      "model": "claude-sonnet-4-5-20250929"
    }
  }
}

---

验证 PicoClaw 是否正常工作

方法一：直接发消息测试

# 进入 PicoClaw 目录
cd picoclaw

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

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

方法二：启动 Gateway 测试

# 启动网关
picoclaw gateway

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

方法三：查看日志

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

---

常见问题

1. 返回 "no API key configured"

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

2. 模型不支持

确保使用的模型名称正确，可尝试使用默认模型 claude-sonnet-4-5-20250929。

3. 网络连接问题

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