feat: add user preference persistence via click_preferences.md and API endpoint

Author: zhmzm

packages/server/src/index.ts

@@ -7,7 +7,7 @@ import { existsSync, readFileSync } from 'fs'
 import { dirname, join } from 'path'
 import { fileURLToPath } from 'url'
 import { promisify } from 'util'
-import { learnFromDeletions, learnFromRewrite, learnFromTrajectoryRevisions, learnFromCodeRejection, learnFromActionRejection, getLearnedPreferences, clearPreferences, deletePreference } from './preference.js'
+import { learnFromDeletions, learnFromRewrite, learnFromTrajectoryRevisions, learnFromCodeRejection, learnFromActionRejection, learnFromUserIntention, getUserPreferences, getLearnedPreferences, clearPreferences, deletePreference } from './preference.js'
 import { createSession, getSession, listSessions, completeSession, setSessionRewriting, updateSessionPageStatus, updateSessionPayload, updateSessionPayloadKeepStatus } from './store.js'
 import {
   buildMemoryCatalog,
@@ -607,6 +607,11 @@ app.get('/api/preferences', (_req, res) => {
   res.json({ preferences: getLearnedPreferences() })
 })
 
+// User style preferences from preferences.md
+app.get('/api/preferences/style', (_req, res) => {
+  res.type('text/plain').send(getUserPreferences())
+})
+
 app.delete('/api/preferences', (_req, res) => {
   clearPreferences()
   console.log('[agentclick] Cleared all learned preferences from MEMORY.md')
@@ -870,6 +875,12 @@ app.post('/api/sessions/:id/complete', async (req, res) => {
     const rewriteActions = (req.body.actions ?? []) as Array<{ type: string; paragraphId: string; reason?: string; instruction?: string; shouldLearn?: boolean }>
     learnFromDeletions(rewriteActions, session.payload as Record<string, unknown>)
     learnFromRewrite(rewriteActions, session.payload as Record<string, unknown>)
+    // Save userIntention to preferences.md
+    const userIntention = req.body.userIntention as string | undefined
+    if (userIntention) {
+      const scope = session.type?.replace('_review', '') ?? 'general'
+      learnFromUserIntention(userIntention, scope)
+    }
     res.json({ ok: true, rewriting: true })
     return
   }

packages/server/src/preference.ts

@@ -3,6 +3,52 @@ import path from 'path'
 import os from 'os'
 
 const MEMORY_PATH = path.join(os.homedir(), '.openclaw', 'workspace', 'MEMORY.md')
+const PREFERENCES_PATH = path.join(os.homedir(), '.openclaw', 'workspace', 'click_preferences.md')
+
+const SCOPE_SECTIONS: Record<string, string> = {
+  email: '## Email Reply Style',
+  trajectory: '## Trajectory',
+  code: '## Code Review',
+  action: '## Action Approval',
+}
+
+function ensurePrefFile(): void {
+  const dir = path.dirname(PREFERENCES_PATH)
+  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true })
+  if (!fs.existsSync(PREFERENCES_PATH)) {
+    fs.writeFileSync(PREFERENCES_PATH, '# AgentClick Preferences\n', 'utf-8')
+  }
+
+}
+
+export function getUserPreferences(): string {
+  if (!fs.existsSync(PREFERENCES_PATH)) return ''
+  return fs.readFileSync(PREFERENCES_PATH, 'utf-8')
+}
+
+export function learnFromUserIntention(intention: string, scope: string): void {
+  const trimmed = intention.trim()
+  if (!trimmed) return
+
+  ensurePrefFile()
+  const content = fs.readFileSync(PREFERENCES_PATH, 'utf-8')
+  const section = SCOPE_SECTIONS[scope] ?? `## ${scope}`
+  const rule = `- ${summarize(trimmed)}`
+
+  // Skip if exact rule already exists
+  if (content.includes(rule)) return
+
+  if (content.includes(section)) {
+    const lines = content.split('\n')
+    const idx = lines.findIndex(l => l === section)
+    lines.splice(idx + 1, 0, rule)
+    fs.writeFileSync(PREFERENCES_PATH, lines.join('\n'), 'utf-8')
+  } else {
+    fs.appendFileSync(PREFERENCES_PATH, `\n${section}\n${rule}\n`, 'utf-8')
+  }
+
+  console.log(`[agentclick] Saved user intention to click_preferences.md -> ${PREFERENCES_PATH}`)
+}
 const SECTION_HEADER = '## Email Preferences (ClickUI Auto-Learned)'
 const TRAJECTORY_SECTION_HEADER = '## Trajectory Guidance (ClickUI Auto-Learned)'
 const CODE_SECTION_HEADER = '## Code Review Preferences (ClickUI Auto-Learned)'

skills/clickui-approve/SKILL.md

@@ -7,6 +7,14 @@ description: Use this skill when you are about to take a consequential or irreve
 
 When you are about to take a high-risk action (sending messages, deleting data, calling external APIs), use these steps.
 
+## Preferences
+
+Before submitting an action for approval, fetch user preferences and apply any rules under `## Action Approval`:
+
+```bash
+curl -s "$AGENTCLICK_BASE/api/preferences/style"
+```
+
 ## Step 1: Submit for approval
 
 ```bash

skills/clickui-code/SKILL.md

@@ -7,6 +7,14 @@ description: Use this skill when you want to run a shell command that could be d
 
 Before running risky shell commands, get user approval via this skill. Always show the user exactly which files will change and what the diffs look like — this is the default, not optional.
 
+## Preferences
+
+Before submitting a command for review, fetch user preferences and apply any rules under `## Code Review`:
+
+```bash
+curl -s "$AGENTCLICK_BASE/api/preferences/style"
+```
+
 ## Step 1: Generate the diff
 
 Before submitting, capture the exact changes so the user can see them in the review UI.

skills/clickui-email/SKILL.md

@@ -31,6 +31,20 @@ If the task is email work plus live session handling in UI, use this skill over
 - Reply generation is lazy: generate only after the user clicks `Reply`.
 - The reply text comes from the agent's own generation unless the user wired some other drafting system explicitly.
 
+## Preferences
+
+Before opening a session, fetch user style preferences and apply any rules under `## Email Reply Style` to every reply draft in this session:
+
+```bash
+curl -s "$AGENTCLICK_BASE/api/preferences/style"
+```
+
+## Session Style Rules
+
+When the poll result includes `userIntention`, treat it as a **session-level style rule** — apply it to every subsequent reply draft in this session, not just the current one. It is also automatically saved to preferences by the server.
+
+Example: if `userIntention` is `"say Hiiii instead of Hi"`, every reply generated after that point must use "Hiiii".
+
 ## Step 1: Ensure AgentClick is running
 
 ```bash

skills/clickui-trajectory/SKILL.md

@@ -189,6 +189,14 @@ curl -s -X PUT "$AGENTCLICK_BASE/api/sessions/${SESSION_ID}/payload" \
 }
 ```
 
+## Preferences
+
+Before submitting a trajectory, fetch user preferences and apply any rules under `## Trajectory`:
+
+```bash
+curl -s "$AGENTCLICK_BASE/api/preferences/style"
+```
+
 ## Learning
 
 When a human marks a step wrong with "Remember this for future runs" checked, a rule is written to `~/.openclaw/workspace/MEMORY.md`: