Confluence Cloud

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

前置条件

1. 安装插件: openclaw plugins install openclaw-morphixai
2. 获取 API Key: 访问 morphix.app/api-keys 生成 mk_xxxxxx 密钥
3. 配置环境变量: export MORPHIXAI_API_KEY="mk_your_key_here"
4. 链接账号: 访问 morphix.app/connections 链接 Confluence 账号，或通过 mx_link 工具链接（app: confluence）

核心操作

列出空间

mx_confluence:
  action: list_spaces
  limit: 10
  type: "global"

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

获取空间详情

mx_confluence:
  action: get_space
  space_id: "163843"

列出页面

mx_confluence:
  action: list_pages
  space_id: "163843"
  limit: 20
  sort: "-modified-date"

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

获取页面详情

mx_confluence:
  action: get_page
  page_id: "163923"
  body_format: "storage"

body_format 可选值：storage（HTML）、atlas_doc_format（ADF）、view（渲染后 HTML）

创建页面

mx_confluence:
  action: create_page
  space_id: "163843"
  title: "会议纪要 2026-02-25"
  body: "\x3Ch2>议题\x3C/h2>\x3Cp>1. 项目进度回顾\x3C/p>\x3Cp>2. 下周计划\x3C/p>"
  parent_id: "163924"

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

更新页面

mx_confluence:
  action: update_page
  page_id: "163923"
  title: "更新后的标题"
  body: "\x3Cp>更新后的内容\x3C/p>"
  version: 2

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

删除页面

mx_confluence:
  action: delete_page
  page_id: "163923"

获取子页面

mx_confluence:
  action: get_child_pages
  page_id: "163923"
  limit: 20
  sort: "-modified-date"

获取页面标签

mx_confluence:
  action: get_page_labels
  page_id: "163923"

添加标签

mx_confluence:
  action: add_page_label
  page_id: "163923"
  label: "important"

删除标签

mx_confluence:
  action: delete_page_label
  page_id: "163923"
  label_id: "12345"

先用 get_page_labels 获取 label ID。

获取页面评论

mx_confluence:
  action: get_page_comments
  page_id: "163923"
  body_format: "storage"
  limit: 10

添加评论

mx_confluence:
  action: add_page_comment
  page_id: "163923"
  body: "\x3Cp>这是一条评论\x3C/p>"

CQL 搜索

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

CQL 常用语法：

• type=page / type=blogpost — 内容类型
• space.key=XX — 指定空间
• title~"关键词" — 标题模糊搜索
• text~"关键词" — 全文搜索
• creator=currentUser() — 当前用户创建的
• lastModified >= "2026-01-01" — 时间范围

常见工作流

浏览团队文档

1. mx_confluence: list_spaces → 找到目标空间
2. mx_confluence: list_pages, space_id: "xxx", sort: "-modified-date"
3. mx_confluence: get_page, page_id: "xxx", body_format: "storage" → 查看内容

创建并更新文档

1. mx_confluence: list_spaces → 选择空间
2. mx_confluence: create_page, space_id: "xxx", title: "...", body: "..."
3. mx_confluence: get_page → 获取版本号
4. mx_confluence: update_page, version: N+1 → 更新内容

注意事项

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