核心用法
OpenClaw AICFO Agent 是专为 OpenClaw 平台设计的企业级 API 桥接技能，通过单一 Bearer Token 即可访问 AICFO 企业财务数据平台的核心能力。
主要功能模块：
- 会话自举：
session端点自动解析密钥权限范围、隐式公司 ID 与可选公司列表 - 数据查询：支持
/api/company/query、/api/company/search结构化查询与实体检索 - 文件与文档：实体文件读取 (
get-file) 与文档列表访问 - 连接器操作：通过
/api/agent/connectors管理 Telegram、Google Drive 等第三方集成 - 本地桥接：
bin/openclaw-aicfo-adapter.mjs提供 REST-first 的 Node 运行时封装，无需预装 MCP SDK
典型工作流：
1. 运行 session 获取授权范围与公司作用域
2. 若有 implicitCompanyId 直接使用，否则要求显式传入 company_id
3. 按需调用 dashboard、query、get-entity 等业务操作
4. 连接器场景下使用 connector 子命令进行受限操作（如 telegram list_chats）
显著优点
- 零浏览器依赖：完全绕过
/api/connections/*浏览器路由，纯机器对机器集成 - 权限透明：
session端点清晰暴露documents.write、各连接器作用域等细粒度权限 - 自包含部署：仅依赖 Node.js，无需 npm 包或 MCP 运行时预装
- REST-first 设计：相比
/api/company/mcp更适合 OpenClaw 的 HTTP-native 架构 - 多租户安全：强制公司作用域校验，避免跨租户数据泄露
潜在缺点与局限性
- 写操作受限：若无
documents.write作用域，无法触发 Google Drive 导入或文档删除 - 连接器粒度限制：部分第三方集成仍依赖
/api/connectors/hub遗留路径（Slack/Jira 兼容层） - Node 运行时硬性要求：目标机器必须预装 Node.js，纯浏览器/边缘函数环境不可用
- 无实时推送：当前仅支持轮询式 API，无 Webhook 或流式数据订阅
- 作用域变更需轮换密钥：权限扩展需重新签发 API 密钥，无法动态扩权
适合人群
- OpenClaw 平台用户：需要将 AICFO 企业数据接入自有工作流的开发者
- 财务自动化场景：需批量查询公司实体、生成仪表板或自动化文档处理的团队
- 连接器集成需求：希望通过统一 API 管理 Telegram、Google Drive 等第三方通知与存储渠道的用户
- 合规敏感环境：要求完全脱离浏览器会话、实现审计友好的机器对机器认证的企业
常规风险
- 密钥泄露风险：Bearer Token 一旦泄露，攻击者可获取该密钥授权范围内的全部公司数据，需严格遵循最小权限原则
- 作用域绕过风险：实现方需严格校验
session返回的作用域列表，禁止客户端声明式权限 - 公司隔离失效风险：若未正确处理
requiresCompanySelection逻辑，可能导致跨公司数据访问 - 连接器操作边界风险：
telegram list_chats等受限操作用于验证，但生产环境需确保动作边界（如禁止未经确认的消息发送） - 本地桥接文件风险：
bin/openclaw-aicfo-adapter.mjs作为本地可执行文件，需校验完整性（建议校验 SHA256）以防供应链篡改