{"skill":{"slug":"confluence-2","displayName":"Confluence","summary":"Confluence Cloud 集成。空间/页面 CRUD、标签、评论、子页面、CQL 搜索。通过 MorphixAI 代理安全访问 Confluence Cloud API（v2 CRUD + v1 搜索）。","description":"---\nname: confluence\ndescription: Confluence Cloud 集成。空间/页面 CRUD、标签、评论、子页面、CQL 搜索。通过 MorphixAI 代理安全访问 Confluence Cloud API（v2 CRUD + v1 搜索）。\nmetadata:\n  openclaw:\n    emoji: \"📄\"\n    requires:\n      env: [MORPHIXAI_API_KEY]\n---\n\n# Confluence Cloud\n\n通过 `mx_confluence` 工具管理 Confluence 工作区：空间浏览、页面 CRUD、标签管理、评论、子页面导航、CQL 搜索。\n\n## 前置条件\n\n1. **安装插件**: `openclaw plugins install openclaw-morphixai`\n2. **获取 API Key**: 访问 [morphix.app/api-keys](https://morphix.app/api-keys) 生成 `mk_xxxxxx` 密钥\n3. **配置环境变量**: `export MORPHIXAI_API_KEY=\"mk_your_key_here\"`\n4. **链接账号**: 访问 [morphix.app/connections](https://morphix.app/connections) 链接 Confluence 账号，或通过 `mx_link` 工具链接（app: `confluence`）\n\n## 核心操作\n\n### 列出空间\n\n```\nmx_confluence:\n  action: list_spaces\n  limit: 10\n  type: \"global\"\n```\n\n> `type` 可选值：`global`（团队空间）、`personal`（个人空间）\n\n### 获取空间详情\n\n```\nmx_confluence:\n  action: get_space\n  space_id: \"163843\"\n```\n\n### 列出页面\n\n```\nmx_confluence:\n  action: list_pages\n  space_id: \"163843\"\n  limit: 20\n  sort: \"-modified-date\"\n```\n\n> 省略 `space_id` 列出所有空间的页面。\n\n### 获取页面详情\n\n```\nmx_confluence:\n  action: get_page\n  page_id: \"163923\"\n  body_format: \"storage\"\n```\n\n> `body_format` 可选值：`storage`（HTML）、`atlas_doc_format`（ADF）、`view`（渲染后 HTML）\n\n### 创建页面\n\n```\nmx_confluence:\n  action: create_page\n  space_id: \"163843\"\n  title: \"会议纪要 2026-02-25\"\n  body: \"<h2>议题</h2><p>1. 项目进度回顾</p><p>2. 下周计划</p>\"\n  parent_id: \"163924\"\n```\n\n> `body` 使用 Confluence Storage Format（HTML 子集）。`parent_id` 可选，省略则创建为顶级页面。\n\n### 更新页面\n\n```\nmx_confluence:\n  action: update_page\n  page_id: \"163923\"\n  title: \"更新后的标题\"\n  body: \"<p>更新后的内容</p>\"\n  version: 2\n```\n\n> **必须提供** `version`（当前版本号 + 1），否则更新失败。先用 `get_page` 获取当前版本号。\n\n### 删除页面\n\n```\nmx_confluence:\n  action: delete_page\n  page_id: \"163923\"\n```\n\n### 获取子页面\n\n```\nmx_confluence:\n  action: get_child_pages\n  page_id: \"163923\"\n  limit: 20\n  sort: \"-modified-date\"\n```\n\n### 获取页面标签\n\n```\nmx_confluence:\n  action: get_page_labels\n  page_id: \"163923\"\n```\n\n### 添加标签\n\n```\nmx_confluence:\n  action: add_page_label\n  page_id: \"163923\"\n  label: \"important\"\n```\n\n### 删除标签\n\n```\nmx_confluence:\n  action: delete_page_label\n  page_id: \"163923\"\n  label_id: \"12345\"\n```\n\n> 先用 `get_page_labels` 获取 label ID。\n\n### 获取页面评论\n\n```\nmx_confluence:\n  action: get_page_comments\n  page_id: \"163923\"\n  body_format: \"storage\"\n  limit: 10\n```\n\n### 添加评论\n\n```\nmx_confluence:\n  action: add_page_comment\n  page_id: \"163923\"\n  body: \"<p>这是一条评论</p>\"\n```\n\n### CQL 搜索\n\n```\nmx_confluence:\n  action: search\n  cql: \"type=page AND space.key=SOP AND title~\\\"API\\\"\"\n  limit: 10\n```\n\n> CQL 常用语法：\n> - `type=page` / `type=blogpost` — 内容类型\n> - `space.key=XX` — 指定空间\n> - `title~\"关键词\"` — 标题模糊搜索\n> - `text~\"关键词\"` — 全文搜索\n> - `creator=currentUser()` — 当前用户创建的\n> - `lastModified >= \"2026-01-01\"` — 时间范围\n\n## 常见工作流\n\n### 浏览团队文档\n\n```\n1. mx_confluence: list_spaces → 找到目标空间\n2. mx_confluence: list_pages, space_id: \"xxx\", sort: \"-modified-date\"\n3. mx_confluence: get_page, page_id: \"xxx\", body_format: \"storage\" → 查看内容\n```\n\n### 创建并更新文档\n\n```\n1. mx_confluence: list_spaces → 选择空间\n2. mx_confluence: create_page, space_id: \"xxx\", title: \"...\", body: \"...\"\n3. mx_confluence: get_page → 获取版本号\n4. mx_confluence: update_page, version: N+1 → 更新内容\n```\n\n## 注意事项\n\n- CRUD 操作使用 Confluence Cloud v2 API；CQL 搜索使用 v1 API（v2 无搜索端点）\n- 页面内容格式为 Confluence Storage Format（HTML 子集）\n- 更新页面时必须提供正确的 `version` 号（当前版本 + 1）\n- CQL 搜索功能强大，建议充分利用\n- `account_id` 参数通常省略，工具自动检测已链接的 Confluence 账号\n","tags":{"latest":"0.1.1"},"stats":{"comments":0,"downloads":642,"installsAllTime":24,"installsCurrent":0,"stars":0,"versions":2},"createdAt":1772618844443,"updatedAt":1778491714733},"latestVersion":{"version":"0.1.1","createdAt":1772786611537,"changelog":"- 新增详细前置条件说明，包括插件安装、API Key 获取与环境变量配置、Confluence 账号链接指引  \n- 明确 API Key 获取和账号授权需访问 morphix.app 的具体页面  \n- 保持核心功能、操作方法与工作流不变  \n- 其他内容无变动","license":null},"metadata":{"setup":[{"key":"MORPHIXAI_API_KEY","required":true}],"os":null,"systems":null},"owner":{"handle":"paul-leo","userId":"s1752kcbgt0ajgbfqwd4y5vb3n83kvp4","displayName":"Paul Leo","image":"https://avatars.githubusercontent.com/u/55380315?v=4"},"moderation":null}