クイックスタートガイド / Quick Start Guide
- 日本語
- English
- 简体中文
概要
OpenClawへようこそ!このガイドでは、あなたの最初の「自律型AIアシスタント(執事)」を立ち上げ、稼働させるための最短手順を、初心者の方でも絶対に迷わないように丁寧に解説します。
📊 全体の流れ
graph TD;
A[1. 準備 (Node.jsの確認)] --> B[2. OpenClawのインストール];
B --> C[3. ワークスペースの作成];
C --> D[4. APIキーの設定];
D --> E[5. エージェントの起動!];
Step 1: 必要なものの準備(前提条件)
まずは、お使いのパソコンに以下の環境が揃っているか確認しましょう。
- Node.js (バージョン18以上): OpenClawを動かすためのエンジンです。公式サイト からダウンロードしてインストールしてください。
- ターミナル(黒い画面): Macなら「ターミナル」、Windowsなら「コマンドプロンプト」または「PowerShell」を使用します。
- APIキー: AIの頭脳となる「Cerebras」や「OpenAI (ChatGPT)」のパスワードのようなものです。今回は無料で高速な Cerebras の利用を強く推奨します!
Step 2: OpenClawのインストール
ターミナルを開き、以下のコマンドをコピー&ペーストして Enter キーを押してください。
npm install -g openclaw
(※数分かかる場合があります。画面に文字が流れますが、エラーが出なければ成功です!)
Step 3: ワークスペースの初期化
AIエージェントの「仕事部屋(ワークスペース)」を作成します。あなたのPC内の好きな場所にフォルダを作り、そこで初期設定を行います。
# 1. 仕事部屋となるフォルダを作る
mkdir my-ai-assistant
# 2. そのフォルダの中に移動する
cd my-ai-assistant
# 3. OpenClawの初期データを展開する
openclaw init
Step 4: APIキーの設定(AIに頭脳を入れる)
展開されたフォルダの中に、agents/main/agent/auth-profiles.json という設定ファイルが作成されています。メモ帳やテキストエディタで開き、CEREBRAS_API_KEY の部分を取得したAPIキーに書き換えます。
{
"api_keys": {
"CEREBRAS_API_KEY": "ここをあなたのAPIキーに書き換えます(クォーテーションは残す)"
}
}
Step 5: エージェントの起動!🚀
さあ、いよいよあなたのAIアシスタントが目を覚まします。ターミナルで以下のコマンドを入力してください。
openclaw agent --agent main
🎉 成功です! 画面に「Agent is ready」といったメッセージが出れば、AIはあなたからの命令を待っている状態になります。
Overview
Welcome to OpenClaw! This guide will carefully explain the shortest path to getting your first "Autonomous AI Assistant (Butler)" up and running, ensuring even beginners won't get lost.
📊 Overall Workflow
graph TD;
A[1. Prerequisites (Check Node.js)] --> B[2. Install OpenClaw];
B --> C[3. Create Workspace];
C --> D[4. Configure API Key];
D --> E[5. Start the Agent!];
Step 1: Prerequisites
First, ensure your computer has the following environment ready:
- Node.js (v18 or higher): The engine to run OpenClaw. Download it from the Official Site.
- Terminal: Use "Terminal" on Mac or "Command Prompt / PowerShell" on Windows.
- API Key: Like a password for the AI's brain (e.g., Cerebras or OpenAI). We highly recommend using Cerebras initially for its generous free tier and speed!
Step 2: Install OpenClaw
Open your terminal, copy & paste the following command, and press Enter.
npm install -g openclaw
(※ It may take a few minutes. If you don't see any explicit errors, it's a success!)
Step 3: Initialize Workspace
Create an "office (workspace)" for your AI agent. Create a folder anywhere on your PC and initialize it.
# 1. Create a workspace folder
mkdir my-ai-assistant
# 2. Enter the folder
cd my-ai-assistant
# 3. Initialize OpenClaw files
openclaw init
Step 4: Configure API Key (Give the AI a Brain)
Inside your new folder, a configuration file named agents/main/agent/auth-profiles.json has been created. Open it with a text editor and replace the value for CEREBRAS_API_KEY with your actual key.
{
"api_keys": {
"CEREBRAS_API_KEY": "REPLACE_THIS_WITH_YOUR_ACTUAL_API_KEY_KEEPING_QUOTES"
}
}
Step 5: Start the Agent! 🚀
Now, it's time to wake up your AI assistant. Type the following command in your terminal:
openclaw agent --agent main
🎉 Success! If you see a message like "Agent is ready," your AI is now active and waiting for your commands.
概览
欢迎来到 OpenClaw!本指南将详细解答启动和运行您的第一个“自主 AI 助手(管家)”的最短路径,确保即使是初学者也不会迷路。
📊 整体工作流
graph TD;
A[1. 准备工作 (检查 Node.js)] --> B[2. 安装 OpenClaw];
B --> C[3. 初始化工作空间];
C --> D[4. 配置 API 密钥];
D --> E[5. 启动代理!];
第一步:准备工作(先决条件)
首先,请确保您的计算机上已准备好以下环境:
- Node.js(版本 18 或更高):运行 OpenClaw 的引擎。请从 官方网站 下载并安装。
- 终端(命令行):Mac 上使用“终端(Terminal)”,Windows 上使用“命令提示符”或“PowerShell”。
- API 密钥:相当于 AI 大脑的通行证(如 Cerebras 或 OpenAI (ChatGPT) 的密钥)。我们强烈推荐最初使用免费且高速的 Cerebras!
第二步:安装 OpenClaw
打开您的终端,复制并粘贴以下命令,然后按 Enter 键。
npm install -g openclaw
(※ 可能需要几分钟时间。屏幕上会滚动文字,如果没有出现错误信息,即表示安装成功!)
第三步:初始化工作空间
为您的 AI 代理创建一个“办公室(工作空间)”。在您的电脑任意位置创建一个文件夹,并在那里进行初始化设置。
# 1. 创建工作空间文件夹
mkdir my-ai-assistant
# 2. 进入该文件夹
cd my-ai-assistant
# 3. 部署 OpenClaw 的初始文件
openclaw init
第四步:配置 API 密钥(赋予 AI 大脑)
在您的新文件夹中,系统已生成一个名为 agents/main/agent/auth-profiles.json 的配置文件。使用记事本或文本编辑器打开它,并将 CEREBRAS_API_KEY 的部分替换为您获取到的 API 密钥。
{
"api_keys": {
"CEREBRAS_API_KEY": "在这里填入您的 API 密钥(保留双引号)"
}
}
第五步:启动代理!🚀
现在,您的 AI 助手终于要苏醒了。在终端中输入以下命令:
openclaw agent --agent main
🎉 成功! 如果屏幕上出现“Agent is ready”之类的消息,就意味着您的 AI 已经处于待命状态,可以随时接收您的命令了。