/behavior

namespace: aiwg
name: behavior
platforms: [all]
description: Manage AIWG behavior bundles that bind reactive directives and toolset configurations to specific agent types

Behavior

You manage AIWG behavior bundles — YAML artifacts that bind reactive directives and toolset configurations to specific agent types. Behaviors are the newest AIWG artifact type and are primarily deployed to OpenClaw (`~/.openclaw/behaviors/`).

Triggers

Alternate expressions and non-obvious activations (primary phrases are matched automatically from the skill description):

• "what behaviors are installed" → list subcommand
• "show me the coding-strict behavior" → info subcommand
• "apply strict mode to the software-implementer" → apply subcommand
• "remove the no-internet behavior from my agent" → remove subcommand
• "behavior bundles" → list subcommand

Trigger Patterns Reference

| Pattern | Example | Action | |---------|---------|--------| | List behaviors | "list behaviors" | Run `aiwg behavior list` | | Show detail | "show behavior coding-strict" | Run `aiwg behavior info coding-strict` | | Apply behavior | "apply coding-strict to software-implementer" | Run `aiwg behavior apply coding-strict --to software-implementer` | | Remove behavior | "remove coding-strict from software-implementer" | Run `aiwg behavior remove coding-strict --from software-implementer` | | Inspect source | "where are behaviors stored?" | Check `agentic/code/*/behaviors/` and `~/.openclaw/behaviors/` |

Behavior

When triggered:

1. **Extract intent**:

• Which subcommand: `list`, `info`, `apply`, or `remove`?
• Is a behavior name mentioned?
• Is an agent type mentioned (for `apply`/`remove`)?

2. **Run the appropriate command**:

   # List all available behaviors
   aiwg behavior list

   # Show details for a specific behavior
   aiwg behavior info <name>

   # Apply a behavior to an agent type
   aiwg behavior apply <name> --to <agent-type>

   # Remove a behavior from an agent type
   aiwg behavior remove <name> --from <agent-type>

3. **Understand behavior structure**: A behavior YAML bundle contains three sections:

• `directives` — What the agent should always do or avoid in this operational context
• `toolset` — Tool permissions and configuration overrides for this context
• `inputs` — Variable parameters the behavior accepts at apply time

4. **Know the storage locations**:

• **Source**: `agentic/code/*/behaviors/` (version-controlled, ships with framework)
• **Deployed**: `~/.openclaw/behaviors/` (active, read by OpenClaw at runtime)
• Deployment happens automatically during `aiwg use` for OpenClaw targets

5. **Report results** — For `list`, show name and description for each. For `info`, show the full bundle structure. For `apply`/`remove`, confirm the change.

Examples

Example 1: List available behaviors

**User**: "What behaviors are available?"

**Extraction**: List request, no filter

**Action**:

aiwg behavior list

**Response**: "3 behaviors available:

• `coding-strict` — Enforce code review, no direct pushes, require tests before merge
• `no-external-calls` — Block all outbound HTTP; toolset restricted to Read/Write/Edit/Bash(local)
• `audit-mode` — Read-only directives, all writes logged to `.aiwg/audit/`, no destructive operations"

---

Example 2: Inspect a specific behavior

**User**: "Show me what coding-strict does"

**Extraction**: Info request for `coding-strict`

**Action**:

aiwg behavior info coding-strict

**Response**: Shows the full YAML bundle — directives (require tests, no force push, enforce PR review), toolset (Read, Write, Edit, Bash with git restrictions), and any input variables.

---

Example 3: Apply a behavior

**User**: "Apply no-external-calls to the software-implementer agent"

**Extraction**: Apply `no-external-calls` to `software-implementer`

**Action**:

aiwg behavior apply no-external-calls --to software-implementer

**Response**: "Applied `no-external-calls` to `software-implementer`. Deployed to `~/.openclaw/behaviors/software-implementer/no-external-calls.yaml`. Outbound HTTP is now blocked for that agent type."

---

Example 4: Remove a behavior

**User**: "Remove coding-strict from the test-engineer"

**Extraction**: Remove `coding-strict` from `test-engineer`

**Action**:

aiwg behavior remove coding-strict --from test-engineer

**Response**: "Removed `coding-strict` from `test-engineer`. The behavior file has been deleted from `~/.openclaw/behaviors/test-engineer/`."

Clarification Prompts

If the user's intent is ambiguous:

• "Which behavior would you like to inspect? (run `aiwg behavior list` to see all available)"
• "Which agent type should this behavior be applied to?"
• "Did you mean to `apply` this behavior or just view it with `info`?"

References

• @$AIWG_ROOT/src/cli/handlers/daemon.ts — Behavior command handler
• @$AIWG_ROOT/docs/cli-reference.md — CLI reference
• @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/agent-deployment.md — Agent deployment rule
• @$AIWG_ROOT/docs/development/aiwg-development-guide.md — Source vs output boundary (behaviors are source artifacts in `agentic/code/*/behaviors/`)