什么是 Wiki.js 管理？

Wiki.js 是一款现代、强大的开源维基引擎，旨在让文档变得易于访问且美观。本技能提供了在各种环境中有效部署 Wiki.js 的技术框架，同时避开了困扰许多自托管方案的常见坑点。通过利用 Openclaw Skills，开发人员可以确保其文档站点从首次启动起就具备高性能、正确的搜索索引和安全的用户管理配置。

该技能强调最佳实践，例如使用 PostgreSQL 处理多用户并发，以及通过反向代理正确管理 SSL 终端。它为管理员提供了保障，确保关键的初始设置（如站点 URL 和数据库类型）得到正确处理，以防止在项目后期出现内部链接断裂或数据库锁定。

下载入口:https://github.com/openclaw/skills/tree/main/skills/ivangdavila/wiki-js

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

Wiki.js 管理 应用场景

• 为工程团队部署生产就绪的文档站点。
• 配置 S3 等高性能存储后端以防止数据库膨胀。
• 为不同用户部门设置复杂的基于路径的权限规则。
• 建立单向 Git 同步工作流，用于内容版本控制和异地备份。
• 排除反向代理环境中的 SSL 重定向循环和资产加载错误。

1. 验证初始站点 URL 以防止未来内部链接失效。
2. 在需要多用户写入访问的环境中，自动选择 PostgreSQL 而非 SQLite。
3. 配置仅限 HTTP 的内部路由，以允许在代理层进行外部 HTTPS 终止。
4. 强制执行 Markdown 优先的编辑工作流，以维护数据完整性并避免 WYSIWYG 渲染异常。
5. 实施基于路径的权限模式，以确保在站点层级结构中进行细粒度的访问控制。

Wiki.js 管理 配置指南

要在 Openclaw Skills 生态系统中使用此技能，请确保您的环境符合 Node.js 或 Docker 部署的先决条件。使用以下步骤初始化您的实例：

# Wiki.js 实例的 Docker 部署示例
docker run -d -p 8080:3000 --name wiki --restart always r
  -e "DB_TYPE=postgres" r
  -e "DB_HOST=db_host" r
  -e "DB_PORT=5432" r
  -e "DB_USER=wiki" r
  -e "DB_PASS=password" r
  -e "DB_NAME=wiki" r
  requarks/wiki:2

在完成设置向导之前，请确保您的反向代理（Nginx/Traefik）已配置为处理 SSL。

Wiki.js 管理 数据架构与分类体系

该技能基于以数据库为中心的架构组织 Wiki.js 数据，其中数据库作为所有元数据和内容的单一事实来源。

name: Wiki.js
description: Deploy and manage Wiki.js documentation sites avoiding common configuration traps.
metadata: {"clawdbot":{"emoji":"??","os":["linux","darwin","win32"]}}

Critical Initial Config

• Site URL must be correct from first setup — changing later breaks all internal links, no easy fix
• PostgreSQL over SQLite for any multi-user setup — SQLite locks under concurrent writes
• HTTPS terminates at reverse proxy — Wiki.js runs HTTP internally, don't configure SSL in Wiki.js

Editor Traps

• Visual Editor uses HTML underneath — switching from Markdown loses formatting, can't switch back cleanly
• Markdown editor is the safe default — WYSIWYG has rendering quirks and sync issues
• Internal links require locale prefix — [Link](/en/path/to/page) not just /path/to/page

Permission Pitfalls

• Deny rules take precedence over allow — overlapping patterns cause unexpected lockouts
• Page rules use path patterns — /engineering/* covers subpages, /engineering is exact match only
• Default "Users" group applies to all new accounts — configure before inviting users

Storage and Sync

• Git sync is one-way by default — Wiki.js to Git only, external edits don't sync back
• Asset storage in database bloats backups — use S3/GCS for images on larger wikis
• Database backup IS the complete backup — all content, users, permissions stored there

Search Behavior

• Search respects permissions — users don't find pages they can't access (can cause confusion)
• Search index rebuilds automatically — large imports need patience, no manual trigger helps
• Elasticsearch optional — built-in DB search works but lacks relevance ranking

Troubleshooting Specifics

• Login redirect loops — almost always HTTPS/HTTP mismatch in Site URL config
• Assets not loading — Site URL doesn't match actual access URL
• Page shows 404 after creation — special characters in path, use lowercase alphanumeric
• Slow after import — search reindexing in progress, wait or check Admin > Utilities