Confluence

Confluence Cloud 集成。空间/页面 CRUD、标签、评论、子页面、CQL 搜索。通过 MorphixAI 代理安全访问 Confluence Cloud API（v2 CRUD + v1 搜索）。

Security Scan

The skill's requirements and runtime instructions are consistent with a Confluence Cloud integration that proxies requests through MorphixAI; it only asks for a Morphix API key and to link your Confluence account, which matches the described functionality.

Purpose & Capability

Name/description (Confluence CRUD, comments, labels, CQL search) matches the SKILL.md examples and required resources. The single required env var (MORPHIXAI_API_KEY) is directly referenced and justified by the use of the MorphixAI proxy.

Instruction Scope

Instructions only describe using an mx_confluence action API via the Morphix proxy, installing the openclaw-morphixai plugin, and linking a Confluence account via morphix.app; there are no instructions to read arbitrary files, access unrelated env vars, or transmit data to unexpected endpoints.

Install Mechanism

This is an instruction-only skill with no install spec and no code files—no downloads or archives are requested, which minimizes on-disk execution risk. It does instruct installing an OpenClaw plugin (openclaw-morphixai), which is expected for this proxy-based design.

Credentials

Only MORPHIXAI_API_KEY is required and explicitly used; no unrelated credentials or broad config paths are requested. The need for a Morphix API key is proportionate given the design where Morphix mediates Confluence API calls.

Persistence & Privilege

The skill is not marked always:true and does not request system-wide configuration changes or modify other skills. It follows normal agent-invocable defaults and does not demand elevated persistence.

Assessment

This skill appears internally consistent: it proxies Confluence operations through MorphixAI and therefore requires only your Morphix API key plus a linked Confluence account. Before installing, confirm you trust morphix.app and the openclaw-morphixai plugin because Morphix will have the ability to act on your Confluence workspace. Consider these precautions: (1) limit the Confluence account or API-client permissions used for the connection (use a dedicated integration account if possible), (2) store and rotate the MORPHIXAI_API_KEY per your organization policy, (3) review Morphix's privacy/security docs and the OpenClaw plugin source if available, and (4) be aware that the skill can be invoked by the agent (normal behavior) — if you want to avoid autonomous calls, restrict when the skill may be used in your agent settings.

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: "<h2>议题</h2><p>1. 项目进度回顾</p><p>2. 下周计划</p>"
  parent_id: "163924"

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

更新页面

mx_confluence:
  action: update_page
  page_id: "163923"
  title: "更新后的标题"
  body: "<p>更新后的内容</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: "<p>这是一条评论</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 账号