禅道开源版 22.2.stable 这次的更新，重心放在了两件事上——让文档操作更顺手，让 AI 能力更近一步。文档复制、附件在线预览是日常高频需求，直接省掉了下载→打开→再关掉的循环；而 OpenClaw 的集成，意味着禅道的 AI 面板不再只是"看看"，而是可以真正对话、调用外部智能助手。下面逐项拆开看。
文档复制：从"只能看"到"能搬走"
以前禅道文档页面只能浏览，想复用一段内容只能手动截图或另开编辑器重敲。22.2 版本给文档加了复制按钮，选中内容后一键复制到剪贴板，再粘贴到新文档或其他系统里。
实际场景：项目复盘时，把上一期的迭代总结直接复制到新文档做模板，改几个字段就发布，不用从空白页开始写。
附件在线预览：PDF、图片、Office 文件不用下载
常见附件格式（PDF、图片、Word/Excel/PPT 等）现在支持浏览器内直接预览。点击附件名，弹窗展示内容，看完关掉即可。
这对以下场景尤其明显：
- 测试同学上传了缺陷截图，开发在禅道里直接看，不用先下载到本地再打开。
- 产品经理贴了需求文档的 PDF，评审时所有人在线翻页，省去邮件转发附件的步骤。
OpenClaw 集成：AI 面板从"内置"走向"可扩展"
这次更新的另一个重点是禅道集成了 OpenClaw，ZAI（禅道的 AI 模块）新版本支持把 OpenClaw 添加为智能助手。配置完成后，禅道右侧的 AI 面板可以直接与 OpenClaw 对话，相当于在项目管理工具里嵌入了一个可定制的 AI 入口。
OpenClaw 本身是一个开源的 AI Agent 框架，支持多种大模型后端。把它接入禅道后，你可以：
- 在 AI 面板里直接提问项目相关问题，OpenClaw 根据配置的模型返回答案。
- 把 OpenClaw 配置为特定领域的助手（比如代码审查、需求分析），在禅道内按场景切换。
配置 OpenClaw 为禅道智能助手
以下是一个最小化的 OpenClaw 接入示例。假设你已经部署了禅道 22.2 和 OpenClaw 服务，核心步骤是在 ZAI 后台添加助手配置。
第一步：部署 OpenClaw 服务（Docker 方式）
# 拉取 OpenClaw 镜像
docker pull openclaw/openclaw-server:latest
# 启动服务，挂载配置目录
docker run -d \
--name openclaw-server \
-p 8085:8085 \
-v /opt/openclaw/config:/app/config \
-e OPENCLAW_LLM_PROVIDER=openai \
-e OPENCLAW_LLM_API_KEY=sk-your-api-key-here \
-e OPENCLAW_LLM_BASE_URL=https://api.openai.com/v1 \
openclaw/openclaw-server:latest
注意：
OPENCLAW_LLM_API_KEY和OPENCLAW_LLM_BASE_URL需替换为你实际使用的模型服务地址。如果用国内模型，把BASE_URL换成对应厂商的 endpoint。
第二步：ZAI 后台添加 OpenClaw 为智能助手
进入禅道后台 → AI 设置 → 智能助手管理，新增一条记录：
| 字段 | 值 |
|---|---|
| 助手名称 | OpenClaw-代码审查 |
| 助手类型 | OpenClaw |
| 服务地址 | http://你的服务器IP:8085 |
| 默认提示词 | 你是一个代码审查助手，请根据禅道中的需求描述和代码片段给出审查意见 |
保存后，在禅道任意页面的 AI 面板中，助手下拉列表会出现"OpenClaw-代码审查"，选中即可对话。
如果你更习惯用配置文件，禅道的 ZAI 助手配置也可以通过 YAML 管理：
# /opt/zentao/config/zai_assistants.yaml
assistants:
- name: "OpenClaw-需求分析"
type: openclaw
endpoint: "http://10.0.1.50:8085"
system_prompt: "你是一个需求分析助手，擅长从用户故事中提取验收标准和边界条件。"
enabled: true
- name: "OpenClaw-测试建议"
type: openclaw
endpoint: "http://10.0.1.50:8085"
system_prompt: "根据禅道中的缺陷描述，给出回归测试和边界测试的建议用例。"
enabled: true
修改后重启禅道服务生效：
# 重启禅道
/opt/zentao/bin/zentao restart
细节修复与体验打磨
除了上述功能，22.2 还修复了多个已知 Bug，文档编辑器的多项交互细节做了调整——比如富文本编辑器的粘贴格式处理更稳定、长文档滚动时的性能优化等。这些改动不大但高频，日常用文档模块的团队会直接感受到流畅度提升。
上手建议
| 场景 | 建议动作 |
|---|---|
| 团队大量使用文档模块 | 升级后优先体验复制和在线预览，把常用模板文档整理一次 |
| 已在用 ZAI | 部署 OpenClaw，按团队痛点配置专属助手（审查、需求、测试） |
| 暂时不需要 AI | 先升级享受文档和预览改进，OpenClaw 后续随时可加 |
升级命令（Linux 环境）：
# 备份当前版本
cp -r /opt/zentao /opt/zentao_backup_22.1
# 下载 22.2.stable 安装包
wget https://www.zentao.net/dl/zentao/22.2.stable/zentao_22.2.stable_linux.tar.gz
# 解压并升级
tar -xzf zentao_22.2.stable_linux.tar.gz -C /opt/zentao
/opt/zentao/bin/zentao upgrade
一句话总结：22.2 的文档复制和附件预览是"立刻省时间"的改进，OpenClaw 集成是"未来可扩展"的铺垫。如果你团队每天在禅道里写文档、看附件，这次升级的回报最直接。