| name | agent-creator |
| description | Create a new monoU agent and connect it to Gateway. Use when the user asks to create/new/spawn an agent (本地或远程). Supports one-command local creation, remote deploy, Windows persistent startup, and skill/persona customization. |
| entryScript | scripts/create-and-connect.sh |
Agent Creator
Create a new agent directory under agents/<agent_id>/, then start the agent app so it appears in Control UI.
Use This Skill When
- User asks: "create agent", "new agent", "新建智能体", "帮我拉起一个 agent"
- Need to create an agent on local machine or a remote host
Do not use cron tools for this workflow.
Fast Path (Local)
From monoU root:
AGENT_ID=<agent_id> GATEWAY_URL=ws://127.0.0.1:9347 \
.first_paramecium/skills/agent-creator/scripts/create-and-connect.sh
This will:
- Create
agents/<agent_id>/
- Copy base files/skills
- Start the agent app in background
Controlled Path (Local, custom persona/skills)
- Create directory only:
AGENT_DIR=$(pwd)/agents/<agent_id> MONOU_ROOT=$(pwd) \
SKILLS="base_skill memory cron" \
.first_paramecium/skills/agent-creator/scripts/create-agent-dir.sh
- Edit
SOUL.md / IDENTITY.md if needed
- Start:
nohup env GATEWAY_URL=ws://127.0.0.1:9347 AGENT_ID=<agent_id> \
AGENT_DIR=$(pwd)/agents/<agent_id> \
.first_paramecium/skills/agent-creator/scripts/start-agent-client.sh \
>> .gateway/agent-<agent_id>.log 2>&1 &
Remote Host Flow
Follow references/remote-new-host.md:
- Detect remote OS and whether monoU exists
- Copy monoU if missing (Linux/macOS: rsync, Windows: tar+scp)
- Build on remote
- Create agent dir and start client
If remote is Windows and you need persistence after SSH disconnect, use:
Important Rules
- Never mutate current running agent directory as target.
- Always create target under
agents/<agent_id>/.
- For remote connection, ensure
GATEWAY_URL is reachable from remote machine.
- Ask user for credentials; never hardcode secrets in scripts.
- Do not block on agentId confirmation. If user does not provide a clean id, auto-generate one and proceed, then report the final agentId.
- Accept noisy user input like
agentId=xxx（ by normalizing it before execution.
Script Index
scripts/create-and-connect.sh — one-command local flowscripts/create-agent-dir.sh — create directory onlyscripts/start-agent-client.sh — start agent app onlyscripts/deploy-to-remote.sh — sync repo to remotescripts/get-local-gateway-url.sh — print reachable Gateway URLscripts/start-remote-windows-agent.sh — Windows scheduled-task startup
References
