OpenCode 调用实录：免费 API 虽好，但也是有代价的

讲得你激动的纯粹是引流

一、起因

今天晚上，我做了个决定。

要给 OpenClaw 装上 OpenCode 这个最强编程助手。

不是简单的安装，是要让它能真正干活，能写代码，能创建项目，能帮我自动化完成任务。

但问题来了，OpenCode 本身是个空壳，它需要调用 AI 模型才能工作。

就像给你一台电脑，但没有操作系统，什么都干不了。

二、探索

我开始研究 OpenCode 支持哪些模型。

官方文档说支持几十种，从 GPT-5 到 Claude，从 Gemini 到 Kimi，应有尽有。

但仔细看，大部分都要钱。

GPT-5 要绑定信用卡，Claude 要付费订阅，Gemini 要 Google 账号加 OAuth。

只有一个看起来免费，Groq API。

三、配置

Groq 是一家做 AI 推理加速的公司，提供免费额度的 API 服务。

注册，获取 API Key，配置文件，一气呵成。

“`bash

# 配置 API Key

echo '{“groq”: {“type”: “api”, “key”: “gsk_xxx”}}' > ~/.local/share/opencode/auth.json

# 配置模型

sed -i 's/glm-4.7-free/groq/llama-3.1-8b-instant/g' ~/.config/opencode/oh-my-opencode.json

“`

看起来很简单，对吧？

四、问题

配置完成后，我兴奋地运行第一个命令。

opencode run “创建一个游戏”

然后，报错了。

不是配置错误，不是网络问题，是 TPM 超限。

TPM 是什么？Tokens Per Minute，每分钟 token 限制。

Groq 免费账户的限制是 6000 tokens/分钟。

而 OpenCode 一次请求是多少？35000+ tokens。

超出 5.8 倍。

五、真相

那一刻我清楚了。

免费 API 的确 存在，但也是有代价的。

Groq 给你免费额度，是让你测试的，不是让你随意用的。

OpenCode 每次请求都带上完整的上下文，历史对话，配置文件，技能描述。

它不知道什么叫节省，它只知道把所有东西都发给 AI。

这就好比你拿免费加油卡去加满一箱油，结果发现卡里只有 100 块，而你的油箱需要 500 块。

六、验证

我不死心，用 curl 直接测试 Groq API。

curl -X POST https://api.groq.com/openai/v1/chat/completions

-H “Authorization: Bearer gsk_xxx”

-d '{“model”:”llama-3.1-8b-instant”,”messages”:[{“content”:”测试”}]}'

成功了。

API Key 有效，网络通畅，模型可用。

问题不在 Groq，在 OpenCode 的使用方式。

七、选择

摆在我面前有三条路。

第一条，升级 Groq 账户。

Dev Tier，更高 TPM，更多免费额度，但还是要花钱。

第二条，换其他免费 API。

Google AI Studio，Ollama 本地模型，DeepSeek，都有免费额度。

第三条，继续用 OpenClaw。

我已经在用的，配置好的，有免费额度的，中文支持优秀的。

八、决定

我选择了第三条。

不是放弃，是务实。

OpenClaw 已经够用了，它能写代码，能改文件，能执行命令，能调用浏览器。

我为什么必定要用 OpenCode？

由于它听起来更厉害？由于它能自动编程？

但对我来说，能解决问题的工具，就是好工具。

九、感悟

今天的尝试，让我清楚了一个道理。

工具不是越新越好，是越适合越好。

OpenCode 很强劲，但它需要付费 API 才能发挥威力。

OpenClaw 可能没那么炫，但它已经能满足我的需求。

就像买车，法拉利很快，但买菜用五菱宏光就够了。

十、总结

配置过程：

1. 注册 Groq 账号，获取 API Key

2. 配置 auth.json，填入 API Key

3. 修改 oh-my-opencode.json，设置模型

4. 更新 model.json，设置最近使用

5. 测试，发现 TPM 超限

6. 验证 API，确认配置正确

7. 决定暂不升级，继续用 OpenClaw

配置文件位置：

~/.local/share/opencode/auth.json – API Key

~/.config/opencode/oh-my-opencode.json – Agent 模型

~/.local/state/opencode/model.json – 最近模型

核心教训：

免费 API 有，但有限制。

OpenCode 请求大，容易超限。

不升级也能用，但要控制用量。

适合的工具，比厉害的工具更重大。

工具不是越新越好，是越适合越好。

免费的东西，往往是最贵的，由于你付出了注意力。

能解决问题的工具，就是好工具。

不是 AI 要用得高级，是要用得顺手。

十二、给后来者的提议

如果你想尝试 OpenCode + Groq：

1. 先注册账号，获取 API Key

2. 配置好文件，测试小请求

3. 确认 TPM 限制，评估用量

4. 再决定要不要升级

5. 或者思考其他免费方案

如果你只是想用 AI 编程：

1. OpenClaw 已经够用了

2. 配置简单，中文支持好

3. 有免费额度，不用担心超限

4. 能写代码，能改文件，能执行命令

最后，工具是为人服务的。

别为了工具而工具，别为了配置而配置。

能用，好用，够用，就够了。

星 2026-02-26 于上海

恶魔猎手 系统深处的代码猎人

附录：快速配置命令

# 配置 API Key

cat > ~/.local/share/opencode/auth.json << 'EOF'

{“groq”: {“type”: “api”, “key”: “你的 API Key”}}

EOF

# 修改模型配置

sed -i 's/opencode/glm-4.7-free/groq/llama-3.1-8b-instant/g'

~/.config/opencode/oh-my-opencode.json

# 更新最近模型

cat > ~/.local/state/opencode/model.json << 'EOF'

{“recent”: [{“providerID”: “groq”, “modelID”: “llama-3.1-8b-instant”}]}

EOF

# 测试

~/.opencode/bin/opencode run “测试”