Confluence

Confluence Cloud

通过 mx_confluence 工具管理 Confluence 工作区：空间浏览、页面 CRUD、标签管理、评论、子页面导航、CQL 搜索。

前置条件 安装插件: OpenClaw 插件s 安装 OpenClaw-morphixAI 获取 API Key: 访问 morphix.应用/API-keys 生成 mk_xxxxxx 密钥 配置环境变量: 导出 MORPHIXAI_API_KEY="mk_your_key_here" 链接账号: 访问 morphix.应用/connections 链接 Confluence 账号，或通过 mx_link 工具链接（应用: confluence） 核心操作 列出空间 mx_confluence: action: 列出_spaces limit: 10 type: "global"

type 可选值：global（团队空间）、personal（个人空间）

获取空间详情 mx_confluence: action: 获取_space space_id: "163843"

列出页面 mx_confluence: action: 列出_pages space_id: "163843" limit: 20 排序: "-modified-date"

省略 space_id 列出所有空间的页面。

获取页面详情 mx_confluence: action: 获取_page page_id: "163923" body_格式化: "storage"

body_格式化 可选值：storage（HTML）、atlas_doc_格式化（ADF）、view（渲染后 HTML）

创建页面 mx_confluence: action: 创建_page space_id: "163843" title: "会议纪要 2026-02-25" body: "

议题

1. 项目进度回顾

2. 下周计划

body 使用 Confluence Storage 格式化（HTML 子集）。parent_id 可选，省略则创建为顶级页面。

更新页面 mx_confluence: action: 更新_page page_id: "163923" title: "更新后的标题" body: "

更新后的内容

必须提供 version（当前版本号 + 1），否则更新失败。先用 获取_page 获取当前版本号。

删除页面 mx_confluence: action: 删除_page page_id: "163923"

获取子页面 mx_confluence: action: 获取_child_pages page_id: "163923" limit: 20 排序: "-modified-date"

获取页面标签 mx_confluence: action: 获取_page_labels page_id: "163923"

添加标签 mx_confluence: action: 添加_page_label page_id: "163923" label: "导入ant"

删除标签 mx_confluence: action: 删除_page_label page_id: "163923" label_id: "12345"

先用 获取_page_labels 获取 label ID。

获取页面评论 mx_confluence: action: 获取_page_comments page_id: "163923" body_格式化: "storage" limit: 10

添加评论 mx_confluence: action: 添加_page_comment page_id: "163923" body: "

这是一条评论

CQL 搜索 mx_confluence: action: 搜索 cql: "type=page AND space.key=SOP AND title~\"API\"" limit: 10

CQL 常用语法：

type=page / type=b记录post — 内容类型 space.key=XX — 指定空间 title~"关键词" — 标题模糊搜索 text~"关键词" — 全文搜索 创建器=currentUser() — 当前用户创建的 lastModified >= "2026-01-01" — 时间范围 常见工作流 浏览团队文档

• mx_confluence: 列出_spaces → 找到目标空间
• mx_confluence: 列出_pages, space_id: "xxx", 排序: "-modified-date"
• mx_confluence: 获取_page, page_id: "xxx", body_格式化: "storage" → 查看内容

创建并更新文档

• mx_confluence: 列出_spaces → 选择空间
• mx_confluence: 创建_page, space_id: "xxx", title: "...", body: "..."
• mx_confluence: 获取_page → 获取版本号
• mx_confluence: 更新_page, version: N+1 → 更新内容

注意事项 CRUD 操作使用 Confluence Cloud v2 API；CQL 搜索使用 v1 API（v2 无搜索端点） 页面内容格式为 Confluence Storage 格式化（HTML 子集） 更新页面时必须提供正确的 version 号（当前版本 + 1） CQL 搜索功能强大，建议充分利用 account_id 参数通常省略，工具自动检测已链接的 Confluence 账号