Multi-Platform Integration

openclaw setup

openclaw gateway status      # View Gateway running status
openclaw logs --follow       # View real-time logs

openclaw channels add

openclaw gateway status      # View Gateway running status
openclaw gateway restart     # Restart Gateway to apply new configuration
openclaw logs --follow       # View real-time logs

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "docs:document.content:read",
      "event:ip_list",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}

# Ensure gateway.mode is set in the configuration file
{
  "gateway": {
    "mode": "local"
  }
}

# Method 1: Set token in the configuration file
{
  "gateway": {
    "auth": {
      "mode": "token",
      "token": "your-secure-token"
    }
  }
}

# Method 2: Use environment variables
export OPENCLAW_GATEWAY_TOKEN="your-secure-token"

# Install Feishu plugin
openclaw plugins install @openclaw/feishu

# Local checkout (run inside git repository)
openclaw plugins install ./extensions/feishu

openclaw channels add

{
  "channels": {
    "feishu": {
      "enabled": true,
      "dmPolicy": "pairing",
      "accounts": {
        "main": {
          "appId": "cli_xxx",
          "appSecret": "xxx",
          "botName": "我的AI助手"
        }
      }
    }
  }
}

export FEISHU_APP_ID="cli_xxx"
export FEISHU_APP_SECRET="xxx"

{
  "channels": {
    "feishu": {
      "domain": "lark",
      "accounts": {
        "main": {
          "appId": "cli_xxx",
          "appSecret": "xxx"
        }
      }
    }
  }
}

# Install and start the Gateway
openclaw gateway install

# Check Gateway status
openclaw gateway status

# View real-time logs
openclaw logs --follow

✅ Gateway: running (pid xxxxx, state active)
✅ Gateway target: ws://127.0.0.1:18789
✅ Source: local loopback

HEARTBEAT_OK
hi
connected | running
agent main | session main (heartbeat) | local-antigravity/gemini-3-pro-high

# View pending pairing requests
openclaw pairing list feishu

# Approve pairing (replace <pairing code> with the actual code received)
openclaw pairing approve feishu <pairing code>

# Example
openclaw pairing approve feishu ABC123

{
  "channels": {
    "feishu": {
      "dmPolicy": "open",
      "allowFrom": ["*"]
    }
  }
}

openclaw pairing list feishu           # View pending list
openclaw pairing approve feishu <CODE> # Approve

{
  "channels": {
    "feishu": {
      "groupPolicy": "open"
      // Default requireMention: true
    }
  }
}

{
  "channels": {
    "feishu": {
      "groups": {
        "oc_xxx": { "requireMention": false }
      }
    }
  }
}

{
  "channels": {
    "feishu": {
      "groupPolicy": "allowlist",
      "groupAllowFrom": ["ou_xxx", "ou_yyy"]
    }
  }
}

openclaw pairing list feishu

{
  "channels": {
    "feishu": {
      "enabled": true,
      "dmPolicy": "pairing",
      "accounts": {
        "bot1": {
          "appId": "cli_xxxxxxxxxxxxxxxx",
          "appSecret": "your-app-secret-1",
          "botName": "OpenClaw助手1",
          "enabled": true
        },
        "bot2": {
          "appId": "cli_yyyyyyyyyyyyyyyy",
          "appSecret": "your-app-secret-2",
          "botName": "OpenClaw助手2",
          "enabled": true
        }
      },
      "domain": "feishu",
      "groupPolicy": "open",
      "connectionMode": "websocket",
      "requireMention": true,
      "renderMode": "auto",
      "streaming": true,
      "blockStreaming": true,
      "replyToMode": "all"
    }
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "lan",
    "auth": {
      "mode": "token",
      "token": "your-secure-token-here"
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "your-provider/your-model"
      },
      "workspace": "/path/to/your/workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  }
}

{
  "channels": {
    "feishu": {
      "enabled": true,
      "dmPolicy": "pairing",
      "accounts": {
        "main-assistant": {
          "appId": "cli_main_xxxxxx",
          "appSecret": "your-main-secret",
          "botName": "主助理",
          "enabled": true
        },
        "content-creator": {
          "appId": "cli_content_xxxxxx",
          "appSecret": "your-content-secret",
          "botName": "内容创作助手",
          "enabled": true
        },
        "tech-dev": {
          "appId": "cli_tech_xxxxxx",
          "appSecret": "your-tech-secret",
          "botName": "技术开发助手",
          "enabled": true
        },
        "ai-news": {
          "appId": "cli_news_xxxxxx",
          "appSecret": "your-news-secret",
          "botName": "AI资讯助手",
          "enabled": true
        }
      },
      "domain": "feishu",
      "groupPolicy": "open",
      "connectionMode": "websocket",
      "requireMention": true,
      "streaming": true,
      "blockStreaming": true,
      "replyToMode": "all"
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-sonnet-4"
      },
      "workspace": "/path/to/workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  }
}

{
  "channels": {
    "feishu": {
      "accounts": {
        "tech-team": {
          "appId": "cli_tech_xxx",
          "appSecret": "tech_secret",
          "botName": "技术团队助手",
          "enabled": true
        },
        "sales-team": {
          "appId": "cli_sales_xxx",
          "appSecret": "sales_secret",
          "botName": "销售团队助手",
          "enabled": true
        },
        "hr-team": {
          "appId": "cli_hr_xxx",
          "appSecret": "hr_secret",
          "botName": "HR助手",
          "enabled": true
        }
      }
    }
  }
}

{
  "channels": {
    "feishu": {
      "accounts": {
        "production": {
          "appId": "cli_prod_xxx",
          "appSecret": "prod_secret",
          "botName": "OpenClaw生产环境",
          "enabled": true,
          "dmPolicy": "pairing"
        },
        "staging": {
          "appId": "cli_staging_xxx",
          "appSecret": "staging_secret",
          "botName": "OpenClaw测试环境",
          "enabled": true,
          "dmPolicy": "open"
        },
        "development": {
          "appId": "cli_dev_xxx",
          "appSecret": "dev_secret",
          "botName": "OpenClaw开发环境",
          "enabled": false
        }
      }
    }
  }
}

{
  "channels": {
    "feishu": {
      "accounts": {
        "general": {
          "appId": "cli_general_xxx",
          "appSecret": "general_secret",
          "botName": "通用助手",
          "enabled": true
        },
        "code-review": {
          "appId": "cli_code_xxx",
          "appSecret": "code_secret",
          "botName": "代码审查助手",
          "enabled": true
        },
        "document": {
          "appId": "cli_doc_xxx",
          "appSecret": "doc_secret",
          "botName": "文档助手",
          "enabled": true
        }
      }
    }
  }
}

{
  "agents": {
    "list": [
      {
        "id": "general-agent",
        "workspace": "/home/user/general",
        "agentDir": "/home/user/.openclaw/agents/general/agent"
      },
      {
        "id": "code-agent",
        "workspace": "/home/user/code-review",
        "agentDir": "/home/user/.openclaw/agents/code/agent"
      },
      {
        "id": "doc-agent",
        "workspace": "/home/user/document",
        "agentDir": "/home/user/.openclaw/agents/doc/agent"
      }
    ]
  },
  "channels": {
    "feishu": {
      "accounts": {
        "general": {
          "appId": "cli_general_xxx",
          "appSecret": "general_secret",
          "botName": "通用助手"
        },
        "code-review": {
          "appId": "cli_code_xxx",
          "appSecret": "code_secret",
          "botName": "代码审查助手"
        },
        "document": {
          "appId": "cli_doc_xxx",
          "appSecret": "doc_secret",
          "botName": "文档助手"
        }
      }
    }
  },
  "bindings": [
    {
      "agentId": "general-agent",
      "match": {
        "channel": "feishu",
        "account": "general"
      }
    },
    {
      "agentId": "code-agent",
      "match": {
        "channel": "feishu",
        "account": "code-review"
      }
    },
    {
      "agentId": "doc-agent",
      "match": {
        "channel": "feishu",
        "account": "document"
      }
    }
  ]
}

# View status of all Feishu accounts
openclaw channels list feishu

# Enable a specific account
openclaw channels enable feishu backup

# Disable a specific account
openclaw channels disable feishu test

# Restart a specific account
openclaw channels restart feishu main

# View logs for a specific account
openclaw logs --channel feishu --account main --follow

# Main configuration file
~/.openclaw/openclaw.json

# Or use independent channel configuration files
~/.openclaw/channels/feishu.json

# Create independent configuration file
mkdir -p ~/.openclaw/channels
nano ~/.openclaw/channels/feishu.json

{
  "enabled": true,
  "accounts": {
    "main": {
      "appId": "cli_xxx",
      "appSecret": "xxx",
      "botName": "主机器人"
    },
    "backup": {
      "appId": "cli_yyy",
      "appSecret": "yyy",
      "botName": "备用机器人"
    }
  }
}

# Check if the account is enabled
openclaw channels status feishu

# View logs for that account
openclaw logs --channel feishu --account main --follow

# Check if the configuration is correct
openclaw config get channels.feishu.accounts.main

# Restart the Gateway
openclaw gateway restart

# Or reload the configuration
openclaw channels reload feishu

Error: bindings.0.match: Unrecognized key: "account"

{
  "channels": {
    "feishu": {
      "accounts": {
        "bot1": { ... },
        "bot2": { ... }
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "your-model" },
      "workspace": "/path/to/workspace"
    }
  }
  // ❌ No bindings needed
}

# Run diagnostics
openclaw doctor

# If configuration issues are prompted, run auto-fix
openclaw doctor --fix

# Verify configuration
openclaw doctor
# Should see: ✅ Config valid

{
  "channels": {
    "feishu": {
      "streaming": true,      // Enable streaming card output (default true)
      "blockStreaming": true  // Enable block-level streaming (default true)
    }
  }
}

{
  "channels": {
    "feishu": {
      "replyToMode": "all",  // Account-level configuration (default "all")
      "groups": {
        "oc_xxx": {
          "replyToMode": "first"  // Specific groups can override
        }
      }
    }
  }
}

{
  "agents": {
    "list": [
      { "id": "main" },
      {
        "id": "clawd-fan",
        "workspace": "/home/user/clawd-fan",
        "agentDir": "/home/user/.openclaw/agents/clawd-fan/agent"
      },
      {
        "id": "clawd-xi",
        "workspace": "/home/user/clawd-xi",
        "agentDir": "/home/user/.openclaw/agents/clawd-xi/agent"
      }
    ]
  },
  "bindings": [
    {
      "agentId": "main",
      "match": {
        "channel": "feishu",
        "peer": { "kind": "dm", "id": "ou_28b31a88..." }
      }
    },
    {
      "agentId": "clawd-fan",
      "match": {
        "channel": "feishu",
        "peer": { "kind": "dm", "id": "ou_0fe6b1c9..." }
      }
    },
    {
      "agentId": "clawd-xi",
      "match": {
        "channel": "feishu",
        "peer": { "kind": "group", "id": "oc_xxx..." }
      }
    }
  ]
}

JSON5 parse error at line 443: Python True/False vs JSON true/false

# Check JSON syntax
cat ~/.openclaw/openclaw.json | python -m json.tool

# Common errors:
# ❌ "enabled": True   (Python syntax)
# ✅ "enabled": true   (JSON syntax)

# ❌ Extra comma
# ✅ No comma for the last item

# Error message
Gateway start blocked: set gateway.mode=local (current: unset)

# Solution: Add to configuration file
{
  "gateway": {
    "mode": "local"
  }
}

# Error message
Gateway auth is set to token, but no token is configured

# Solution 1: Configuration file
{
  "gateway": {
    "auth": {
      "mode": "token",
      "token": "your-secure-token"
    }
  }
}

# Solution 2: Environment variable
export OPENCLAW_GATEWAY_TOKEN="your-secure-token"

# Error message
Config validation failed: plugins.entries.qqbot: plugin not found: qqbot

# Solution: Remove configuration for uninstalled plugins
{
  "plugins": {
    "entries": {
      "feishu": {
        "enabled": true
      }
      // Remove qqbot, ddingtalk, wecom, etc. for uninstalled plugins
    }
  }
}

# Error message
run error: Error: ENOENT: no such file or directory, mkdir '/root'

# Solution: Correct workspace path (macOS example)
{
  "agents": {
    "defaults": {
      "workspace": "/Users/yourusername/clawd"  // Use the correct macOS path
    }
  }
}

# Error message
Port 18789 is already in use

# Solution 1: Stop existing Gateway
openclaw gateway stop

# Solution 2: Use a different port
{
  "gateway": {
    "port": 18790
  }
}

# Must restart Gateway after modifying configuration
openclaw gateway restart

# Or reload configuration
openclaw channels reload feishu

# Check if configuration is loaded correctly
openclaw config get channels.feishu

Features:
- Create documents
- Edit documents
- Share documents
- Permission management

Example:
You: Save this content to Lark Docs
OpenClaw: Saved to Lark Docs ✅
Link: https://...

Features:
- Create tables
- Add data
- Query data
- Data analysis

Example:
You: Add invoice information to the multi-dimensional table
OpenClaw: 3 records added ✅

Features:
- Create events
- Modify events
- Delete events
- Event reminders

Example:
You: Meeting tomorrow at 3 PM
OpenClaw: Added to Lark Calendar ✅

{
  "meta": {
    "lastTouchedVersion": "2026.2.6-3",
    "lastTouchedAt": "2026-02-08T09:49:58.322Z"
  },
  "channels": {
    "feishu": {
      "enabled": true,
      "dmPolicy": "pairing",
      "accounts": {
        "bot1": {
          "appId": "cli_xxxxxxxxxxxxxxxx",
          "appSecret": "your-app-secret-1",
          "botName": "OpenClaw助手1",
          "enabled": true
        },
        "bot2": {
          "appId": "cli_yyyyyyyyyyyyyyyy",
          "appSecret": "your-app-secret-2",
          "botName": "OpenClaw助手2",
          "enabled": true
        }
      },
      "domain": "feishu",
      "groupPolicy": "open",
      "connectionMode": "websocket",
      "requireMention": true,
      "renderMode": "auto",
      "streaming": true,
      "blockStreaming": true,
      "replyToMode": "all"
    }
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "lan",
    "auth": {
      "mode": "token",
      "token": "your-secure-random-token-here"
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "your-model-provider/your-model"
      },
      "workspace": "/path/to/your/workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4
    }
  },
  "plugins": {
    "entries": {
      "feishu": {
        "enabled": true
      }
    }
  }
}

# Start Gateway
openclaw gateway install

# Check status
openclaw gateway status

# Should see:
# ✅ Gateway: running (pid 57344, state active)
# ✅ Gateway target: ws://127.0.0.1:18789

You: hi
Bot: [Pairing Code] Please ask administrator to approve pairing

# View pairing requests
openclaw pairing list feishu

# Approve Bot 1
openclaw pairing approve feishu <Pairing code 1>

# Approve Bot 2
openclaw pairing approve feishu <Pairing code 2>

openclaw logs --follow

# Should see:
# HEARTBEAT_OK
# hi
# connected | running
# agent main | session main (heartbeat)

# Error: JSON5 parse error at line 443
# Cause: Used Python syntax (True/False) instead of JSON syntax (true/false)

# Check syntax
cat ~/.openclaw/openclaw.json | python -m json.tool

# Correction:
# ❌ "enabled": True
# ✅ "enabled": true

# Error: Gateway start blocked: set gateway.mode=local
# Solution: Ensure gateway.mode is configured

{
  "gateway": {
    "mode": "local"
  }
}

# Error: ENOENT: no such file or directory, mkdir '/root'
# Cause: Linux path used in configuration file, but actual OS is macOS

# Correction (macOS):
{
  "agents": {
    "defaults": {
      "workspace": "/Users/yourusername/clawd"
    }
  }
}

# Error: plugin not found: qqbot
# Cause: Configuration file referenced an uninstalled plugin

# Solution: Only keep installed plugins
{
  "plugins": {
    "entries": {
      "feishu": {
        "enabled": true
      }
      // Remove qqbot, ddingtalk, wecom, etc.
    }
  }
}

# Gateway status
$ openclaw gateway status
✅ Gateway: running (pid xxxxx, state active)
✅ Gateway target: ws://127.0.0.1:18789

# Log output
$ openclaw logs --follow
HEARTBEAT_OK
hi
connected | running
agent main | session main (heartbeat) | your-model-provider/your-model
tokens 25k/200k (13%)

# 1. Run configuration wizard
openclaw onboard

# 2. Select configuration options
# - Select Yes to accept risks
# - Select QuickStart

# 3. Configure model
# - Select model provider (e.g., Moonshot AI)
# - Enter API Key
# - Select default model (e.g., kimi-code/kimi-for-codi)

# 4. Configure channel
# - Select channel: QQ
# - Enter Bot ID (BotAppID)
# - Enter Bot Secret

# 5. Configure Skills and Hooks
# - Skills: Select Yes, can skip installation for now
# - Hooks: Select session-memory

# 6. Restart service
# - Select Yes to restart gateway service

# 7. Test connection
# - Select to open TUI (terminal user interface)
# - Or test directly in QQ

# Edit configuration file
nano ~/.openclaw/config.json

# Add QQ configuration
{
  "channels": {
    "qq": {
      "enabled": true,
      "botAppId": "你的机器人ID",
      "botSecret": "你的机器人密钥",
      "profiles": ["default"]
    }
  }
}

# Restart service
systemctl --user restart openclaw-gateway.service

# Method 1: Foreground run (for testing)
openclaw gateway --port 18789 --verbose

# Method 2: Background run (recommended)
nohup openclaw gateway --port 18789 --verbose > /dev/null 2>&1 &

# Method 3: Use systemd (most stable)
systemctl --user enable openclaw-gateway.service
systemctl --user start openclaw-gateway.service

# View service status
systemctl --user status openclaw-gateway.service

# View logs
journalctl --user -u openclaw-gateway.service -f

# Test connection
# Send a message to the bot in QQ: "Hello"

Features:
- Daily conversation
- Information query
- Task reminders
- Entertainment interaction

Usage example:
You: What's the weather like today?
OpenClaw: It's sunny today, 15-25°C

You: Remind me to submit homework tomorrow
OpenClaw: Reminder set ✅

Features:
- Group announcements
- Member management
- Message statistics
- Auto-reply

Usage example:
Admin: @OpenClaw Post announcement
OpenClaw: Announcement posted ✅

Member: @OpenClaw Query group rules
OpenClaw: Group rules are as follows...

Features:
- Chat conversation
- Tell jokes
- Guess riddles
- Play games

Usage example:
You: Tell a joke
OpenClaw: Okay, listen to this...

You: Guess a riddle
OpenClaw: What is it that...

⚠️ QQ bots have the following limitations:
- Message frequency limits
- Feature permission limits
- Strict review requirements
- Some APIs require application
- Currently does not support actively sending messages (tested 2026.2.6)

✅ Comply with platform rules
✅ Do not send illegal content
✅ Use API reasonably
✅ Respond to users promptly
✅ Regularly check service status

https://discord.com/developers/applications

# Old command (for reference only)
clawdbot onboard

# New command (recommended)
openclaw onboard

# Configuration process:
# 1. Select Yes to accept risks
# 2. Select QuickStart
# 3. Configure model (e.g., GLM 4.7)
# 4. Select channel: Discord
# 5. Enter Bot Token
# 6. Configure Skills and Hooks

# Old command
clawdbot gateway --port 18789 --verbose

# New command
openclaw gateway --port 18789 --verbose

# Background run
nohup openclaw gateway --port 18789 --verbose > /dev/null 2>&1 &

# 1. Private message the Bot in Discord to get the pairing code
# 2. Stop Gateway service (Ctrl+C)
# 3. Run pairing command (old version)
clawdbot pairing approve discord <Pairing code>

# New command (needs confirmation)
openclaw pairing approve discord <Pairing code>

# 4. Restart Gateway
openclaw gateway --port 18789 --verbose

1. Find your Bot in Discord
2. Click on the Bot's avatar
3. Click "Send Message"
4. Send messages directly

1. @mention the Bot in the channel
2. Type your question
3. The Bot will reply to you

Example:
@MyBot What's the weather like today?

✅ Suitable Scenarios:
- Modern office
- Document collaboration
- Knowledge management
- Team collaboration
- Technical teams

❌ Not Suitable For:
- Traditional enterprises
- Simple requirements

✅ Suitable Scenarios:
- Internal enterprise use
- Needs interoperability with WeChat
- Customer service
- Marketing and promotion

❌ Not Suitable For:
- Pure personal use
- Requires complex document collaboration

✅ Suitable Scenarios:
- Enterprise office
- Attendance management
- Approval workflows
- Project management

❌ Not Suitable For:
- Personal entertainment
- Social interaction

✅ Suitable Scenarios:
- Personal use
- Social interaction
- Entertainment features
- Student groups

❌ Not Suitable For:
- Enterprise office
- Formal occasions

Work: Lark/WeCom/DingTalk
Life: QQ

Advantages:
- Separation of work and life
- Higher focus
- Easier management

Connect to all platforms simultaneously

Advantages:
- Covers all users
- Use anytime, anywhere
- Complementary features

Disadvantages:
- High maintenance cost
- Scattered messages

Primary Platform: Lark (daily use)
Secondary Platform: WeCom (customer communication)

Advantages:
- Clear focus
- Controllable costs
- Easy to manage

{
  "bindings": [
    {
      "agentId": "main-agent",
      "match": {
        "channel": "feishu",
        "peer": {
          "kind": "group",
          "id": "oc_xxx"
        }
      }
    }
  ]
}

┌─────────────────────────────────────────────────────────┐
│                      Lark (Feishu)                       │
├─────────────────────────────────────────────────────────┤
│  机器人1: 主助理          机器人2: 内容创作助手          │
│  机器人3: 技术开发助手    机器人4: AI资讯助手            │
└─────────────────────────────────────────────────────────┘
                          ↓ WebSocket
┌─────────────────────────────────────────────────────────┐
│                   OpenClaw Gateway 层                    │
├──────────────┬──────────────┬──────────────┬────────────┤
│ Gateway 1    │ Gateway 2    │ Gateway 3    │ Gateway 4  │
│ 端口: 18789  │ 端口: 18790  │ 端口: 18791  │ 端口: 18792│
│ Profile:     │ Profile:     │ Profile:     │ Profile:   │
│ main-        │ content-     │ tech-dev     │ ai-news    │
│ assistant    │ creator      │              │            │
└──────────────┴──────────────┴──────────────┴────────────┘
                          ↓
┌─────────────────────────────────────────────────────────┐
│                      Agent 层                            │
├──────────────┬──────────────┬──────────────┬────────────┤
│ main-agent   │ content-agent│ tech-agent   │ainews-agent│
│ Claude Opus  │ Claude Sonnet│ Claude Sonnet│ Gemini 2.5 │
│ 4.6 Thinking │ 4.5          │ 4.5 Thinking │ Flash      │
└──────────────┴──────────────┴──────────────┴────────────┘

mkdir -p agent-configs/{main-agent,content-agent,tech-agent,ainews-agent}

# User Information

- Name: Maynor
- Occupation: Solopreneur
- Work Area: AI technology, content creation, technical development

# Agent Identity

You are Maynor's main assistant, responsible for handling various complex tasks. Use the Claude Opus 4.6 Thinking model to provide the highest quality service.

# Download configuration script
curl -O https://example.com/setup-multi-gateway.sh
chmod +x setup-multi-gateway.sh

# Run configuration script
./setup-multi-gateway.sh

# Start all Gateways
./start-all-gateways.sh

# Check status
./check-gateways.sh

# Verify configuration
./verify-setup.sh

# View status of all Gateways
./check-gateways.sh

# View real-time logs
tail -f logs-main-assistant.log
tail -f logs-content-creator.log
tail -f logs-tech-dev.log
tail -f logs-ai-news.log

# View all logs
tail -f logs-*.log

# Restart all
./stop-all-gateways.sh
sleep 2
./start-all-gateways.sh

# Restart a single one
ps aux | grep "openclaw.*--profile main-assistant"
kill <PID>
./start-main-assistant.sh

# Edit configuration
vim ~/.openclaw-main-assistant/openclaw.json

# Verify configuration
jq . ~/.openclaw-main-assistant/openclaw.json

# Restart to take effect
# (Stop and restart the corresponding Gateway)

# View memory usage
ps aux | grep openclaw-gateway | awk '{print $4, $11}'

# View CPU usage
ps aux | grep openclaw-gateway | awk '{print $3, $11}'

# View port usage
lsof -i :18789
lsof -i :18790
lsof -i :18791
lsof -i :18792

# 1. View logs
tail -50 logs-main-assistant.log

# 2. Check configuration
jq . ~/.openclaw-main-assistant/openclaw.json

# 3. Check port usage
lsof -i :18789

# 4. Run doctor
openclaw --profile main-assistant doctor

# 1. Check if Gateway is running
./check-gateways.sh

# 2. View real-time logs
tail -f logs-main-assistant.log

# 3. Check Lark connection
grep "WebSocket client started" logs-main-assistant.log

# Check configuration
jq '.agents.list[0].id, .agents.list[0].model.primary' \
  ~/.openclaw-content-creator/openclaw.json

# Should output:
# "content-agent"
# "local-antigravity/claude-sonnet-4-5"

# Create a tmux session
tmux new -s openclaw

# Split windows
Ctrl+b %  # Vertical split
Ctrl+b "  # Horizontal split

# Run different Gateways in different windows
./start-main-assistant.sh
./start-content-creator.sh
./start-tech-dev.sh
./start-ai-news.sh

# View all logs
tail -f logs-*.log

# Create plist file
cat > ~/Library/LaunchAgents/com.openclaw.main-assistant.plist << 'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key>
  <string>com.openclaw.main-assistant</string>
  <key>ProgramArguments</key>
  <array>
    <string>/usr/local/bin/openclaw</string>
    <string>--profile</string>
    <string>main-assistant</string>
    <string>gateway</string>
    <string>run</string>
  </array>
  <key>RunAtLoad</key>
  <true/>
  <key>KeepAlive</key>
  <true/>
</dict>
</plist>
EOF

# Load service
launchctl load ~/Library/LaunchAgents/com.openclaw.main-assistant.plist

# Create log rotation script
cat > rotate-logs.sh << 'EOF'
#!/bin/zsh
for log in logs-*.log; do
  if [ -f "$log" ] && [ $(stat -f%z "$log") -gt 10485760 ]; then
    mv "$log" "$log.$(date +%Y%m%d_%H%M%S)"
    touch "$log"
  fi
done
EOF

chmod +x rotate-logs.sh

# Add to crontab (execute hourly)
crontab -e
# Add: 0 * * * * /path/to/rotate-logs.sh

{
  "agents": {
    "list": [
      {
        "id": "agent-id",
        "workspace": "/path/to/workspace",
        "model": {
          "primary": "provider/model"
        }
      }
    ],
    "defaults": {
      "compaction": { "mode": "safeguard" },
      "maxConcurrent": 4
    }
  },
  "channels": {
    "feishu": {
      "accounts": {
        "bot-name": { ... }
      }
    }
  },
  "bindings": [
    {
      "agentId": "agent-id",
      "match": {
        "channel": "feishu",
        "peer": {
          "kind": "dm",
          "id": "ou_user_id"
        }
      }
    }
  ]
}

{
  "agents": {
    "list": [
      {
        "id": "main-agent",
        "workspace": "/Users/username/clawd",
        "model": {
          "primary": "anthropic/claude-sonnet-4"
        }
      },
      {
        "id": "content-agent",
        "workspace": "/Users/username/clawd/content",
        "model": {
          "primary": "anthropic/claude-sonnet-4"
        }
      },
      {
        "id": "tech-agent",
        "workspace": "/Users/username/clawd/tech",
        "model": {
          "primary": "anthropic/claude-sonnet-4"
        }
      },
      {
        "id": "ainews-agent",
        "workspace": "/Users/username/clawd/ainews",
        "model": {
          "primary": "google/gemini-2-flash"
        }
      }
    ],
    "defaults": {
      "compaction": { "mode": "safeguard" },
      "maxConcurrent": 4,
      "subagents": { "maxConcurrent": 8 }
    }
  },
  "channels": {
    "feishu": {
      "accounts": {
        "main-assistant": {
          "appId": "cli_main_xxx",
          "appSecret": "xxx",
          "botName": "主助理"
        },
        "content-creator": {
          "appId": "cli_content_xxx",
          "appSecret": "xxx",
          "botName": "内容创作助手"
        },
        "tech-dev": {
          "appId": "cli_tech_xxx",
          "appSecret": "xxx",
          "botName": "技术开发助手"
        },
        "ai-news": {
          "appId": "cli_news_xxx",
          "appSecret": "xxx",
          "botName": "AI资讯助手"
        }
      }
    }
  },
  "bindings": [
    {
      "agentId": "main-agent",
      "match": {
        "channel": "feishu",
        "peer": { "kind": "dm", "id": "ou_xxx1" }
      }
    },
    {
      "agentId": "content-agent",
      "match": {
        "channel": "feishu",
        "peer": { "kind": "dm", "id": "ou_xxx2" }
      }
    },
    {
      "agentId": "tech-agent",
      "match": {
        "channel": "feishu",
        "peer": { "kind": "dm", "id": "ou_xxx3" }
      }
    },
    {
      "agentId": "ainews-agent",
      "match": {
        "channel": "feishu",
        "peer": { "kind": "dm", "id": "ou_xxx4" }
      }
    }
  ]
}

# 1. Start gateway and view logs
openclaw gateway restart
openclaw logs --follow

# 2. Send messages to each bot in Lark

# 3. Find open_id in logs
# Format: ou_xxxxxxxxxxxxxxxx

[feishu] Received message from ou_18d36d8a49c010dfe20ace2a29250c04
[feishu] Bot: 主助理

openclaw pairing list feishu

# Output example:
# Pending pairing requests:
# - Code: ABC123, User: ou_xxx, Bot: 主助理

mkdir -p /Users/username/clawd/content
mkdir -p /Users/username/clawd/tech
mkdir -p /Users/username/clawd/ainews

# Backup existing configuration
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup

# Apply new configuration
cp your-config.json ~/.openclaw/openclaw.json

# Verify configuration
openclaw doctor

# Restart gateway
openclaw gateway restart

# View Agent status
openclaw doctor

# Should see:
# Agents: main-agent (default), content-agent, tech-agent, ainews-agent
# Session store: 4 entries

# View logs
openclaw logs --follow | grep bindings

# Should see:
# [bindings] Matched agent: main-agent for user ou_xxx

{
  "id": "agent-id",           // ✅ Agent identifier (required)
  "workspace": "/path",       // ✅ Workspace path (required)
  "model": { "primary": "" }  // ✅ Model to use (optional)
  // ❌ Cannot contain compaction
  // ❌ Cannot contain maxConcurrent
  // ❌ Cannot contain subagents
  // ❌ Cannot contain models
}

{
  "agents": {
    "list": [
      {
        "id": "main-agent",
        "workspace": "/path",
        "compaction": { "mode": "safeguard" },  // ❌ Error!
        "maxConcurrent": 4                       // ❌ Error!
      }
    ]
  }
}

{
  "agents": {
    "list": [
      {
        "id": "main-agent",
        "workspace": "/path",
        "model": { "primary": "provider/model" }  // ✅ Correct
      }
    ],
    "defaults": {
      "compaction": { "mode": "safeguard" },  // ✅ Configure here
      "maxConcurrent": 4,                     // ✅ Configure here
      "subagents": { "maxConcurrent": 8 }     // ✅ Configure here
    }
  }
}