初めてのタスク実行チュートリアル / Your First Task
- 日本語
- English
- 简体中文
🎯 ゴール
このチュートリアルでは、起動したAIエージェントに「はじめてのお仕事」をお願いし、成果物がファイルとして保存されるまでの一連の流れを体験します。
今日のお題:「今日のやることリストを作ってもらう」
Step 1: エージェントの起動
まだの場合は、前回のクイックスタートガイドの手順でエージェントを起動してください。
openclaw agent --agent main
Step 2: 自然言語で指示を出す
エージェントが起動したら、チャット画面に以下のような内容を入力して Enter を押します。
今日のやることリストを考えてください。
内容は以下の通りです:
- 朝のメールチェック
- プロジェクトAの資料作成
- 15時からのミーティング準備
- ブログ記事の下書き
これをMarkdown形式で「todo.md」というファイル名でワークスペースに保存してください。
Step 3: 結果を確認する
AIが処理を完了すると、ワークスペースのフォルダ内に todo.md というファイルが生成されているはずです。
# ファイルが作成されたか確認
ls -la todo.md
ファイルを開くと、AIが構成を考えて整理してくれたToDoリストが保存されているはずです。
🧪 もう少し高度な指示を試してみよう
エージェントの真価は「ファイルを作るだけ」にとどまりません。次のようなことも試してみてください。
例1: Webの情報を取得して要約する
「https://news.ycombinator.com」にアクセスして、
今日のトップ5のニュースタイトルを日本語に翻訳して、
summary.md に保存してください。
例2: 既存のファイルを分析する
ワークスペースにある todo.md を読んで、
各タスクに推定の所要時間を追加してください。
そして、1日のスケジュールとして時間割形式に並べ替えてください。
例3: スクリプトを書かせて実行する
Pythonで「現在の日時を表示するスクリプト」を書いて、
check_time.py として保存し、実行して結果を教えてください。
💡 コツ:指示は「具体的に」書く
AIの仕事の出来栄えは、あなたの指示の具体性に比例します。
| ❌ 曖昧な指示 | ✅ 具体的な指示 |
|---|---|
| 「なんかいい感じにして」 | 「Markdown形式で箇条書きにして」 |
| 「記事を書いて」 | 「1000文字以内で、見出しを3つつけて」 |
| 「ファイル作って」 | 「report.md というファイル名で保存して」 |
graph TD;
A[あなたの指示] --> B{AIが理解};
B -->|具体的 ✅| C[高品質な成果物];
B -->|曖昧 ❌| D[的外れな出力];
D --> E[やり直し指示が必要…];
🎯 Goal
In this tutorial, you'll assign a "first job" to your running AI agent and experience the workflow from instruction to deliverable saved as a file.
Today's Task: "Create a To-Do List"
Step 1: Start the Agent
If not already done, start your agent following the Quick Start guide:
openclaw agent --agent main
Step 2: Issue Instructions in Natural Language
Once the agent is running, type instructions like this into the chat:
Please create a to-do list for today.
The items are:
- Morning email check
- Create materials for Project A
- Prepare for the 3 PM meeting
- Draft a blog post
Save this in Markdown format as a file named "todo.md" in the workspace.
Step 3: Verify the Result
After the AI finishes, a file named todo.md should appear in your workspace folder.
# Verify the file was created
ls -la todo.md
Open the file to see the AI-organized To-Do list.
🧪 Try More Advanced Instructions
The agent's true power lies far beyond "just creating files." Try these:
Example 1: Fetch & Summarize Web Info
Access "https://news.ycombinator.com",
translate the top 5 headlines into Japanese,
and save them to summary.md.
Example 2: Analyze Existing Files
Read todo.md from the workspace,
add estimated time durations for each task,
and rearrange them into a daily schedule format.
Example 3: Write & Run a Script
Write a Python script that displays the current date and time,
save it as check_time.py, execute it,
and report the output to me.
💡 The Secret: Be Specific
The quality of the AI's output is directly proportional to how concrete your instructions are.
| ❌ Vague | ✅ Specific |
|---|---|
| "Make it look nice" | "Format in Markdown with bullet points" |
| "Write an article" | "Under 1000 words with 3 subheadings" |
| "Create a file" | "Save as report.md" |
graph TD;
A[Your Instruction] --> B{AI Interprets};
B -->|Specific ✅| C[High-quality Output];
B -->|Vague ❌| D[Off-target Result];
D --> E[Correction needed…];
🎯 目标
在本教程中,您将给正在运行的 AI 代理分配"第一个任务",亲身体验从下达指令到交付物保存为文件的全过程。
今日任务:"创建一份待办事项清单"
第一步:启动代理
如果尚未启动,请按照快速入门指南启动您的代理:
openclaw agent --agent main
第二步:用自然语言下达指令
代理启动后,在聊天界面中输入如下内容并按 Enter:
请为我创建今天的待办事项清单。
内容如下:
- 早间邮件检查
- 编写项目A的材料
- 准备下午3点的会议
- 撰写博客文章草稿
请以 Markdown 格式保存为名为 "todo.md" 的文件。
第三步:验证结果
AI 处理完成后,工作空间文件夹中应该会出现一个名为 todo.md 的文件。
# 确认文件是否已创建
ls -la todo.md
打开文件查看:AI 已经帮您思考了结构并整理好了清单。
🧪 尝试更高级的指令
代理的真正价值不仅仅停留在"创建文件"这一步。请继续尝试以下场景:
示例 1:获取网页信息并总结
请访问 "https://news.ycombinator.com",
将今天排名前5的新闻标题翻译成中文,
然后保存到 summary.md。
示例 2:分析现有文件
请读取工作空间中的 todo.md,
为每个任务添加预估完成时间,
然后将它们重新排列为每日时间表格式。
示例 3:编写并执行脚本
用 Python 编写一个"显示当前日期和时间"的脚本,
保存为 check_time.py,然后执行它,
并把结果报告给我。
💡 秘诀:指令越具体,质量越高
AI 输出成果的品质与您指令的具体程度成正比。
| ❌ 模糊的指令 | ✅ 清晰具体的指令 |
|---|---|
| "帮我弄好一点" | "以 Markdown 格式整理为列表" |
| "写篇文章" | "1000字以内,加3个小标题" |
| "创建个文件" | "以 report.md 文件名保存" |
graph TD;
A[您的指令] --> B{AI 理解};
B -->|具体 ✅| C[高质量交付物];
B -->|模糊 ❌| D[跑偏的输出];
D --> E[需要重新指示……];