什么是AICFO Agent Access
AICFO Agent Access 是一个专为 OpenClaw 设计的技能工具，用于通过单个 Bearer API 密钥安全地连接 AICFO 平台。该工具避免了依赖浏览器专属路由或租户本地守护进程，提供了一套标准化的 RESTful 接口来管理代理会话、企业资源和应用级 MCP（Model Context Protocol）服务。其核心设计目标是简化集成流程，确保在无前端交互的环境下也能稳定运行各类业务操作。 该工具主要围绕几个关键端点构建：`/api/agent/session` 用于身份验证与会话初始化；`/api/agent/companies` 和 `/api/company/query` 支持企业范围的选择与查询；`/api/agent/dashboard` 提供企业级数据概览；而 `GET|POST /api/agent/connectors` 则负责机器连接器（如 Telegram、Google Drive 等）的管理与调用。此外，还包括文档检索 (`/api/documents`) 和实体/文件获取 (`/api/company/entity`, `/api/company/file`) 等功能模块，覆盖从数据读取到外部系统集成的完整工作流。 整个系统强调自包含性和可移植性——官方发布的适配器脚本 `bin/openclaw-aicfo-adapter.mjs` 不依赖 npm 包或预装 SDK，仅需在具备 Node.js 环境的机器上即可独立运行。这使其特别适用于自动化脚本、CI/CD 管道或远程服务器部署场景，无需额外配置复杂的开发环境。
核心功能特点
- 通过单一 Bearer 令牌实现安全的 AICFO 平台接入，无需浏览器或本地服务介入
- 支持代理会话初始化、企业选择与应用级 MCP 服务的统一访问控制
- 提供 RESTful API 接口用于连接器管理（如 Telegram、Google Drive），避免使用遗留 Slack/Jira 兼容路径
- 内置权限校验机制，根据 API 密钥的授权范围限制操作类型（如禁止无写入权限时触发文档删除）
- 完全自包含的 Node.js 脚本，可在仅有基础运行时环境的设备上直接执行
适用场景
AICFO Agent Access 最典型的应用场景是构建自动化数据流水线。例如，在金融合规审计中，企业可通过该工具定期拉取指定公司的交易记录（利用 `/api/company/query`）并同步至内部数据库，全程无需人工登录 AICFO 网页界面。另一个常见用例是跨系统集成：当 OpenClaw 需要向客户发送通知时，可借助 `telegram list_chats` 命令自动识别目标聊天群组，再结合消息推送能力完成精准触达，整个过程由后端服务静默处理，保障用户体验的一致性与安全性。 对于需要频繁调用外部存储系统的场景，如将合同扫描件从 Google Drive 批量导入 AICFO 文档库，该工具提供了清晰的边界控制——只有在 API 密钥明确授予 `documents.write` 权限时才允许执行上传动作，有效防止越权操作。同时，由于所有通信均基于标准 HTTP 协议而非 WebSocket 或浏览器特定技术栈，它天然适配容器化部署（如 Docker/Kubernetes），便于在云原生架构中扩展和管理多个实例。 此外，在开发调试阶段，工程师可通过命令行快速验证权限配置是否正确：先运行 `session` 检查当前令牌的有效作用域，再用 `tools` 列出可用功能集，最后通过一次真实的 `dashboard` 或 `query` 请求确认实际数据可达性。这种轻量级验证方式大幅降低了集成风险，特别适合多租户 SaaS 平台中动态分配不同客户访问权限的场景。