简要总结
OpenCode Zen
这页说明书在讲一个叫“OpenCode Zen”的特别工具箱。它就像老师给你准备的一盒最好用的彩色笔，里面都是OpenCode团队觉得最适合用来帮助电脑写代码的“聪明大脑”（我们叫它们模型）。你如果想用这些特别的“聪明大脑”，就需要照着这页说的做：先拿到一把叫“API密钥”的魔法钥匙，然后告诉你的电脑工具怎么用这把钥匙。
这页适合在你已经准备好要用OpenCode的工具，并且想试试他们推荐的最好用的“聪明大脑”时看。
五岁小孩版解释
OpenCode Zen 是 OpenCode 团队为你精心挑选的一些“聪明大脑”（模型）的集合。你可以把它想成一个“推荐工具箱”，里面的工具都是他们觉得最适合用来创建能写代码的智能助手（编码代理）的。这个工具箱目前还在测试阶段，就像新玩具的试用版一样。
要使用这个工具箱，你需要一把“魔法钥匙”，它叫做 API 密钥。这把钥匙能帮你打开通往这些“聪明大脑”的大门。你得先去 OpenCode Zen 的网站，登录你的账号，设置好付款方式（就像在游乐场买票），然后才能复制拿到你这把独一无二的钥匙。
第一步：给你的电脑工具装上钥匙
你要告诉你的电脑工具（openclaw）怎么使用这把钥匙。有两种方法：
- 像聊天一样告诉它：打开一个叫“终端”或“命令提示符”的黑色窗口，输入
openclaw onboard --auth-choice opencode-zen，然后按回车。它会像朋友一样问你问题，你跟着回答就行。 - 直接给它钥匙：如果你不想聊天，也可以直接把钥匙给它。在同一个黑色窗口里，输入
openclaw onboard --opencode-zen-api-key “你的魔法钥匙”。记得把“你的魔法钥匙”换成你真正从网站上复制来的那串字母和数字。
第二步：告诉你的智能助手用哪个“聪明大脑” 拿到钥匙后，你还需要告诉你的智能助手，你想用工具箱里的哪个“聪明大脑”来工作。你需要在一个叫“配置文件”的小本子上写下来。打开这个文件，在里面加上这样几句话：
{
env: { OPENCODE_API_KEY: “sk-...” },
agents: { defaults: { model: { primary: “opencode/claude-opus-4-6” } } },
}
- 第一行
env: { OPENCODE_API_KEY: “sk-...” }的意思是：“请把我的魔法钥匙（OPENCODE_API_KEY）保管在这里。” 你要把“sk-...”换成你真正的钥匙。 - 第二行
agents: ... primary: “opencode/claude-opus-4-6”的意思是：“我默认的智能助手，请使用一个叫opencode/claude-opus-4-6的聪明大脑来思考。” 这是工具箱里推荐的一个大脑，你也可以试试别的。
需要注意的事情：
- 这把魔法钥匙有两个名字都可以用：
OPENCODE_API_KEY或者OPENCODE_ZEN_API_KEY。就像你的小名和大名，叫哪个都行。 - 使用这个工具箱是需要付一点点钱的，就像用游乐场里的设施要投游戏币。每当你向“聪明大脑”提一个问题（请求），就会用掉一点。具体用了多少，你可以去 OpenCode 网站上的“仪表盘”（Dashboard）查看，就像看你的游戏币还剩多少一样。