Aiwg behavior

Manage AIWG behavior bundles that bind reactive directives and toolset configurations to specific agent types

install
source · Clone the upstream repo
git clone https://github.com/jmagly/aiwg
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/jmagly/aiwg "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.agents/skills/behavior" ~/.claude/skills/jmagly-aiwg-behavior && rm -rf "$T"
manifest: .agents/skills/behavior/SKILL.md
source content

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

PatternExampleAction
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/
    )