openocta

环境要求

• Windows 或 macOS 桌面系统（Windows amd64；macOS 分 Apple Silicon 与 Intel 版本）
• 能访问官网 https://openocta.com 下载安装包
• 准备一个大模型 API Key（README 以 Moonshot 为例）
• 对配置目录有写入权限：macOS 为 ~/.openocta，Windows 为 %APPDATA%\openocta

安装与启动步骤

1. 1下载安装包

   打开官网下载页，按平台选择：Windows 用 OpenOcta-amd64-installer.exe，macOS 用 OpenOcta-arm64.dmg 或 OpenOcta-amd64.dmg。

2. 2安装客户端

   Windows 双击运行 installer.exe 按提示安装；macOS 打开 .dmg 把应用拖入 Applications。

3. 3UI 方式配置模型

   推荐方式：打开客户端 Models 标签，或跟随首次运行的 setup wizard，填入 API Key 并选择模型。

4. 4改配置文件配置模型

   也可直接编辑配置文件，填入 env.vars 的 API Key 与 agents.defaults.model.primary 模型名。

   {
     "env": {
       "vars": {
         "MOONSHOT_API_KEY": "sk-xxxxxxxx"
       }
     },
     "agents": {
       "defaults": {
         "model": { "primary": "moonshot-cn/kimi-k2.5" }
       }
     }
   }

   复制

5. 5重启并验证

   保存后重启客户端，在 Messages 标签用自然语言下发任务，能正常得到模型回复即接入成功。

关键配置

如何确认成功

重启客户端后，在 Messages 中输入自然语言任务（如生成巡检清单），模型能正常返回结果即配置成功。

常见问题

注意事项

• 安装包只从官网下载页获取，macOS 注意区分 Apple Silicon（arm64）与 Intel（amd64）版本。
• 客户端必须先接入大模型才能对话，首次启动用向导或配置文件任一方式完成即可。
• 它是桌面客户端，装在 Windows / macOS 上，但可对应用、服务器、网络、数据库、云端做全栈运维。
• 修改配置文件后必须重启客户端才会生效。