第5章 Runtime & 集成 · Codewhale

Runtime & 集成运行时与集成Codewhale 不仅是一个终端 Agent——它还是一个可通过多种协议和集成方式嵌入到你现有工作流中的本地控制平面。集成方式HTTP / SSE Runtime API完整的本地 HTTP + Server-Sent Events Runtime API，监听 127.0.0.1:7878。创建线程、流式对话、管理后台任务、控制审批决策——任意 HTTP 客户端或内置手机页面皆可调用。ACP (Agent Client Protocol)面向 Zed 等兼容编辑器客户端的基础 JSON-RPC stdio 适配器。它支持初始化、新建会话、提示和取消，并返回文本响应；shell 与文件工具、检查点回放和会话加载仍由完整 Runtime API 提供。MCP (Model Context Protocol)通过已配置的 MCP 服务器（stdio 或 HTTP/SSE）将 Codewhale 连接到外部工具和服务，或把 Codewhale 自身工具暴露给其他 MCP 客户端。VS Code Extension本地 Runtime 的早期配套扩展。它可以在终端中打开 Codewhale、启动并检查 Runtime API，以及显示只读线程摘要和还原点；目前尚不提供完整聊天、内联编辑或编辑器操作。Telegram Bridge官方 Telegram 机器人桥接。启动无头 Codewhale 会话，在任何 Telegram 客户端中与之对话——审批、工具结果和完成状态内联展示。Feishu / Lark Bridge官方飞书 / Lark 机器人桥接。在飞书工作区内实现聊天原生 Agent 循环，支持审批卡片、会话关联和审计日志。Weixin Bridge实验性微信桥接。在微信中接收 Agent 完成通知和审批；早期阶段，不建议用于生产环境。实验性信任边界本机运行Runtime API 默认仅监听 127.0.0.1。本地运行时不需要 Codewhale 账户或托管中继。认证必需Runtime API 路由（/v1/*）需要 Bearer Token。启动时传入 --auth-token，或设置 CODEWHALE_RUNTIME_TOKEN 环境变量。仅在回环地址上可用 --insecure-no-auth 关闭认证。权限用户控制远程客户端通过经过认证的 Runtime API 提交请求与审批决定。本地模式、权限姿态和沙箱策略仍然生效。开放协议HTTP/SSE Runtime API、MCP 和基础 ACP stdio 适配器分别服务于不同集成场景；请根据客户端需要选择对应接口。运行时事实版本0.10.0工具数量80沙箱后端seatbelt (macOS, when available) · bubblewrap (Linux, opt-in when installed)详情Crates27 · agent, app-server, build-support, cli, cloud-facts, command-contract, config, core, execpolicy, hooks, lane, localization, mcp, memory, models, palette, paths, protocol, release, runtime, secrets, state, telemetry, tools, tui, workflow, workflow-js源码版本24a7b99a73c186e70dfb8341b046d638f28d4cbb详细实现文档：Runtime API 与 ACP stdio 适配器MCP 集成