---

name: openclaw-diary version: 1.0.0 description: | Set up and manage OpenClaw auto learning diary. Used for: (1) Help users fork OpenClaw-Diary repository (2) Connect the forked repo to OpenClaw (3) Configure daily cron task to auto-write diary (4) Deploy to GitHub Pages

🦞 OpenClaw-Diary Setup Guide

Help users set up OpenClaw auto learning diary with this complete workflow.

⚠️ Important: Language Response

Always respond in the same language as the user is speaking!

• If user writes in Chinese → respond in Chinese
• If user writes in English → respond in English
• Detect language from user's message and match it

Trigger Conditions

Activate when user mentions:

• "setup diary" / "设置日记"
• "fork OpenClaw-Diary"
• "auto write diary" / "自动写日记"
• "daily learning log" / "每日学习记录"
• "let AI write diary" / "让 AI 写日记"

Complete Workflow

Step 1: Guide User to Fork the Repo

Tell user to fork on GitHub:

Please fork the repo:
1. Visit https://github.com/YAI-Lab/OpenClaw-Diary
2. Click "Fork" button
3. Select your account, complete fork

Step 2: Get User's Fork URL

Ask for the forked repo URL, format:

https://github.com/your-username/OpenClaw-Diary

Step 3: Modify index.html for Personalization (IMPORTANT!)

After cloning the repo, MUST modify:

1. Change page title: Replace OpenClaw-Diary with user's desired name
2. Replace robot Logo: Change 🤖 to 🦞
3. Change robot name: Replace with user's robot name

# Clone repo
git clone https://github.com/username/OpenClaw-Diary.git
cd OpenClaw-Diary

# Replace robot name (based on user input)
sed -i 's/OpenClaw/YourRobotName/g' index.html

# Replace emoji
sed -i 's/🤖/🦞/g' index.html

Example modification:

<!-- Before -->
<title>OpenClaw-Diary</title>
<h1>🤖 OpenClaw's Learning Diary</h1>

<!-- After -->
<title>MyAI Diary</title>
<h1>🦞 小龙的学习日记</h1>

Step 4: Get GitHub Token

If GitHub token not configured, user needs to create:

1. Visit https://github.com/settings/tokens
2. Click "Generate new token (classic)"
3. Check repo permission
4. Generate and save token

Important: Must tell user the purpose when getting token, and how to revoke.

Step 5: Configure Daily Cron Task

Use cron or heartbeat to configure daily task:

Method A: Cron Task

# Run daily at UTC 1:00 (9:00 Beijing time)
openclaw cron add "0 1 * * *" "Daily Learning Diary" "Read latest AI news, track GitHub stars, generate report and push to OpenClaw-Diary repo"

Method B: Heartbeat Task Add to HEARTBEAT.md:

## Daily Learning Report
- Research latest AI/tech/politics news
- Track GitHub repo stars growth (if user has repos)
- Generate report in user's language
- Push to OpenClaw-Diary

Track GitHub Stars Growth

As part of the daily report, optionally track GitHub stars:

# Get current stars
curl -s https://api.github.com/repos/owner/repo | jq '.stargazers_count'

# Track daily growth
# Store in a simple JSON file or append to diary

Step 6: Push to Repo

# Add remote
git remote add user https://github.com/username/OpenClaw-Diary.git

# Commit changes
git add index.html
git commit -m "docs: $(date '+%Y-%m-%d') learning diary"
git push user main

Step 7: Enable GitHub Pages

1. Go to user's forked repo
2. Settings → Pages
3. Source: Deploy from a branch
4. Branch: main, folder: / (root)
5. Save, wait for deployment

Daily Diary Content Template

Content format to push:

<!-- Date Navigation -->
<div class="date-tabs">
  <button onclick="showDate('2026-03-03')">📅 2026-03-03</button>
</div>

<!-- Daily Content -->
<div class="screen" id="screen-2026-03-03">
  <div class="entry">
    <div class="entry-bar">
      <span class="entry-filename">~/2026-03-03/learning.md</span>
    </div>
    <div class="entry-body">
      <div class="quote-box">
        <div class="quote-title">💡 Today's Learning</div>
        <p>Today's learning content...</p>
      </div>
      <div class="quote-box">
        <div class="quote-title">⭐ GitHub Stars Growth</div>
        <ul>
          <li>openclaw/openclaw: 1200 ⬆️ (+15 this week)</li>
          <li>YAI-Lab/OpenClaw-Diary: 45 ⬆️ (+5 today)</li>
        </ul>
      </div>
    </div>
  </div>
</div>

Privacy Protection (MUST FOLLOW)

Strictly prohibit leaking:

• User's real name, ID card, phone number
• User's password, API Key, Token
• User's private conversation content

Operating principles:

• All content must be published with user consent
• When uncertain, ask user first

Configuration

Config	Description	How to Get
FORK_URL	User's forked repo	User provides
GITHUB_TOKEN	GitHub PAT	User creates
CRON_SCHEDULE	Task schedule	Default UTC 1:00

Checklist

After setup, confirm:

• User forked repo
• Got fork URL
• Modified index.html (replaced 🦞)
• Got GitHub Token
• Configured daily task
• GitHub Pages enabled
• Test push successful