多智能体调用器 superalsrk/omni-agent-invoke-py

Omni Agent Invoke Python：Codex、Claude Code、OpenClaw 与 DeepSeek Harness

在 Python 里调用 Codex、Claude Code（CC）、OpenClaw、DeepSeek Harness（DSH）以及其他受支持的智能体 harness。由 Octo Runtime 驱动。

一个小巧、独立的 Python 客户端，也是可运行的 playboard，对接单独安装的 Octo Runtime Kernel。提供一套本地执行 API，支持流式输出、显式上下文、原生输出、取消和并发 harness 调用。

Octo Runtime 是基础

Octo Runtime 把一组智能体 harness 变成可复用的本地基础设施。 它受监管的 Kernel、执行 worker 和 Provider 适配器为应用提供统一的执行契约，同时让 Provider 特有的能力依然可用。

这正是这个库的价值所在：你的 Python 应用可以只对接一个服务边界，就能使用多个成熟的 harness。规范事件提供统一格式；原生载荷保留 Provider 特有的细节。你的应用负责自己的业务数据和用户体验，Octo Runtime 提供执行基础。

去了解并给 Octo Runtime 点个 star，读一读它的文档，看看它的适配器生态。

独立服务，独立客户端

Python application / playboard
| JSON-RPC 2.0 + NDJSON over a Unix socket
v
Independently installed Octo Runtime Kernel
v
Codex / Claude Code / OpenClaw / DeepSeek Harness / ...

这个库不依赖上游 Runtime 源码或 SDK 包。它实现公开的 Kernel IPC，并自带生成的协议身份声明。它不启动 Runtime，也不安装或认证 Provider。独立的 Runtime 服务需要 Node.js；Python 客户端使用自己的语言工具链。

这是一个独立的社区项目，不是 Octo Runtime 官方 SDK。0.1 版本面向 macOS/Linux 的 Unix socket。

安装与运行

要求：Python 3.11+ 和 uv，另外需要单独安装的 Runtime 和一个已认证的 Provider。

Install and start the foundation service independently.
npm install -g @mininglamp-oss/octo-runtime
octo-runtime executor-kernel start

git clone https://github.com/superalsrk/omni-agent-invoke-py.git
cd omni-agent-invoke-py
mkdir -p .tmp
uv sync --python 3.11

Use your actual endpoint for custom Runtime Homes/profiles.
export OCTO_KERNEL_ENDPOINT="$HOME/.octo-runtime/sockets/octo-runtime-executor-kernel.sock"
uv run playboard status
uv run playboard list
uv run playboard playboard --adapter codex --mode canonical \
--prompt 'Reply with OK without using tools.' --receipt .tmp/first-run.json
已经在运行 Kernel？跳过安装和启动，让客户端直接连上它现有的 socket。每个服务商要单独认证；Runtime 不会替你登录。

Python API

import asyncio
import os
from omni_agent_invoke import Client

async def main():
async with Client(os.environ["OCTO_KERNEL_ENDPOINT"]) as client:
async for frame in client.invoke("codex", "Say hello."):
print(frame)

asyncio.run(main())

完整可运行的程序见 examples，包含 import 和终态检查。

四个入口把上下文和模式讲清楚：

client.invoke("codex", prompt)
client.invoke_with_context("codex", prompt, context)
client.invoke_native("codex", prompt)
client.invoke_native_with_context("codex", prompt, context)

前两个选 canonical 模式，带 native 的变体选 native 模式。它们都产出完整的 HostFrame：canonical 内容在 frame.event，native 内容在 frame.payload，执行的终态在 frame.control。把一次执行当作成功之前，务必先消费并检查终态。

上下文指 Octo 的执行/后台信封。显式条目会与选中的 Adapter 以及默认的 ask 审批策略合并。类型化 Context、纯文本 Input 和图片 Input 的示例见 examples/README.md。图片辅助工具提供 base64、字节长度和 SHA-256 元数据。

DeepSeek Harness 与其他服务商

DeepSeek Harness（DSH） 用 Adapter ID dsh：

uv run playboard playboard --adapter dsh --mode canonical --prompt 'Reply with OK.'
uv run playboard playboard --adapter claude-code --mode canonical --prompt 'Reply with OK.'
uv run playboard playboard --request examples/openclaw-request.json

DSH 必须先安装、配置，并由独立运行的 Runtime 注册。见上游 DSH Adapter 指南。只有选中的 Adapter 声明支持时，才能用 native 模式。OpenClaw 用一个 Context 条目选中已有的 Gateway Agent，例如 provider_agent_id: "main"。

共用一套执行 API，不代表各服务商能力相同。查 list 和上游指南。对 Codex 做过实机验证，不等于每个服务商都测过。

并发调用 Harness

uv run python examples/multi_harness.py codex claude-code openclaw dsh

本地只有 Codex？把 Adapter 参数换成 codex codex，就能跑两个独立的并发调用。示例会等待所有任务，并逐个报告失败。

Playboard 与显式控制

uv run playboard playboard --adapter codex --mode native --prompt 'Say hello.' --context examples/context.json
uv run playboard submit --adapter codex --prompt 'Say hello.' --receipt .tmp/submitted-run.jsonsh
uv run playboard get --ref .tmp/submitted-run.json
uv run playboard subscribe --ref .tmp/submitted-run.json --after 0
uv run playboard cancel --ref .tmp/submitted-run.json --reason user_cancelled
uv run playboard respond --ref .tmp/submitted-run.json --response answer.json
uv run playboard native-respond --ref .tmp/submitted-run.json --response native-answer.json

stdout 输出 NDJSON。保存完整 RunRef 以便恢复。回执写入新文件，不会覆盖。--timeout 是执行截止时间，单位为秒；playboard 会请求取消，并观察一小段收尾过程。关闭观察或关闭客户端，都不会停止 Kernel，也不会自动取消已接受的运行。

丢失的接受 ACK 只能靠查询原始身份恢复。结果未知时，控制操作绝不自动重放。身份校验、分帧、恢复与生命周期限制见协议设计。

本地验证 sh
uv run python -m unittest discover -s tests -v
uv build
node scripts/live-smoke.mjs

显式 live smoke 使用已有的 Kernel 和已认证的 Codex，验证规范调用与原生调用、回执查询和重放。它不安装 Runtime，也不停止 Runtime。证据记录在 docs/live-smoke.json 下，不含服务商原始输出。不添加 GitHub workflows 或 CI 门禁。平台限制与 live 服务商限制记录在验证中。

生态与许可

Octo Runtime 是独立的基础服务。其他客户端库：Rust、TypeScript、Python、Go。

MIT License。协议类型独立生成，未内嵌任何上游实现。各项目与服务商厂商相互独立，不构成任何背书。