【Linux/Ubuntu】OpenCode +Oh My OpenAgent安装配置实践

安装OpenCode

安装：用阿里云的npn源进行加速:
sudo npm install -g opencode-ai@latest --registry=https://registry.npmmirror.com
检查
opencode --version 能输出版本号

安装Oh My OpenAgent

官网链接：ohmyopenagent

说明：
Oh My OpenAgent 原名Oh My OpenCode 简称OmO，且两者完全兼容。详细说明见feat: rename oh-my-opencode to oh-my-openagent

先安装bun工具

sudo npm install -g bun --registry=https://registry.npmmirror.com

再安装Oh My OpenAgent

bunx oh-my-openagent install

下面这些配置，如果你没有相关套餐订阅的话，可以先不填，后面订阅之后通过修改配置文件配置上去即可。

shell 复制代码

➜  ~ bunx oh-my-openagent install
┌   oMoMoMoMo...
│
◇  OpenCode 1.3.4 [OK]
│
◇  Do you have a Claude Pro/Max subscription?
│  No
│
◇  Do you have an OpenAI/ChatGPT Plus subscription?
│  No
│
◇  Will you integrate Google Gemini?
│  No
│
◇  Do you have a GitHub Copilot subscription?
│  No
│
◇  Do you have access to OpenCode Zen (opencode/ models)?
│  No
│
◇  Do you have a Z.ai Coding Plan subscription?

验证安装结果

在命令行输入OpenCode，能看到如下界面说明OmO(Oh My OpenAgent的简称）安装成功。首次启动速度会稍微慢一点。

配置Oh My OpenAgent

配置模型

如果你已经有相关大模型套餐的订阅，参考[配置API Key](#配置API Key) 章节。

如果你想先免费尝试下，参考配置免费模型章节

配置免费模型

启动OpenCode之后，输入/models，上下翻找一下，可以看到有三个免费模型可用，选中随便一个，回车。
输入hi可以看到OpenCode有响应，就可以正常使用了。免费模型token数量有限，且用且珍惜。

配置API Key

这里以配置智谱的API Key为例

首先给OpenCode配置API key。
- 启动OpenCode之后，输入/connect，就会有一大堆可选的供应商，输入z.进行搜索，可以看到有两个可选。Z.AI Coding Plan是智谱的编码套餐GLM Coding Plan。另外一个Z.AI是其他的资源包啥的，我这里是买的资源包，所以就选Z.AI。回车
- 然后输入API Key，选择模型就可以了。
然后给OmO配置模型
- 首先打开OmO配置文件：
  shell 复制代码
```
.opencode/oh-my-opencode.json （项目级）
~/.config/opencode/oh-my-opencode.json （用户级）
```
- 将里面的所有model字段替换为你的供应商/模型，
/exit退出OpenCode，重新进入，就能看到默认模型变成了之前配置的模型。

配置skill

如果你只把skill放在~/.config/opencode/skills目录下，OmO(Oh My OpenAgent的简称）是不会自动加载这个skill的。还需要如下配置：

json 复制代码

  "skills": {
    "sources": [
      {
        "path": "~/.config/opencode/skills",
        "recursive": true
      }
    ],
    "enable": [
      "imf-builder",
      "cpp-core-guidelines-review",
      "openharmony-security-review",
      "ai-generated-business-code-review"
    ]
  }

选项	默认值	描述
path	-	路径或远程 URL
recursive	false	递归进入子目录
enable	-	使能的skill列表

配置的详细解释参考skills-configuration。

可用的OpenHarmony skill: openharmony-skills

使用Oh My OpenAgent

深度初始化
项目目录下首次启动OpenCode之后，执行/init-deep 会探索整个工程，并生成分层的AGENTS.md文件。后续Agent在执行任务时会通过读取这些文件来快速了解业务知识。

json 复制代码

project/
├── AGENTS.md              ← project-wide context
├── src/
│   ├── AGENTS.md          ← src-specific context
│   └── components/
│       └── AGENTS.md      ← component-specific context

设计师（Prometheus）
- /start-work 会调用"Prometheus"智能体。它首先会去理解你的诉求，然后会像真正的工程师那样与您进行交流（交互式确认更多信息） ，明确项目范围和潜在的模糊之处，制定一个经过验证的计划后再开始编写代码。
- 总结下，Prometheus的工作包含：
  - 理解你的诉求。
  - 交互式确认需求范围。
  - 设计并验证方案是否正确。
  - 生成工作计划（todo list）。
- 设计师会生成一个工作计划，一般在.sisyphus/plans/目录下，

参考文档

github代码仓 oh-my-openagent

介绍了各个子智能体的特点：features.md