核心用法
tool-connector 赋予 OpenClaw 代理直连企业工具的能力，支持 API Token（GitHub、Jira、Datadog 等）与 SSO 会话捕获（Slack、Outlook、Google Drive、Teams）两种认证模式。SSO 场景通过 Playwright 启动本地 Chromium 窗口完成登录，抓取短期会话令牌（Slack 约 8h、M365 约 1h），全程无云端中转、无 OAuth App 创建。
典型工作流
1. 已有工具：读取 references/setup.md → 进入对应 tool_connections/<tool>/ 目录 → 按 setup.md 配置 API Token 或执行 SSO 脚本
2. 全新工具：遵循 10xProductivity 方法论，通过 add-new-tool.md 完成：研究认证方式 → 识别 Base URL → 捕获凭据 → 验证连接 → 编写可复用配方
3. 凭据同步：运行 openclaw_sync.py --refresh-all 刷新 SSO 会话，自动注入 ~/.openclaw/openclaw.json
显著优点
- 零摩擦接入：无需 IT 审批、不创建 OAuth App、不经过第三方服务器
- 代理即用户：代理使用你的身份操作，审计轨迹与人工操作一致
- 本地安全闭环：API Token 与 SSO 会话均存储于本地
~/.openclaw/openclaw.json，技能目录内零残留 - 方法论可复制：10xProductivity 框架使任何新工具可在 10 分钟内完成接入
潜在局限与风险
| 维度 | 说明 |
|------|------|
| 会话时效 | SSO 令牌寿命短（1-24h），需定期刷新或自动化同步 |
| 浏览器依赖 | SSO 需本地 Chromium，无图形界面环境（如纯 SSH）无法执行 |
| 凭据管理 | 用户需自行保管 `openclaw.json`，丢失即需重新授权 |
| 企业合规 | 部分公司禁止个人 API Token 或浏览器自动化，需提前确认政策 |
适合人群
- 高级个人用户：希望代理代替自己操作工具，拒绝 SaaS 中间商
- 小团队技术负责人：需快速搭建内部工具链，无精力维护 OAuth 集成
- 隐私敏感型开发者：要求凭据不出本地、不留第三方日志
常规风险
- 脚本审查：
playwright_sso.py与openclaw_sync.py涉及浏览器自动化与文件系统写入，使用前务必人工审阅 - 令牌泄露：
openclaw.json包含高权限 Token，建议设置文件权限600并排除备份同步 - 误操作放大：代理获得与用户等同的权限，删除/修改类操作需额外确认机制