Runtime & 集成

Runtime & 集成 Integrations

CodeWhale 不仅是一个终端 Agent——它还是一个可通过多种协议和集成方式嵌入到你现有工作流中的本地控制平面。

信任边界

本地优先

Runtime API 默认仅监听 127.0.0.1，无托管中继，无云依赖。你的数据、你的模型、你的控制权。

认证必需

所有 Runtime API 路由（/v1/*）需要 Bearer Token。配置 CODEWHALE_RUNTIME_TOKEN 环境变量或 config.toml 中的 auth_token。

权限用户控制

工具审批、shell 授权、沙箱策略和网络访问均由用户控制，不可从远程绕过。

开放协议

CodeWhale 使用标准 HTTP/SSE、JSON-RPC 和 ACP，可与任何兼容客户端或平台集成。

集成方式

完整的本地 HTTP + Server-Sent Events Runtime API，监听 127.0.0.1:7878。创建线程、流式对话、管理后台任务、控制审批决策——任意 HTTP 客户端或内置手机页面皆可调用。

开放的 IETF 标准 Agent 通信协议。CodeWhale 原生支持 ACP，外部 Agent、工具和平台可以发现并互操作运行中的会话。

通过 MCP 服务器（stdio 或 HTTP/SSE）将 CodeWhale 连接到外部工具和服务。预配置的服务器包括文件系统、Git、SQLite 和常用 SaaS 平台。

开源 VS Code 扩展，将 CodeWhale 嵌入编辑器的侧边面板。在编辑器内利用完整工作区上下文运行 CodeWhale。

官方 Telegram 机器人桥接。启动无头 CodeWhale 会话，在任何 Telegram 客户端中与之对话——审批、工具结果和完成状态内联展示。

官方飞书 / Lark 机器人桥接。在飞书工作区内实现聊天原生 Agent 循环，支持审批卡片、会话关联和审计日志。

实验性微信桥接。在微信中接收 Agent 完成通知和审批；早期阶段，不建议用于生产环境。