Course file
week17_openclaw_basics/README.md
You've been building agents on your laptop. Now you deploy one to a real server that runs 24/7.
OpenClaw is an open-source AI agent platform. You give it a personality (SOUL.md), tell it what it can do (skills), connect it to chat channels (like Telegram), and it runs on its own.
This week: get it running, understand the file structure, and write your first skill.
Get a parent for this step — you'll need a credit card for DigitalOcean ($12/month).
Open your terminal and connect:
ssh root@YOUR_IP_ADDRESS
Replace YOUR_IP_ADDRESS with the actual IP from Step 1.
If it asks about fingerprint authenticity, type yes.
Stuck? If SSH doesn't work, paste the error into Claude: "I'm trying to SSH into my DigitalOcean droplet and got this error: [paste]"
Once you're SSH'd in, run the setup wizard:
/opt/openclaw-tui.sh
This opens a text menu. Follow the prompts:
sk-ant-... key you've been usingTest it with a message:
openclaw chat "Hello, are you working?"
You should get a response. Your agent is alive.
Your OpenClaw agent lives in /opt/openclaw/workspace/. Let's look at what's there:
ls /opt/openclaw/workspace/
Key files:
SOUL.mdThis is your agent's personality and core instructions. It's like the system prompt but permanent. OpenClaw reads this file every time it handles a message.
cat /opt/openclaw/workspace/SOUL.md
IDENTITY.mdYour agent's name, who it is, how it should introduce itself.
cat /opt/openclaw/workspace/IDENTITY.md
TOOLS.mdDocuments what built-in tools the agent has access to.
cat /opt/openclaw/workspace/TOOLS.md
Skills are modular abilities you add to your agent. Each skill is a folder with a SKILL.md file.
ls /opt/openclaw/workspace/skills/
A skill is just a markdown file that tells OpenClaw how to do something. Let's make one.
Pick a topic you know about — a school subject, a hobby, a game, anything.
Create the skill folder:
mkdir -p /opt/openclaw/workspace/skills/my_first_skill
Create the skill file:
nano /opt/openclaw/workspace/skills/my_first_skill/SKILL.md
Use this template (also available in this repo as my_first_skill/SKILL.md):
# My First Skill: [Topic Name]
## Purpose
Answer questions about [your topic] clearly and accurately.
## When to Use
When the user asks about [your topic].
## Behavior
- Answer in a friendly, clear way
- If you're not sure about something, say so
- Give examples when they help
## Knowledge
[Write 5-10 facts or pieces of information about your topic here.
The agent will use these when answering questions.]
1. ...
2. ...
3. ...
Save the file (in nano: Ctrl+O, Enter, Ctrl+X).
Test it:
openclaw chat "Tell me about [your topic]"
Make your agent yours. Open the SOUL.md:
nano /opt/openclaw/workspace/SOUL.md
Add some personality:
Save and test:
openclaw chat "Who are you and what can you help with?"
reflection.md.openclaw chat workingSKILL.md file (copy it to this folder in your repo too)reflection.md filled in"I'm setting up OpenClaw on DigitalOcean. I got to [step] and [what happened]. The error is: [paste]. How do I fix this?"
Also check the OpenClaw docs: https://github.com/openclawai/openclaw