9月18日の時点で、ClewWiki にはリリースがひとつもありませんでした。ページの claim についての記事を書いたときは、イメージも npm パッケージもなく、ソースからビルドするしかありませんでした。それから17日後、バージョン 0.9.0 が出ました。10個目のタグで、イメージは GHCR にあり、MCP サーバーは npx で入ります。
この記事は、チームの wiki を選んでいて、それを自分たちのインフラに置きたい人向けです。エージェントや MCP の話はしません。それは別の記事で扱います。ここでは人に必要なことだけを書きます。導入方法、同僚の招き方、既存ページの移し方、そして長年使われてきたツールと比べてまだ弱いところです。
動かすのに必要なもの#
Compose 付きの Docker、git、openssl。それだけです。Redis も、メールサーバーも、外部のサインインプロバイダーのアカウントもいりません。スタック全体はアプリケーションと PostgreSQL 16 だけです。
git clone https://github.com/Dodecaidr/clewwiki.git
cd clewwiki
cp .env.example .env && chmod 600 .env
sed -i "s|^POSTGRES_PASSWORD=.*|POSTGRES_PASSWORD=$(openssl rand -hex 32)|" .env
sed -i "s|^BETTER_AUTH_SECRET=.*|BETTER_AUTH_SECRET=$(openssl rand -base64 48)|" .env
docker compose up -d
docker compose logs web | grep "setup token"macOS では sed -i の代わりに sed -i '' と書きます。あとは http://localhost:3000 を開き、ログに出た setup token を入れて最初の管理者を作ります。デフォルトのパスワードはないので、推測される心配もありません。
サーバーではさらに2つ必要です。公開 https:// アドレスを入れた BETTER_AUTH_URL と、アプリの前に置くリバースプロキシです。アプリは素の HTTP で話し、ポートは 127.0.0.1 にしか公開しないので、TLS はあなたの担当になります。docs/deploy.md に Caddy、Traefik、nginx の例があります。
依存が少ないのは意図的です。小さなチームでは、4つのサービスを運用する時間も気力もない人が wiki を立てることがよくあります。コンテナがひとつ増えるたびに、土曜日に落ちるものがひとつ増えます。
メールサーバーなしで人を招く#
誰でも登録できる入口はありません。人が wiki に入る経路は3つです。
招待リンク。 管理者が Members でアドレスとロールを入力すると、リンクが発行されます。表示は1回きり、使えるのも1回きり、有効期間は7日です。メールは送られません。リンクはチャットや対面で自分で渡します。だから SMTP のないインスタンスでも、何も欠けていません。データベースに保存されるのはリンクのハッシュだけです。
参加リクエスト。 管理者が有効にすると、サインインページに Ask to join が表示されます。名前、アドレス、パスワード、メモを残した人は、管理者が具体的なロールで承認するか却下するまで「承認待ち」の画面しか見られません。自分で自分を入れることはできません。クライアントのアドレスごとに1時間5件までです。
OpenID Connect によるシングルサインオン。 OIDC_ISSUER、OIDC_CLIENT_ID、OIDC_CLIENT_SECRET の3つの変数だけで、サインインページにボタンが現れます。パスワードでのサインインもそのまま使えるので、プロバイダーが落ちても管理者が締め出されることはありません。プロバイダーが決めるのはその人が 誰か であって、入れるかどうか ではありません。email_verified のないプロフィールは拒否され、OIDC_ALLOWED_EMAIL_DOMAINS でドメインを絞れます。OIDC_SIGN_UP を明示的に有効にしない限り、メンバーにするかどうかは管理者が決めます。
ロールは3つです。管理者はメンバー、エージェントトークン、スペースを管理します。エディターはページを書き、ディスカッションに参加し、エージェントの変更をレビューします。0.6 で追加された viewer は、wiki が書かれる相手のためのロールです。プロダクトマネージャー、テスター、顧客側のエンジニアなどです。viewer は見えるものはすべて読めます（ページ、ディスカッション、履歴、検索、エクスポート）が、何も変更できません。制限は読み取り専用のエージェントトークンと同じ場所にあり、それ以上の権限が必要なリクエストは 403 になります。最後の管理者は降格も削除もできません。
以前は、パスワードを忘れた人は一度削除して招待し直すしかなく、別のアカウントができていました。今は管理者がリセットリンクを作れます。1回限りで24時間有効、ハッシュで保存され、使うとそのアカウントのすべてのセッションが終了します。
1台のサーバーに複数のチーム#
0.8 で 組織 が加わりました。1つのインスタンスに複数の組織を置けて、それぞれにメンバー、スペース、エージェントトークン、管理者、設定があります。1つのアカウントで複数の組織に所属でき、ロゴの横のメニューから切り替えられます。各組織には /o/<アドレス> という専用の入口があります。
組織の中にはプロジェクトごとのスペースがあり、メンバーだけが見られる制限付きのスペースも作れます。ある組織から人を外しても、アカウントとほかの組織への所属はそのまま残ります。
複数の顧客のドキュメントを抱えるスタジオや代理店にとっては、これまで顧客ごとに wiki を立てるしかなかったケースそのものです。
すでに書いたものを移す#
移ってこられない wiki を選ぶ人はいません。ClewWiki へのインポートは、必ず中間ステップを通ります。できあがるページツリー、各ページのパス、その Markdown、変換できなかったものについてのメモを確認でき、ボタンを押すまでは何も作られません。
移行元は次のとおりです。
- Confluence のスペース：Cloud は REST API v2、自前の Server や Data Center は v1 で読み込みます。階層、見出し、リスト、表、言語付きのコードブロック、情報パネル、展開ブロック、インポートしたページ同士のリンク、画像が移ります。ファイル機能を有効にしていれば、添付ファイルも以前のバージョン、日付、コメントと一緒に移ります。
- Notion のエクスポートと Markdown のアーカイブ。ページがリンクしている画像やファイルも一緒です。
- 200 MB までの PDF。
出口も同じくらい広く開いています。ページは Markdown か HTML に、スペースはファイル込みで ZIP にエクスポートできます。ページは Markdown で保存されているので、ClewWiki をやめるときはアーカイブをダウンロードするだけです。
ここで大事なのは制限なので、はっきり書きます。Confluence のコメント、ラベル、権限、ページ履歴は読み込まれません。Markdown に相当するものがないマクロ（Jira の一覧、ページツリー、インクルード、チャート）は、動く内容ではなく、名前の入った目に見えるメモになります。Server と Data Center からのインポートは、実際の公開インスタンスとフィクスチャで確認していますが、何年もの運用実績はありません。マクロやマーケットプレイスに頼った wiki なら、移行は楽ではありません。リポジトリの docs/compare.md にもそう書いてあります。
そもそもなぜ今この話をするのか。Atlassian は 2029年3月28日に Data Center を終了し、その後のインストールは読み取り専用になります。新規顧客への販売は2026年春にすでに止まっています。セキュリティや法律の理由で wiki を社内に置いてきたチームにとって、その理由は消えていません。去っていくのは製品のほうです。
ドキュメントのすぐ隣にファイル#
0.7 から、ページにどんな種類のファイルでも添付できるようになりました。ビルド、インストーラー、仕様書などです。仕組みは、チームが実際にリリースを公開するやり方を参考にしました。
ページにすでにある名前でファイルをアップロードすると、同じリンクの後ろに次のバージョンができます。リンクは常に最新版を返すので、リリースノートに一度貼れば二度と触る必要はありません。?version=3 で特定のバージョンを固定できます。同じバイト列をもう一度上げても何も増えません。Restore は古いバージョンを新しいバージョンとして追加して最新にするので、誰かが一度ダウンロードしたバージョンが変わることはありません。
ページやスペースをウォッチしている人には、新しいバージョンが受信箱に届きます。ファイルの保存先はローカルディスクか、任意の S3 互換バケットです。ビルドパイプラインは1つのコマンドでファイルを公開できます。
curl -fsS -X PUT --data-binary @dist/app-2.4.1.apk \
-H "Authorization: Bearer $CLEWWIKI_TOKEN" \
"https://wiki.example.com/api/v1/pages/$PAGE_ID/files/app-2.4.1.apk?note=Signed%20build"トークンに必要なのは pages:write スコープだけです。同じリクエストを繰り返すと 201 ではなく 200 が返り、新しいバージョンは作られないので、CI でのリトライは安全です。
ページの中に課題と表#
0.8 で、wiki は外の世界にも目を向けるようになりました。
課題トラッカー。 YouTrack、Jira、そして KEY-123 形式のキーを持つ任意のトラッカーです。組織の管理者が、アドレス、プロジェクトキー、読み取りトークンを入れた環境変数の名前を設定します。トークン自体はデータベースに入りません。以降、本文中の課題キーはリンクになり、ページには言及した課題がステータスと担当者付きで一覧表示されます。エディタからは、説明とコメント付きで課題を丸ごと挿入したり、YouTrack のクエリや JQL で見つかった課題を表にして挿入したりできます。
隠さずに書いておくことがひとつあります。YouTrack と Jira のクライアントは、記録した API レスポンスでテストしただけで、実際のインスタンスではまだ試していません。テスト用のプロジェクトをお持ちなら、フィードバックはとても助かります。
表計算。 Import table or document ダイアログは Excel のブック（.xlsx）、CSV、TSV を受け付けます。ロシア語版やドイツ語版の Excel が保存するセミコロン区切りにも対応し、シートを表として挿入します。セルは画面で見えているとおりに移ります。数式は計算結果として、日付は日付として入り、非表示のシートは飛ばされます。「リンクを知っている全員」に共有された Google スプレッドシートや Google ドキュメントのリンクも使えます。逆方向では、表のあるページを .xlsx にエクスポートできます。表ごとに1シート、シート名はその上の見出しから取られ、ヘッダー行は太字で固定されます。すべてプロジェクト独自のコードで、表計算ライブラリは使っていません。古いバイナリ形式の .xls は読めません。
何が出荷されるかをチームが見る場所#
10月5日に出たバージョン 0.9.0 は、すべてのスペースに Development セクションを追加します。小さなチームが毎回の通話で聞く「これってもうリリースに入ってる？」という質問への答えです。
このセクションはスペースに紐づいた git リポジトリを読み、ブランチごとに作業の流れを1本ずつ管理します。最後のコミット、デフォルトブランチに対してどれだけ先行・遅延しているか、マージ済みかどうか、削除されたかどうかです。各流れには目標、状態付きのトラッカーの課題、ドキュメントページ、そして「問題」、つまり進行を妨げているものについてのディスカッションが紐づきます。問題が解決すると、その決定がその流れのドキュメントにページとして書き込まれます。
いちばん役に立つと思うのは、リリースなしでマージされた作業のハイライト一覧です。すでにデフォルトブランチに入っているのに、どの予定リリースにも拾われていない変更です。あとで「あれって結局出したんだっけ？」と浮かんでくるのは、まさにこういうものです。マージされていない流れが残っている間、リリースは出荷済みにできません。それでも出荷することはできますが、その事実は取り残されたものと一緒に監査ログに残ります。
まだないもの#
README にあるのと同じ、正直なリストです。
- SAML と LDAP。 シングルサインオンは OpenID Connect のみで、ディレクトリ同期はありません。
- モバイルアプリ。 Web インターフェースはスマートフォンでも動きますが、ネイティブクライアントはありません。
- 本番運用の年数。 最初のタグは2026年9月18日です。
docs/compare.mdに並ぶほかのツールは3年から20年以上の実績があります。0.x のバージョン間ではマイグレーションがまだ頻繁なので、アップデート前のデータベースのバックアップは形式的なものではありません。 - 背後のコミュニティや会社。 これは作者ひとりのオープンソースプロジェクトです。SLA のあるベンダーが必要なら、今の ClewWiki は向いていません。
その代わりに得られるもの：AGPL-3.0 の単一エディションで、上に挙げたものはすべて無料、ユーザー単位の有料プランの奥に隠されていません。スタックは1コマンドで立ち上がります。インターフェースは英語とロシア語です。
どこから始めるか#
上のコマンドでノートパソコンにインスタンスを立て、小さなスペースをひとつインポートして、中間画面を見てください。10分あれば、あなたの wiki が移れるのか、それともマクロの壁にぶつかるのかがわかります。コード、ドキュメント、課題トラッカーは GitHub のリポジトリに、プロジェクトの概要は ClewWiki のページにあります。
チームの wiki に AI エージェントをつないでいる、あるいはこれからつなぐなら、次の記事で 0.9 でエージェントが得るものを紹介します。
