hello-claw レビュー：OpenClaw を「領養」から「自作」まで導く中国語チュートリアル

このリポジトリが埋めている穴は「OpenClaw の一次情報が散らばっている」こと

OpenClaw はコマンドラインで動く AI 助理で、複数のチャットプラットフォームに接続し、Skills と呼ぶ拡張単位で機能を足していく。README は本プロジェクトを「面向 OpenClaw 的完整学习教程」と位置づけ、単体のソフトウェアではなく教材として配布している。対象として README が挙げるのは 4 層で、プログラミング経験のない零基礎ユーザー、QQ や飛書や Telegram で遠隔操作したい効率化目的の利用者、Skills と自動化に関心のある技術愛好家、そして Agent アーキテクチャを理解して自前版を作りたい開発者である。

つまり読者像が広い。これは長所であると同時に、章の取捨選択を読者自身が判断しなければならないという意味でもある。README の学習建議は明快で、零基礎なら第一部分、場景を回したいなら龙虾大学、開発者なら构建龙虾、と入口を分けている。逆に言えば、どこから読むかを決められない読者にとっては 11 章＋付録 A-G の分量がそのまま負債になる。

三部構成の中身：使用篇 11 章、龙虾大学の Skills 事例、開発篇 11 章

第一部分「领养龙虾」は 11 章と付録 A-G で構成される。内訳は README の目次によれば、インストール（第 1 章 AutoClaw 一键安装、第 2 章の手動インストール、第 3 章の初期設定ウィザード）、核心配置（第 4 章チャットプラットフォーム接続、第 5 章モデル管理、第 6 章エージェント管理）、拡張運維（第 7 章ツールとスケジュールタスク、第 8 章ゲートウェイ運維、第 9 章リモートアクセスとネットワーク）、安全とクライアント（第 10 章の脅威モデル、第 11 章の Web 界面）という並びである。

第二部分「龙虾大学」は章立てではなくメニュー式で、個人効率、 programming 開発、内容創作、商務販売、マルチエージェント協作、その他の 6 分類に事例が並ぶ。メール助手、ローカル健康管理、朝のブリーフィング、日程管理、Vibe Coding、CI/CD 助手、ドキュメント自動生成、科研自動化、コンテンツスタジオ、CRM 連携、会議予約と議事録、マルチ OpenClaw、知識ベース共有、一人公司、セキュリティチェックリスト、論文推送、スマートホーム、金融データ分析、教育支援といった題が README の表から読み取れる。

第三部分「构建龙虾」は 11 章で、OpenClaw のソースコードと代替案を先に解体し、そのうえで Skills、チャネル、完全カスタマイズへ進む。README の最新動態には第 1-10 章（プロンプト系、ツール系、メッセージループ、マルチチャネル接続）、第 13 章（Skill のファイル構造、Frontmatter、非同期処理とデバッグ）の完了が記録されている。章番号が 10 の次に 13 へ飛ぶ点は README 上で説明されておらず、執筆時点で 11 章と 12 章の記載が見当たらない。この欠番が未執筆なのか表記揺れなのかは、この資料からは判断できない。

導入手順は README の記述に沿うと 2 経路ある

README が示す入口は 2 つ。GUI で済ませたい読者向けが第 1 章の AutoClaw 桌面客户端で、README は「5 分钟零门槛体验」と表現している。もう一つが第 2 章の手動インストールで、目次の要約には「终端介绍、Node.js 安装、npm install、onboard 配置向导」とある。つまり Node.js を入れたうえで npm install を実行し、onboard という設定ウィザードを通す流れである。

設定ウィザードは第 3 章で扱い、CLI ウィザード、macOS 引导、Custom Provider、再設定が項目として挙がっている。モデル側は第 5 章で CLI 管理、複数プロバイダ設定、API Key のローテーション、フェイルオーバーを扱う。チャット接続は第 4 章で飛書を例に完整な接続手順とペアリング、グループチャットが説明される。

注意したいのは、この記事の材料には各章の本文そのものが含まれていないことだ。したがって具体的なコマンド文字列や設定キー名は README の要約以上には確認できない。実際に手を動かす前に、オンライン版（datawhalechina.github.io/hello-claw）で該当章を開き、コマンドと設定キーを一次情報として確認する必要がある。

龙虾大学は「読む教材」ではなく「選ぶカタログ」として設計されている

第二部分の性格は他と異なる。章を順に読むのではなく、自分の業務に近い事例を 5 から 10 個選んで適用する使い方を README 自身が推奨している。この設計は、Skills の選定と典型ワークフローを主題にしているという README の説明と整合する。

カタログ形式の利点は、読者が自分の課題から逆引きできることだ。欠点は、事例同士の依存関係や前提条件が一覧からは見えないことにある。たとえば知識ベース共有やマルチ OpenClaw のような協作系の事例は、単体のエージェント運用が安定していることを前提にしていそうだが、README の表からはその前提条件は読み取れない。導入順序を誤ると、動かない原因が自分の環境にあるのか事例の前提にあるのか切り分けられなくなる。

もう一点、README の最新動態には 2026-03-25 付で個人効率、programming 開発、内容創作、商務販売、マルチエージェント協作などの 11 篇が追加されたと記されている。事例群はここ最近でまとめて増えた部分であり、章間の粒度や前提の揃い方は、使用篇や開発篇より粗い可能性があると見ておいたほうがよい。

開発篇を読む前に知っておくべき制約：バージョン追従のコスト

この教材の更新頻度は高い。README の最新動態を並べると、2026-03-04 のプロジェクト開始から、03-08 に使用篇 1-11 章、03-10 に Skill 構造の章、03-12 に開発篇 1-10 章、03-23 に OpenClaw 3.22 の大版本、03-25 に v2026.3.24 と、ほぼ 3 週間で主要部分が埋まっている。

この速度は、裏返すと OpenClaw 本体の変化に教材が追随し続けなければならないことを意味する。実際、2026-03-23 の記述にはプラグイン SDK の再構成と旧 extension-api の廃止、セキュリティ修正（SMB 認証情報の漏洩、環境変数注入、Unicode 偽装など）、GPT-5.4 のデフォルト化が挙げられている。旧 extension-api が廃止されたということは、それ以前の版を前提に書かれた開発篇の記述が、そのままでは動かない箇所を含む可能性がある。

教材を読む際は、手元の OpenClaw のバージョンと、その章がどの版を前提にしているかを突き合わせる作業が要る。README は章ごとの対象バージョンを明示していないため、この突き合わせは読者側の負担になる。

向かないケース：日本語話者と、商用に組み込むチーム

第一の制約は言語である。このリポジトリの本文は中国語で、README には英語版（README_EN.md）と日本語版（README_JA.md）へのリンクがあるが、リンクが用意しているのは README の翻訳であって、docs/cn/ 配下の章本文の翻訳ではない。目次のリンクがすべて ./docs/cn/ を指していることから、少なくとも現時点の教材本体は中国語で読む前提だと判断できる。日本語だけで OpenClaw を学びたい読者には、この教材は入口にならない。

第二の制約はライセンスである。README のバッジは CC BY-NC-SA 4.0 を示している。NC は非営利、SA は同一条件での継承を意味する。社内研修や個人学習はともかく、教材の一部を自社の商用トレーニングや製品ドキュメントに取り込む用途は、この条件と衝突しうる。ただしこの記事の材料では、リポジトリ直下の LICENSE ファイルの実際の文面は確認できない。README のバッジ表記と LICENSE の内容が一致しているかは、利用前に必ず本人が確認すべき点である。ここでは法的助言はできない。

第三に、これは教材であってライブラリではない。npm で依存として入れて API を呼ぶ類のものではなく、読んで手を動かす対象である。CI に組み込むとか、バージョン固定で再現可能な手順が欲しいといった要求には応えない。

比較対象としての easy-vibe：同じ組織が別の学習経路を用意している

README の冒頭には datawhalechina/easy-vibe へのリンクがあり、「还想学 Vibe Coding」という一文が添えられている。両者は競合ではなく、対象とする技能が違う。easy-vibe が Vibe Coding、つまり AI に書かせる側の作法を扱うのに対し、hello-claw は OpenClaw という実行基盤そのものを扱う。

この違いは学習の入口に現れる。コーディング支援を早く使いたいだけなら easy-vibe 側が近道になる。一方で、自分のチャット環境に常駐する助理を立て、Skills を足し、最終的には自分でビルドしたいなら hello-claw の三部構成が対応する。とくに第三部分は OpenClaw のソースコードを解体し、軽量化、セキュリティ強化、ハードウェア案といった代替案まで扱うと README に記されており、これは easy-vibe にはない範囲である。

ただし hello-claw の龙虾大学にも Vibe Coding 実戦という項目があり、領域は完全には分かれていない。どちらか一方だけを読めば済む関係ではなく、目的から逆算して選ぶべきものだ。

維持コストと、読む前に確認しておきたい 3 点

維持コストの面で見ると、この教材は読者に継続的な追従を求める。OpenClaw 側のリリースが数週間単位で入り、それがプラグイン SDK の廃止やセキュリティ修正のように後方互換性に影響する種類の変更を含むためだ。読者が固定できるのは教材のリビジョンではなく、自分の環境のバージョンのほうである。

採用判断の前に確認したいのは 3 点。第一に、リポジトリ直下の LICENSE の文面と README バッジの CC BY-NC-SA 4.0 が一致しているか。第二に、docs/cn/university/ 配下のどの事例が自分の用途に最も近いか、実際に開いて前提条件を読むこと。第三に、開発篇を読む場合は、その章が旧 extension-api 前提か新 SDK 前提かを見分けること。README の 2026-03-23 の記述が旧 extension-api の廃止を明示しているので、この確認を省くと動かないコードを写すことになる。

教材としての作りは丁寧で、入口を読者層ごとに分ける設計も一貫している。ただしそれは中国語を読み、OpenClaw 本体の更新を自分で追える読者に対してのみ機能する。

編集部の結論

OpenClaw を QQ や飛書、Telegram 経由で運用したい中国語話者、とくにノーコードで始めたい層には、第 1 章の AutoClaw から読み始める価値がある。逆に、日本語だけで完結するドキュメントを求める読者や、商用製品に組み込む前提のチームには向かない。採用前に README のライセンス表記（CC BY-NC-SA 4.0）とリポジトリ直下の LICENSE ファイルの内容が一致しているかを確認し、次に docs/cn/university/ 配下の実戦例が自分の用途に近いかを開いて確かめてほしい。

公式情報源

1. datawhalechina/hello-claw on GitHub
2. Issues
3. Project website
4. README