Back to list
OpenClaw をそのまま動くようにする手順
How to make OpenClaw just work
Translated: 2026/4/25 4:56:38
Japanese Translation
本稿は、OpenClaw 執筆コンテストへの投稿です。本稿では、OpenClaw を Windows 上で「ただ動かす」ための手順を案内します。私は Windows を OS として使用しましたが、このガイドは Linux 上でも簡単に適用可能であると思います。
おそらく、タイトルを説明する必要がある必要はないでしょう。あなたが(私のように)OpenClaw チャレンジに参加しようとしているか、あるいは初めて OpenClaw を試みにしている場合、きっと OpenClaw をあなたのマシンで「ただ動かす」ことが簡単なことではないことに気づいたはずです。
私はこの分野で OpenClaw チームが改善する余地があると考えるかもしれませんが、結局、これがこのチャレンジの目的なのかもしれません。ヘヘ。あなたの意見を聞かせてください。
この冒頭の紹介の後、本稿では尽可能的に直接で简单的にします。あなたはおそらく、OpenClaw を設定しようとしてすでに時間を使い損ねているので、あなたが時間を節約する必要があると考えるべきです。
Verison
インストール
初期設定
エージェントとの最初の対話
おめでとうございます、あなたがそれを動かしました
追加:考慮すべき事項
参照および再現性を確保するために:
OS -> Windows 11
Node バージョン -> Node.js v24.11.0
OpenClaw バージョン -> openclaw 2026.4.22
インストール
Node がインストールされていない場合は、Node をインストールします。
以下で OpenClaw をインストールします:
>> npm install -g openclaw@2026.4.22
added 498 packages in 51s
インストールが完了したか確認するために:
>> openclaw -v
OpenClaw 2026.4.22 (00bd2cf)
メモ:私は再現性のために特定のバージョンを使用しています。チームは毎日リリースを行っているため、この記事の公開日付の後で異なるバージョンを試すと何か壊れる可能性があります。私はバージョン 2026.4.21 で問題が発生しました。もしあなたがスキルに十分であれば、最新バージョンを試してよろしいのですが、「この物をただ動かそう」というモードにある場合は、本ガイドに従ってください。
OpenClaw を設定するには、モデルとモデルプロバイダーを設定する必要があります。これはエージェントが動作するための必要な条件です。プロバイダーとして、Google AI Studio を使用します。Google AI Studio に行き、API キーを生成するセクションを探してください。これは比較的簡単に行えます。
それを入手したら、それを安全な場所にあります。それだけ事前が必要です。OpenClaw に進むことができます。コマンドで始めます:
openclaw onboard
次に、私のコンピュータでは、コマンドが OpenClaw の CLI を表示するまで約 4 分待たなければなりませんでした。ヘヘ。これはコマンドを実行してフリーズするケースを見かけた場合にのみ警告です。プロセスに信頼し、待ちましょう。何か別のものをインストールする必要があるようです。数分後、何かのようなものを見出すべきです:
よ、あなたは設定をしようとしています。ここでは、設定を迅速に完了するためのデフォルトの答えがあります:
質問
選択オプション
これはデフォルトで個人的であり、共有/マルチユーザー使用にはロックダウンが必要です。続けますか?
yes
設定モード
QuickStart
モデル/認証プロバイダー
Google
Gemini API キーを入力
Google AI Studio で入手した API キーを入力
モデル
google/gemini-2.5-flash
チャネルを選択(QuickStart)
現在スキップ
検索プロバイダー
現在スキップ
スキルを設定する?(推奨)
No
フックを有効にする?
現状スキップ
あなたはどのようにボットを孵化させたいですか?
後にこれをします
よ、設定は準備が整いました。デフォルトのモデルを確認するために、実行します:
openclaw models
何かのようなものを表示する必要があります:
デフォルトモデルは、onboard 中に設定したものが重要である。
すべてが期待と一致する場合、私たちはエージェントをプレイするために進むことができます。
1 つのターミナルでは実行:
openclaw gateway
これは「サーバーを実行する」エージェントをプレイするために開始します。
別のターミナルで実行:
openclaw tui
これは「クライアントを開く」エージェントとチャットするために開始します。
準備ができたら、「Hello」といった何かを入力します。あなたは幸運な場合、あなたはレスポンスを受け取ります:
そして、それでよ。あなたは OpenClaw とプレイおよび相互作用を開始できます。
さて、あなたはエージェントとチャットできます。エージェントは、振る舞い、パーソナリティ、および実行するタスクを定義する方法を案内します。あなたがこの点からあなた自身で探索を続けることができます。
このチュートリアルが役に立ち、あなたが時間を使いませんでしたと願っています。)
あなたが Google AI Studio で API キーを作成した、必ず予算を設定してください
Original Content
This is a submission for the OpenClaw Writing Challenge
In this article, I want to guide you on how to make OpenClaw "just work" on Windows. I used Windows as my OS, but I think this guide can be easily followed on Linux as well.
Chances are, I don't have to explain the title. If you (like me) are trying to participate in the OpenClaw challenge or just trying OpenClaw for the first time, you certainly found that making OpenClaw "just work" on your machine is not an easy task.
I think there is room to improve in this area for the OpenClaw team, or maybe that's the point of this challenge after all? hehe You tell me.
After that fresh introduction, I will try to be direct and simple in this guide. I think I need to save you some time since you probably already wasted some, trying to set up OpenClaw...
Versions
Installation
Initial Setup
First chat with the Agent
Congrats, You made it work
Extra: Things to consider
For reference and reproducibility:
Operating System -> Windows 11
Node Version -> Node.js v24.11.0
Openclaw version -> openclaw 2026.4.22
Installation
Install Node if you haven't installed it.
Install OpenClaw with:
>> npm install -g openclaw@2026.4.22
added 498 packages in 51s
Check it is installed with:
>> openclaw -v
OpenClaw 2026.4.22 (00bd2cf)
Note: I use a specific version for reproducibility. The team is making releases every day and something might get broken if you try a different version after the publication date of this post. I did experience issues with version 2026.4.21, so if you are skilled enough, feel free to play with the latest version; but if you are in the mode of "let's make this thing just work," stick to the guide.
To set up OpenClaw, we need to set a model and model provider; this is necessary for the agent to work. As the provider, we will use Google AI Studio. Let's go to Google AI Studio and look for the section to generate an API KEY. It is relatively easy to do.
Once we have it, we save it in a secure place. It's all we need beforehand; we can proceed with OpenClaw. Let's start with the command:
openclaw onboard
Now, on my computer, I had to wait about 4 minutes for the command to show the CLI of OpenClaw. Haha, this is just a warning in case you run the command and see it hangs. Just trust the process and wait for it. It seems it needs to install something else before actually starting. After some minutes you should see something like:
So, you are about to set up. Here are the default answers to use to finish the setup quickly:
Question
Option to choose
I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
yes
Setup Mode
QuickStart
Model/auth provider
Google
Enter Gemini API key
Enter the API KEY you got from Google AI Studio
Model
google/gemini-2.5-flash
Select channel (QuickStart)
Skip for Now
Search provider
Skip for Now
Configure skills now? (recommended)
No
Enable hooks?
Skip for now
How do you want to hatch your bot?
Do this later
Ok, the setup is ready. Let's confirm by looking at the default model, run:
openclaw models
You should see something like:
It is important that the default model is the one we set during onboard.
If everything is as expected, we can proceed to play with the agent.
In one terminal run :
openclaw gateway
This is like "run the server" to start playing with an agent.
In another terminal run:
openclaw tui
This is like "open a client" to chat with the agent.
Once is ready type something, like "Hello". If you are lucky enough, you should receive a response:
And there you go. You can start playing and interacting with OpenClaw.
So now you can chat with the agent. The agent will guide you on how to define the behavior, the personality, and the tasks to do. You can continue exploring on your own from this point.
Hopefully, this tutorial was useful and saved you some time :)
You created an API KEY in Google AI Studio, make sure you set a budget, (let's say of 1 dollar for example), so you dont have surprises after some time using the agent. Although it is said free tier of this API KEY from google is good, it's better to be safe on that.
If you need to keep working with OpenClaw on windows, or OpenClaw in general I would advice to be patient, it's likely you'll find things don't work in the way it should. I came up with this guide with a mix of trial-and-error, Geminis' help and testing with help from OpenClaw CLI.
I tried to make this guide easy and practical, I consider I am not doing anything risky in the proposed setup, but feel free to comment if I am missing something or something else should be considered for starters.
For some reason I couldn't finish the "npm openclaw" processes with CTRL+C as usual. I had to use the following command in PowerShell to kill the processes when needed
taskkill /F /IM node.exe /T It is not best, but it is what it works by now.