Skip to content

ما الذي يحدث في هذا القسم

ستقوم بتسجيل كل وكيل في OpenClaw وإعطائه أمره الأول. بنهاية هذا القسم، سيكون جميع الوكلاء الستة نشطين — يُرسلون تقاريرهم إلى قنوات Discord الخاصة بهم وجاهزين لتلقّي تعليماتك.

طريقتان للتواصل مع وكلائك:

الطريقةالأنسب لـكيف تعمل
OpenGoat UIالمبتدئون — واجهة مرئيةلوحة تحكم في المتصفح، انقر لاختيار الوكيل، واكتب رسالتك
محطة VS Codeموصى بها — أسرع وأكثر تحكمًاopenclaw agent --agent [id] "your message"

كلتا الطريقتين تعملان. ابدأ بأيهما تشعر بالارتياح معها.

النهج الموصى به — هجين مع الذكاء الاصطناعي: عندما تبدأ للتو، احتفظ بنافذة محادثة مع Claude أو ChatGPT أو Gemini إلى جانب وكلائك. إذا لم يعمل أمر ما أو لم تكن متأكدًا مما تكتبه، فصِف الموقف للذكاء الاصطناعي واطلب منه المساعدة. هذا بالضبط كيف بدأ معظم الناس — بمن فيهم فريق BALIA OS. لست بحاجة إلى إتقان المحطة الطرفية في اليوم الأول. نافذة محادثة الذكاء الاصطناعي دائمًا في متناولك كمساعد.


كيف يعمل هذا القسم

الصق الطلب أدناه في Claude أو ChatGPT أو Gemini. سيرشدك الذكاء الاصطناعي خلال تسجيل جميع الوكلاء الستة وإرسال أول أمر لكل منهم. أرفق وثيقة تصميم الفريق حتى يعرف الذكاء الاصطناعي معرّفات وكلائك ومسارات workspace.

إذا حدث خطأ ما، صِف المشكلة أو التقط لقطة شاشة وشاركها — سيساعدك الذكاء الاصطناعي في حلها.


انسخ هذا الطلب والصقه في الذكاء الاصطناعي

أرفق وثيقة تصميم الفريق قبل الإرسال.

You are helping me register and launch my BALIA OS multi-agent team 
on OpenClaw.

I have attached my Team Design Document. Read it to get my agent IDs,
names, and workspace paths before starting.

My balia-os path is set in my .env file as BALIA_OS_PATH.
Please ask me to open my .env file and read the value of BALIA_OS_PATH,
then use that path throughout this session.

Guide me step by step. One step at a time. If I hit an error,
help me fix it before moving on. If I get stuck, ask me to share
a screenshot or paste the error message.

Here is what we need to do:

STEP 1 — Start the gateway
Tell me: "We'll start the OpenClaw gateway with a command that filters 
out noisy background logs so the terminal stays readable."

Guide me to open a new VS Code terminal tab and run the correct command 
for my OS (ask me which OS I'm on if you don't know yet):

Windows:
  $env:DEBUG="-ciao*"; openclaw gateway --force

Mac:
  DEBUG="-ciao*" openclaw gateway --force

Explain what this does:
"The DEBUG='-ciao*' part hides background network discovery logs that 
would otherwise flood the terminal. The --force flag clears any 
previous gateway instance. Your terminal will stay clean and readable."

Ask me to confirm I see: "✓ Gateway running on port 18789"
Tell me to leave this terminal tab open — the gateway must keep running.
If there's an error, help me fix it before moving on.

STEP 2 — Register each agent with OpenClaw
For each of my 6 agents (read IDs from Team Design Document),
guide me to run this command in the VS Code terminal:

openclaw agents add [agentid] --workspace ~/.openclaw/workspace-[agentid]

Example: openclaw agents add marcus --workspace ~/.openclaw/workspace-marcus

Show me all 6 commands at once with my actual agent IDs filled in.
Ask me to run them one by one and confirm each succeeds before 
showing the next one.

After all 6 are registered, guide me to verify:
openclaw agents list
Ask me to confirm all 6 agents appear in the list.

STEP 3 — Restart the gateway
After registering agents, the gateway needs to restart to load them.
Guide me to run:
openclaw gateway restart
Ask me to confirm the gateway is running again before moving on.

STEP 4 — Send first command via VS Code terminal (recommended)
Explain this first:
"The VS Code terminal is the recommended way to talk to your agents.
The command is:
openclaw agent --agent [agentid] 'your message here'

This sends a message directly to that specific agent."

Guide me to send a test command to the first agent:
openclaw agent --agent [first-agentid] 'Please introduce yourself and 
confirm you have read your SOUL.md, AGENTS.md, and IDENTITY.md. 
Then report to your Discord channel that you are online.'

Ask me: "What did the agent respond? 
Did you see a message appear in its Discord channel?"
If yes: great — move to next agent.
If no: help me troubleshoot.

Repeat for all 6 agents.

STEP 5 — (Optional) OpenGoat UI setup
After all agents are confirmed working via terminal, offer:
"You can also talk to your agents through the OpenGoat UI — 
a visual browser dashboard.
Would you like to set that up as well?
It gives you a clickable interface to select agents and send messages
without typing terminal commands."
If yes: guide me to:
1. Open a new VS Code terminal tab
2. Run: opengoat start
3. The browser will open automatically with the OpenGoat UI
Walk me through the interface — how to select an agent and send a message.
(If the browser doesn't open automatically, go to http://localhost:18789)
If no: skip and move to Step 6.

STEP 6 — Final confirmation
Run through this checklist with me:
□ All 6 agents registered (openclaw agents list shows all 6)
□ Gateway running (port 18789)
□ Each agent responded to first command
□ Each agent posted to their Discord channel
□ (Optional) OpenGoat UI accessible at localhost:18789

When all boxes are checked, say:
"Your BALIA OS team is live. All 6 agents are running and reporting 
to Discord. You're ready for Section 6 — Building Your First 
Skill Cassette."

Start now. Ask me the first question.

التواصل مع وكلائك يوميًا

بمجرد إعداد كل شيء، إليك كيفية إعطاء الأوامر:

تشغيل البوابة (افعل هذا أولًا في كل جلسة):

Windows:

$env:DEBUG="-ciao*"; openclaw gateway --force

Mac:

DEBUG="-ciao*" openclaw gateway --force

اترك هذه التبويبة في المحطة الطرفية تعمل. افتح تبويبة جديدة لبقية الأوامر.

عبر محطة VS Code:

# Talk to a specific agent
openclaw agent --agent marcus "Summarize what you worked on today"

# Check agent list
openclaw agents list

# Restart gateway if needed
openclaw gateway restart

عبر OpenGoat UI:

  1. افتح تبويبة جديدة في محطة VS Code
  2. شغّل: opengoat start
  3. سيفتح المتصفح تلقائيًا مع OpenGoat UI
  4. اختر الوكيل من اللوحة اليسرى
  5. اكتب رسالتك واضغط Enter (إذا لم يفتح المتصفح تلقائيًا: انتقل إلى http://localhost:18789)

عبر Discord (للتقارير فقط — ليس للأوامر): Discord هو المكان الذي يُرسل فيه وكلاؤك تقاريرهم. يمكنك قراءة تحديثاتهم هنا. إرسال الأوامر للوكلاء عبر Discord يتطلب Discord Bot — وهذا إعداد متقدم غير مشمول في T1. استخدم محطة VS Code أو OpenGoat UI لإعطاء الأوامر في الوقت الحالي.


إذا لم يستجب وكيل ما

تحقق من هذه الأمور بالترتيب:

  1. هل البوابة تعمل؟

    openclaw gateway restart
  2. هل الوكيل مسجَّل؟

    openclaw agents list

    إذا لم يكن وكيلك مدرجًا، أعِد تشغيل أمر agents add من الخطوة الثانية.

  3. هل ملفات workspace في المكان الصحيح؟ تحقق من وجود SOUL.md وAGENTS.md وIDENTITY.md في: ~/.openclaw/workspace-[agentid]/

  4. هل مفتاح API محدد بشكل صحيح؟ افتح .env وتأكد من أن ANTHROPIC_API_KEY مملوء.

إذا كنت لا تزال عالقًا، الصق رسالة الخطأ في Claude أو ChatGPT أو Gemini واطلب المساعدة.