| name | qq-automation-admin |
| description | Manage QQ automation targets in openclaw.json as single source of truth for qq-automation-manager. |
| metadata | {"openclaw":{"emoji":"⏱️","disableModelInvocation":true}} |
qq-automation-admin
Use this skill when user wants to add/update/disable QQ proactive automation targets.
Design rule:
- Single source of truth is
${OPENCLAW_HOME}/openclaw.json.
- Only edit
plugins.entries["qq-automation-manager"].config.targets.
- Enforce agent-only mode: automation only triggers agent turns and records status.
- Never configure direct delivery fields (
delivery.*) in targets.
- Do not directly create/edit cron jobs with
openclaw cron add/edit during normal operations.
- 对于图片/文件/语音等产物型自动化,优先让目标 agent 直接产出可发送结果(如
MEDIA: 本地路径),由 QQ 插件按当前会话规则发送。
- 不把内部思考、计划、推理、自言自语或工具前分析发给用户。
Commands
List targets:
python3 ${OPENCLAW_HOME}/workspace/skills/qq-automation-admin/scripts/qq_auto_targets.py list
Create or update target:
python3 ${OPENCLAW_HOME}/workspace/skills/qq-automation-admin/scripts/qq_auto_targets.py upsert \
--id qq-user-123456789-weekday \
--route user:123456789 \
--cron "*/30 9-22 * * 1-5" \
--message "结合最近对话,自然延续当前关系与话题,给出一句有温度但不过界的主动消息。" \
--min-silence 30 \
--active-window 25 \
--random-min 30 \
--random-max 60
Disable target:
python3 ${OPENCLAW_HOME}/workspace/skills/qq-automation-admin/scripts/qq_auto_targets.py disable --id qq-user-123456789-weekday
Remove target:
python3 ${OPENCLAW_HOME}/workspace/skills/qq-automation-admin/scripts/qq_auto_targets.py remove --id qq-user-123456789-weekday
Migrate existing targets to agent-only mode:
python3 ${OPENCLAW_HOME}/workspace/skills/qq-automation-admin/scripts/qq_auto_targets.py migrate-agent-only
Audit targets for non-agent-only fields:
python3 ${OPENCLAW_HOME}/workspace/skills/qq-automation-admin/scripts/qq_auto_targets.py audit
Apply behavior
- Gateway usually auto-reloads config after write.
- If user asks immediate apply/verification, run:
openclaw gateway restart
Internal scheduler verification (agent-only mode):
python3 ${OPENCLAW_HOME}/workspace/skills/qq-automation-admin/scripts/qq_auto_targets.py verify --id qq-user-123456789-daylife
openclaw logs --follow | rg "qq-automation-manager|internal scheduler|triggered target|strictAgentOnly"
ls -la ${OPENCLAW_HOME}/workspace/qq_sessions/user__123456789/meta
cat ${OPENCLAW_HOME}/workspace/qq_sessions/user__123456789/meta/automation-latest.json
Verification expectations:
executionMode=agent-only
- no
delivery field on target
- manager writes
automation-latest.json and appends automation-state.ndjson
- required record fields include:
triggered/produced/skipped/sent_by_channel/trace
Note: manager uses internal scheduler (cron/every/at) and triggers route agent turns only.