/install free-buddy-skills
Free Buddy Skills
自动检测和配置 opencode.ai 的免费 AI 模型到 WorkBuddy。
触发词
当用户说以下内容时,使用此技能:
- "帮我配置 opencode.ai 的免费模型"
- "配置免费模型"
- "添加 opencode 模型"
- "免费 AI 模型"
- "更新免费模型"
- "free model"
- "opencode.ai"
功能
- 查询免费模型: 从 opencode.ai 获取最新的免费模型列表
- 自动配置: 将免费模型添加到
~/.workbuddy/models.json - 定期更新: 保持模型配置的时效性
权限说明
- 无需 API Key: 使用公开的
"public"作为 API Key - 无需认证: opencode.ai 免费模型无需登录
- 仅本地操作: 只读取和写入本地的
~/.workbuddy/models.json
快速使用
用户只需发送一句话:
首次配置:
"帮我配置 opencode.ai 的免费模型"
WorkBuddy 会自动:
- 查询最新的免费模型列表
- 添加到
~/.workbuddy/models.json - 验证配置是否可用
更新模型:
"更新免费模型"
WorkBuddy 会自动:
- 查询最新的免费模型列表
- 对比现有配置
- 添加新模型,跳过已存在的
使用流程
方法 1: 使用 Python 脚本 (推荐)
# 所有平台通用 (macOS / Linux / Windows)
python3 update-free-models.py
# 或
python update-free-models.py
方法 2: 手动配置
步骤 1: 查询可用免费模型
curl -sS https://opencode.ai/zen/v1/models | jq '.data[].id' | grep -i free
步骤 2: 获取模型详细信息
curl -sS https://opencode.ai/zen/v1/models | jq '.data[] | select(.id | contains("free"))'
步骤 3: 读取现有配置
读取 ~/.workbuddy/models.json (macOS/Linux) 或 %USERPROFILE%\.workbuddy\models.json (Windows) 检查是否已存在相同模型。
步骤 4: 添加或更新模型配置
为每个免费模型添加以下配置:
{
"id": "模型ID",
"name": "模型显示名称",
"vendor": "OpenCode AI",
"url": "https://opencode.ai/zen/v1/chat/completions",
"apiKey": "使用 public (无需真实密钥)",
"maxInputTokens": 262144,
"supportsToolCall": true,
"supportsImages": false,
"supportsReasoning": true
}
步骤 5: 验证配置
使用 read_file 工具读取 ~/.workbuddy/models.json 确认配置已正确添加。
当前免费模型列表
| 模型 ID | 名称 | 工具调用 | 图像 | 推理 |
|---|---|---|---|---|
| minimax-m2.5-free | MiniMax M2.5 Free | ✅ | ❌ | ✅ |
| trinity-large-preview-free | Trinity Large Preview Free | ✅ | ✅ | ✅ |
| nemotron-3-super-free | Nemotron-3 Super Free | ✅ | ✅ | ✅ |
配置保存位置
- macOS/Linux:
~/.workbuddy/models.json - Windows:
%USERPROFILE%\.workbuddy\models.json(即C:\Users\你的用户名\.workbuddy\models.json) - 跨平台:
$HOME/.workbuddy/models.json(Git Bash/WSL 下通用)
注意事项
- opencode.ai 的免费模型使用
"public"作为 API Key - 所有免费模型共享同一个端点:
https://opencode.ai/zen/v1/chat/completions - 脚本需要用户确认后才会修改配置文件
- 非交互模式下运行将跳过自动添加,需手动确认
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install free-buddy-skills - After installation, invoke the skill by name or use
/free-buddy-skills - Provide required inputs per the skill's parameter spec and get structured output
What is Free Buddy Skills?
自动查询并配置 opencode.ai 免费 AI 模型到 WorkBuddy,无需 API Key,保持本地模型配置更新。 It is an AI Agent Skill for Claude Code / OpenClaw, with 165 downloads so far.
How do I install Free Buddy Skills?
Run "/install free-buddy-skills" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Free Buddy Skills free?
Yes, Free Buddy Skills is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Free Buddy Skills support?
Free Buddy Skills is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Free Buddy Skills?
It is built and maintained by pinke (@pinke); the current version is v2.3.0.