Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Create new OpenClaw agents for Arch's multi-agent system. Use this skill when asked to create, add, or set up a new OpenClaw agent, or when adding an agent to the system defined in ~/.openclaw/. Covers the full lifecycle: directory creation, workspace files (SOUL.md, IDENTITY.md, etc.), openclaw.json config, Telegram routing (bindings + groups + mention patterns), cron job creation with proper prompt engineering, and gateway restart. Includes hard-won lessons from building the Wire (News) agent — the first non-default agent in the system. Also use when modifying existing agent configs, adding cron jobs to agents, or debugging agent routing issues.
Create new OpenClaw agents for Arch's multi-agent system. Use this skill when asked to create, add, or set up a new OpenClaw agent, or when adding an agent to the system defined in ~/.openclaw/. Covers the full lifecycle: directory creation, workspace files (SOUL.md, IDENTITY.md, etc.), openclaw.json config, Telegram routing (bindings + groups + mention patterns), cron job creation with proper prompt engineering, and gateway restart. Includes hard-won lessons from building the Wire (News) agent — the first non-default agent in the system. Also use when modifying existing agent configs, adding cron jobs to agents, or debugging agent routing issues.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Create and configure agents for Arch's OpenClaw multi-agent system at ~/.openclaw/.
Owner: Archit (Arch), Linux user archit, timezone America/Denver Gateway: Single process on port 18789 managing all agents Bot: One Telegram bot shared across all agents — routing determines which agent handles which chat Existing agents: Check ~/.openclaw/openclaw.json → agents.list[] for current roster Implementation history: See ~/.openclaw/implementation-docs/ for the Wire agent reference implementation
Before creating anything, clarify with Arch: Agent name and ID (lowercase, no spaces for ID) Role and responsibilities (specific, not vague) Model tier: cheap (Kimi K2.5 only) or full cascade (include Claude Sonnet) Whether it needs a Telegram group for Q&A Whether it needs cron jobs (what schedule, what tasks) Whether heartbeat should be enabled or disabled
openclaw gateway stop MANDATORY before editing openclaw.json or cron/jobs.json. The gateway actively writes to jobs.json (updating job state after each cron run). Editing while the gateway runs causes race conditions and data loss.
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup.$(date +%Y%m%d%H%M%S)
mkdir -p ~/.openclaw/workspace-<agent_id>/memory mkdir -p ~/.openclaw/agents/<agent_id>/agent NEVER reuse agentDir across agents — causes auth/session collisions.
Use templates from assets/templates/ as starting points. Every agent needs: FilePurposeRequiredSOUL.mdPersonality, role, responsibilities, behavioral modesYesIDENTITY.mdQuick-reference card (name, role, emoji)YesUSER.mdAbout Arch (copy from any existing agent workspace)YesAGENTS.mdWorkspace rules (boot sequence, memory, safety)YesHEARTBEAT.mdPeriodic task checklist (or comment if disabled)Yes SOUL.md is the most important file. Be specific about responsibilities. Include behavioral modes if the agent operates differently in different contexts (e.g., briefing mode vs chat mode).
Add to agents.list[]. See references/config-schema.md for all valid fields. Minimal entry: { "id": "<agent_id>", "name": "<Display Name>", "workspace": "/home/archit/.openclaw/workspace-<agent_id>", "agentDir": "/home/archit/.openclaw/agents/<agent_id>/agent", "identity": { "name": "<Display Name>" } } Common additions: "model" — Override the default model cascade. Exclude expensive models for worker agents. "heartbeat": { "every": "0" } — Disable heartbeat for cron-only agents. "groupChat": { "mentionPatterns": ["@<id>", "@<Name>"] } — Enable @mentions in groups. Only ONE agent should have "default": true (currently Fossil). The default agent receives all unrouted messages.
THREE separate config changes are required. Missing any one causes silent failures. See references/telegram-routing.md for the full explanation. Group config in channels.telegram.groups: "-100XXXXXXXXXX": { "requireMention": false } Binding in bindings[]: { "agentId": "<id>", "match": { "channel": "telegram", "peer": { "kind": "group", "id": "-100XXXXXXXXXX" } } } Mention patterns on the agent entry (already done in step 6 if groupChat was added).
Edit cron/jobs.json. Every cron job prompt MUST include: Dynamic group ID resolution preamble (NEVER hardcode Telegram group IDs): FIRST: Resolve your Telegram group ID by running: jq -r '.bindings[] | select(.agentId == "<agent_id>") | .match.peer.id' ~/.openclaw/openclaw.json Use the output as the target for all Telegram messages in this task. Date injection: $(date '+%A, %B %d, %Y') after the preamble Explicit constraints: source allowlists, recency rules, format templates Delivery instructions: use target='<AGENT_GROUP_ID>' placeholder (resolved by the preamble) This self-healing pattern ensures cron jobs survive Telegram group ID migrations. See references/prompt-patterns.md for full patterns and references/telegram-routing.md for why this matters. Critical: If copying files or prompts from another agent's workspace, grep for hardcoded paths and update them.
openclaw gateway start Verify in logs: Agent registered: agent registered: <id> Messages route correctly: lane enqueue: lane=session:agent:<id>:... If messages to a Telegram group show skip: no-mention, the channels.telegram.groups config is missing (see references/bugs-and-pitfalls.md).
FileWhen to Readreferences/config-schema.mdWhen writing agent config or cron jobsreferences/telegram-routing.mdWhen setting up Telegram group routingreferences/prompt-patterns.mdWhen writing cron job promptsreferences/bugs-and-pitfalls.mdWhen debugging issues or before any config edit
Starter templates for workspace files are in assets/templates/. Copy and customize per agent.
Workflow acceleration for inboxes, docs, calendars, planning, and execution loops.
Largest current source with strong distribution and engagement signals.