Skip to main content
n8n 有三种互补的 BeeOS 接入方式：

​
BeeOS 社区节点

独立仓库中的 n8n-nodes-beeos 包提供：
  • 一个 BeeOS 操作节点，覆盖实例与 Agent 发现、持久任务、实例生命周期、文件解析、 计算机操作和移动设备控制；
  • 一个轮询触发器，用于发现新建或已关闭的 BeeOS 任务；
  • 一个带连接测试的加密 BeeOS API Credential。
n8n-nodes-beeos 0.1.0 正在准备发布，目前尚未出现在 npm 或 n8n Community Nodes 目录。下方安装流程将在首个版本发布后生效。
在自托管 n8n 中打开 Settings → Community Nodes，安装 n8n-nodes-beeos，再创建 BeeOS API Credential：API URL 使用 https://openapi.beeos.ai，API Key 使用 BeeOS 用户密钥。BeeOS 操作节点既可用于 确定性工作流，也可挂到 n8n AI Agent 上作为工具。 销毁实例需要单独确认。购买、对外发送消息、修改账号等外部副作用应保留明确的人工 审批节点。计算机或移动设备操作超时后不要自动重试，因为动作可能已经执行。

​
MCP Client Tool

  1. 添加 AI Agent 节点。
  2. 连接 MCP Client Tool 节点。
  3. Streamable HTTP URL 填写 https://mcp.beeos.ai/<agentId>/mcp。
  4. 在 n8n Credentials 中配置 Authorization: Bearer <oag_key>，不要直接写进工作流 JSON。
  5. 发现工具后先测试低风险请求。
当模型应自主选择工具时使用 MCP。它不是持久队列；工作流需要跨长时间断线恢复时应使用 OpenAPI task。

​
持久 OpenAPI 工作流

典型生产工作流：
配置一个 HTTP Header Auth Credential：
Base URL 使用 https://openapi.beeos.ai。用 n8n execution ID 生成幂等键，避免重试重复执行手机动作。轮询必须有硬上限；工作流停止时调用 task cancel endpoint。
高并发工作流优先使用 BeeOS task webhook，而不是高频轮询。恢复工作流前必须验证 webhook 签名。
建议让 n8n 负责输入校验和人工审批，再通过 OpenAPI 创建一个 BeeOS task。只有在明确需要对话式自动化时，才让 AI Agent 通过 MCP 自主选择手机操作。 参见调用 Agent、任务生命周期和 Webhook。