把 Octer 模型 接进你的 Agent 与代码

下面所有用法——Agent、生图、生视频、直接调接口——共用同一把 Key。

• 打开 Octer 控制台：octer.ai/workspace/o/ →（没有账号就先注册一个）
• 在 OClaw 页面点击复制，得到一把 sk- 开头的密钥。

🎁 新用户注册 / 登录即送试用积分——拿到 Key 就能直接免费试跑，跑通了再考虑充值。去注册领积分 →

先花一秒确认这把 Key 可用（选一下你的系统再复制，返回一段 JSON 就说明 Key 和网络都没问题）：

下文所有命令里的 sk-你的KEY 都要换成你自己的密钥。

命令没返回 JSON，或报 401 / 403？「常见问题 →」里有对应的解决办法。

OpenClaw 和 Hermes 都是免费开源的「本地 AI 助手」——装在你自己电脑上、在终端里对话的那种。还没装也不要紧，跟着下面第 1 步从零装好即可。

先选你在用的 Agent 和系统，下面的命令会自动切换成对应的那一条。

第 1 步 · 安装客户端

装好后确认命令行可用：

第 2 步 · 一键切到 Octer 模型

脚本会写好接口地址、API Key 和模型，然后重启网关并自测一句「你好」——看到模型正常回复就配好了。

第 3 步 · 验证

下面两条依次执行：

不想用了：一键还原

下面这条命令会清掉 Octer 的模型配置，保留你原有的其它设置。

上一步只解决了「对话」。想让 Agent 还能生图、生视频，装一个 oclaw 技能包——它把图片、视频、对话三类能力包成一个命令行工具，生成的文件自动存到本地。

最简单的装法：在 OpenClaw / Hermes 的对话框里发送这句话，Agent 会自己装好。

还没装 OpenClaw / Hermes？看「接入你的 Agent →」一节，两条命令装好；不想装 Agent，就直接用下面的终端方式。

把 sk-你的KEY 换成自己的密钥。装完直接用大白话说「生成一张…的图」「做一个…的视频」，Agent 会自动调用它。

也可以自己在终端里用（零依赖，只要有 Python 3）：

Windows 用户：这个工具是 bash 脚本，请在 WSL 或 Git Bash 里运行（PowerShell 直接跑不了）。

• 生成的图片保存在 images/，视频保存在 videos/。
• 视频是异步的：提交后一般 1–3 分钟出片，工具会自动等待并下载。等超时了也不要紧——任务还在服务器上跑，用 ./oclaw.sh status 找到任务号，再 ./oclaw.sh watch <task-id> 接着等。
• 视频链接约 24 小时过期，所以要在生成完成时立刻下载（工具已经替你做了；自己调接口的话别只存链接）。

不想装 Agent、要把 Octer 接进自己的程序，直接调 HTTP 接口即可。网关兼容 OpenAI 协议，现成的官方 SDK 换个 base_url 就能用。

调接口或配置 Agent 时要填的是 model id——就是表格里带底色的那一串，点旁边的按钮一键复制。

同类模型换着用只需要改 model id：对话与推理共用一个接口，生图、生视频各有自己的接口（上一节的代码块会跟着你选的模型自动切换）。

任何支持 OpenAI 协议的客户端，填入下面四项即可接上 Octer。

你选的路线之外，另外两种用法收在这里——同一把 Key 都能用，需要时点开即可。

关于数据：你的提示词和参考图会发送到 Octer 网关用于生成；API Key 只出现在请求头里，不落盘；生成的图片和视频只保存在你自己的机器上。