核心用法
bitbucket-repos 技能通过 ClawLink 托管服务,为 OpenClaw 用户提供与 Bitbucket Cloud 的无缝集成。用户只需安装 ClawLink 插件、完成 OAuth 授权,即可在聊天环境中执行完整的仓库操作,无需手动管理 API Token 或了解 Bitbucket REST API 细节。
该技能覆盖五大核心场景:
- 仓库管理:浏览、创建、删除仓库,查看文件内容与目录结构
- 分支操作:列出、创建分支,获取分支模型配置
- 代码审查:查看 PR 详情、差异、提交历史,执行批准、合并、评论操作
- 问题跟踪:创建、更新、删除 Issue 及评论
- CI/CD 集成:查询 Pipeline 运行状态与部署历史
所有操作均通过 clawlink_call_tool 等统一接口调用,支持 BBQL 查询语言和分页机制,便于处理大规模仓库数据。
显著优点
1. 零配置 OAuth:ClawLink 托管认证流程,自动注入 Token,消除密钥泄露风险
2. 权限隔离:读写操作明确分离,所有写入需用户显式确认
3. 完整工作流:从代码浏览到 PR 合并的全链路支持,减少上下文切换
4. 企业就绪:支持 Workspace 成员管理、项目组织和部署环境查询
潜在局限
- 依赖 ClawLink 服务:认证与代理依赖第三方托管,存在单点故障风险
- 仅支持 Cloud 版:不兼容 Bitbucket Server/Data Center 私有化部署
- 无本地 Git 操作:无法执行
git clone、git push等本地命令,仅能通过 API 操作 - Rate Limit 受限:受 Bitbucket Cloud API 配额限制,大规模仓库可能触发限流
适合人群
- 使用 Bitbucket Cloud 的中小团队开发者
- 需要在聊天环境中快速审查代码、批准 PR 的技术负责人
- 追求低配置、高安全性的 DevOps 工程师
常规风险
- 误操作删除:仓库/分支/PR 删除为不可逆操作,需严格遵循确认流程
- Token 权限范围:OAuth 授权范围等于用户账户权限,过度授权可能导致数据泄露
- 代理层延迟:ClawLink 中转可能引入额外网络延迟,影响实时性要求高的场景
- 服务可用性:ClawLink 或 Bitbucket 服务中断时将完全不可用
建议生产环境使用前,在测试 Workspace 验证工具行为,并定期审计连接状态。