社群运营与自动化系统

OpenClaw多Agent管理：从配置到实战从单体到多专才：打造你的AI助手团队重启所有Gateway批量操作#重启所有./stop-all-gateways.shsleep2./start-all-gateways.sh#验证配置jq.~/.openclaw-main-assistant/openclaw.json单个操作#查看进程psaux|grep"openclaw.*--profilemain-assistant"#强制停止kill-9[PID]#重启生效#（停止并重启对应的Gateway）监控资源占用查看内存&CPU#内存占用(MB)psaux|grepopenclaw-gateway|awk'{print$4,$11}'#CPU占用(%)psaux|grepopenclaw-gateway|awk'{print$3,$11}'查看端口占用#检查常用端口lsof-i:18789lsof-i:18790lsof-i:18791lsof-i:18792案例一：内容创作工作流场景：写一篇技术文章1.构思阶段私聊"主助理"：讨论主题和大纲模型：ClaudeOpus(深度思考)2.写作阶段私聊"内容创作助手"：撰写正文模型：ClaudeSonnet(快速生成)3.代码示例私聊"技术开发助手"：编写代码模型：ClaudeSonnetThinking(质量保障)4.资讯补充私聊"AI资讯助手"：获取最新动态模型：GeminiFlash(快速检索)案例二：技术开发工作流场景：开发一个新功能1.需求分析主助理：分析需求，设计架构2.代码实现技术开发助手：编写代码，调试问题3.文档编写内容创作助手：编写技术文档4.技术调研AI资讯助手：查找相关技术资料案例三：日常工作场景上午9:00-规划主助理：制定今天的工作计划上午10:00-写作内容创作助手：撰写文章下午2:00-开发技术开发助手：编写代码下午4:00-学习AI资讯助手：了解行业动态晚上8:00-总结主助理：总结今天的工作性能和成本：资源占用内存占用单个Gateway：约400MB4个Gateway总计：约1.6GB磁盘占用配置文件和日志约100MBCPU占用空闲时几乎为0处理任务时根据负载动态变化成本分析与优化建议Agent模型用途月使用量(tokens)月成本main-agentClaudeOpus4.6复杂任务100万$15content-agentClaudeSonnet4.5内容创作200万$6tech-agentClaudeSonnet4.5技术开发150万$4.5ainews-agentGemini2.5Flash资讯获取300万$0总计750万$25.5成本优化建议：简单任务使用GeminiFlash（免费）复杂任务才使用ClaudeOpus内容创作使用ClaudeSonnet（性价比高）故障排查：Gateway启动失败症状运行./start-all-gateways.sh

后，./check-gateways.sh

显示进程未运行。排查步骤#1.查看日志tail-50logs-main-assistant.log#2.检查配置jq.~/.openclaw-main-assistant/openclaw.json#3.检查端口占用lsof-i:18789#4.运行doctoropenclaw--profilemain-assistantdoctor常见问题配置文件格式错误：运行jq

验证端口被占用：更换端口或停止占用进程飞书配置错误：检查AppID和AppSecret故障排查：机器人无响应症状在飞书中@机器人，没有回复。排查步骤#1.检查Gateway是否运行./check-gateways.sh#2.查看实时日志tail-flogs-main-assistant.log#3.检查飞书连接grep"WebSocketclientstarted"logs-main-assistant.log常见原因Gateway未启动：运行./start-all-gateways.sh飞书连接断开：检查网络，重启Gateway配置错误：验证飞书AppID和Secret故障排查：使用了错误的Agent症状与原因私聊"内容创作助手"，但使用的是ClaudeOpus模型。原因：配置文件中Agent设置错误。#检查配置jq'.agents.list[0].id,.agents.list[0].model.primary'\~/.openclaw-content-creator/openclaw.json#应该输出：#"content-agent"#"local-antigravity/claude-sonnet-4-5"解决方案高级技巧：tmux管理创建与分割#创建tmux会话tmuxnew-sopenclaw#分割窗口Ctrl+b%#垂直分割Ctrl+b"#水平分割运行与监控#在不同窗口运行Gateway./start-main-assistant.sh./start-content-creator.sh./start-tech-dev.sh./start-ai-news.sh#查看所有日志tail-flogs-*.log高级技巧：开机自启动(launchd)#创建plist文件cat>~/Library/LaunchAgents/com.openclaw.main-assistant.plist<<'EOF'<?xmlversion="1.0"encoding="UTF-8"?><!DOCTYPEplistPUBLIC"-//Apple//DTDPLIST1.0//EN""/DTDs/PropertyList-1.0.dtd"><plistversion="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#加载服务launchctlload~/Library/LaunchAgents/com.openclaw.main-assistant.plist总结：多Gateway方案优势核心优势✓直接私聊不同机器人，自动使用对应agent✓完全独立，互不干扰✓不需要复杂的bindings配置✓不需要手动切换命令✓配置清晰，易于管理适用场景超级个体创业者需要多个专业助手不同任务使用不同模型追求稳定性和可靠性下一步：1.创建飞书机器人应用→2.运行配置脚本→3.启动所有Gateway→4.开始使用你的AI助手团队！传统方式：单Gateway+Bindings▲注意：本节介绍的是传统的单Gateway+Bindings方式，推荐使用上面的多Gateway方案。什么是多Agent？多Agent配置允许：每个飞书机器人使用不同的Agent每个Agent使用不同的模型每个Agent使用独立的工作空间每个Agent有独立的配置和上下文传统方式：配置结构{}传统方式：实战案例-4个专业助手场景：一人公司，需要不同的专业助手处理不同任务。{}传统方式：获取用户ID方法1：通过日志获取（推荐）#1.启动网关并查看日志openclawgatewayrestartopenclawlogs--follow#2.在飞书中给每个机器人发送消息#3.在日志中查找open_id#格式：ou_xxxxxxxxxxxxxxxxx#日志示例：[feishu]Receivedmessagefromou_18d36d8a49c010dfe20ace2a29250c04[feishu]Bot:主助理方法2：通过配对请求获取#获取配对列表openclawpairinglistfeishu#输出示例：#Pendingpairingrequests:#-Code:ABC123,User:ou_xxx,Bot:主助理传统方式：配置步骤1.创建工作空间mkdir-p/Users/username/clawd/contentmkdir-p/Users/username/clawd/techmkdir-p/Users/username/clawd/ainews2.获取用户ID按照上一页方法获取每个机器人对应的用户ID。3.更新配置文件将获取到的用户ID填入boundings.match.peer.id

部分。4.应用配置#备份现有配置cp~/.openclaw/openclaw.json~/.openclaw/openclaw.json.backup#应用新配置cpyour-config.json~/.openclaw/openclaw.json#验证配置openclawdoctor#重启网关openclawgatewayrestart传统方式：配置注意事项重要:agents.list配置限制这是最常见的配置错误！agents.list

中的每个Agent只能包含以下字段：{}❌错误示例（会导致配置验证失败）{}传统方式：配置注意事项正确{}2.通用配置必须放在agents.defaults:所有Agent共享的配置项必须放在agents.defaults

中，包括：compaction-上下文压缩策略maxConcurrent-最大并发数subagents-子Agent配置models-额外的模型配置传统方式：配置注意事项3.Bindings顺序很重要OpenClaw会按顺序匹配bindings，第一个匹配的规则会被使用。{}4．用户ID是唯一的每个飞书用户只能绑定到一个Agent。确保match.peer.id

的唯一性。传统方式：故障排查问题1：配置验证失败-agents.list包含不支持的字段#错误信息ConfiginvalidFile:~/.openclaw/openclaw.jsonProblem:-agents.list.0:Unrecognizedkeys:"compaction","maxConcurrent"...Run:openclawdoctor--fix原因：agents.list中的Agent配置包含了只能在agents.defaults中使用的字段。解决方案#方法1：自动修复（推荐）openclawdoctor--fix#方法2：手动修复#编辑配置文件，将compaction和maxConcurrent移到defaults传统方式：故障排查修复前{}修复后{}验证修复#验证配置openclawdoctor#应该看到：#✓Configvalid#✓4agentsconfigured#✓4bindingsconfigured传统方式：故障排查问题2：Bindings不生效#检查用户ID是否正确openclawlogs--follow|grep"ou_"#查看bindings匹配情况openclawlogs--follow|grepbindings问题3：找不到用户ID#使用debug级别日志openclawlogs--follow--leveldebug#或查看配对请求openclawpairinglistfeishu传统方式：故障排查问题4：配置修改后运行openclawdoctor报错#错误信息Unknownconfigkeys:-agents.list[0].compaction-agents.list[0].maxConcurrent...Run"openclawdoctor--fix"toremovethesekeys.解决方案#运行自动修复openclawdoctor--fix#验证配置openclawdoctor#重启网关openclawgatewayrestart#查看状态openclawgatewaystatus传统方式：故障排查问题5：版本不匹配警告#警告信息ConfigwaslastwrittenbyanewerOpenClaw(2026.2.6-3);currentversionis2026.2.1-zh.3.Run"openclawdoctor--fix"toapplychanges.说明：这是正常的版本提示，不影响使用。如果想消除警告：openclawdoctor--fix传统方式：配置对比与建议特性多Gateway方案传统方式(单Gateway+Bindings)配置复杂度简单复杂模型选择所有机器人相同每个机器人不同工作空间共享隔离需要Bindings✗✓需要用户ID✗✓适用场景简单使用专业分工推荐多Agent场景✓需要不同机器人使用不同模型✓需要隔离工作空间推荐单Agent场景✓配置简单易维护✓所有机器人使用相同模型本地多Agent管理：无需绑定IM平台💡重要提示：多Agent管理不仅可以用于飞书等IM平台，也完全支持本地使用。如果你不需要绑定飞书机器人，可以通过WebUI、命令行或TUI界面直接使用多个Agent。本地使用方式使用方式OpenClaw提供了多种本地使用方式，无需配置任何IM平台：WebUI（推荐）：图形化界面，操作直观命令行对话：快速执行单次任务TUI终端界面：适合服务器环境WebUI方式#打开Web界面openclawdashboard#或直接访问:18789/?token=你的token优势：图形化界面，操作直观；支持文件上传下载；实时显示Token消耗。本地使用方式方式二：命令行对话#直接发送消息openclawagent--message"你好，帮我分析一下这个项目"#使用管道输入echo"帮我总结这个文件的内容"|openclawagent--message#指定输出文件openclawagent--message"生成项目文档"--outputdocs.md优势：快速执行单次任务；适合脚本自动化；可以集成到工作流中。方式三：TUI终端界面优势：终端内交互式对话支持多轮对话适合服务器环境使用本地多Agent配置配置文件位置：~/.openclaw/openclaw.json{}配置说明agents.list:定义所有可用的Agentid：Agent标识符（必填）workspace：工作空间路径（必填）model.primary：使用的模型（可选）全局共享配置

agents.defaults：所有Agent共享的配置compaction：上下文压缩策略maxConcurrent：最大并发数subagents：子Agent配置Agent管理命令列出所有Agentopenclawagentslist#输出示例：#Availableagents:#-main-agent(default)#Workspace:/Users/username/work#Model:anthropic/claude-sonnet-4#-content-agent#Workspace:/Users/username/content#Model:anthropic/claude-sonnet-4#...切换到指定Agentopenclawagentsswitchcontent-agent#输出：#Switchedtoagent:content-agent#Workspace:/Users/username/content#Model:anthropic/claude-sonnet-4Agent管理命令查看当前Agent#查看当前使用的Agentopenclawagentscurrent#输出：#Currentagent:content-agent#Workspace:/Users/username/content#Model:anthropic/claude-sonnet-4查看Agent配置#查看指定Agent的配置openclawagentsconfigcontent-agent#查看当前Agent的配置openclawagentsconfigAgent管理命令查看Agent状态#查看所有Agent的状态openclawdoctor#输出示例：#Configvalid#✓4agentsconfigured#✓Gatewayrunning#✓Sessionstore:12entries状态检查结果✓配置有效✓4个Agent已配置✓Gateway正在运行实战案例：4个专业助手场景：个人开发者，需要不同的专业助手处理不同任务。步骤1：创建工作空间目录mkdir-p~/work/mainmkdir-p~/work/contentmkdir-p~/work/codemkdir-p~/work/research步骤2：编辑配置文件#备份现有配置cp~/.openclaw/openclaw.json~/.openclaw/openclaw.json.backup#编辑配置nano~/.openclaw/openclaw.json#将上面的配置示例粘贴进去，修改路径为你的实际路径。实战案例：4个专业助手步骤3&4：验证与重启#验证配置openclawdoctor#应该看到：✓Configvalid,✓4agentsconfigured#重启网关使配置生效openclawgatewayrestart#查看状态openclawgatewaystatus步骤5：使用不同的Agent#使用主助手openclawagentsswitchmain-agentopenclawagent--message"帮我整理今天的待办事项"#使用内容助手openclawagentsswitchcontent-agentopenclawagent--message"帮我写一篇关于AI的文章"使用场景对比场景推荐方式Agent配置优势个人本地使用WebUI+多Agent不同任务用不同Agent工作空间隔离，模型灵活团队协作飞书+多Agent不同机器人绑定不同Agent团队成员各用各的助手快速测试命令行+单Agent使用默认Agent配置简单，快速上手服务器环境TUI+多Agent不同项目用不同Agent终端内交互，资源隔离典型工作流：一人公司的日常工作流#早上：查看日程openclawagentsswitchmain-agentopenclawagent--message"显示今天的日程安排"#上午：开发项目openclawagentsswitchcode-agentopenclawagent--message"帮我实现用户登录功能"配置技巧技巧1：为不同任务使用不同模型{}说明ClaudeSonnet4：通用对话和复杂任务DeepSeek：代码生成和技术问题GeminiFlash：快速响应和简单任务配置技巧技巧2：使用别名简化切换#在~/.zshrc或~/.bashrc中添加别名aliasoc-main='openclawagentsswitchmain-agent'aliasoc-code='openclawagentsswitchcode-agent'aliasoc-content='openclawagentsswitchcontent-agent'aliasoc-research='openclawagentsswitchresearch-agent'#使用别名快速切换oc-codeopenclawagent--message"帮我写一个排序算法"技巧3：为每个Agent配置独立的Skills#为代码助手安装开发相关的Skillsopenclawagentsswitchcode-agentopenclawskillinstallgithub-integrationopenclawskillinstallcode-review#为内容助手安装写作相关的Skillsopenclawagentsswitchcontent-agentopenclawskillinstallgrammar-checkopenclawskillinstallseo-optimizer常见问题问题1：切换Agent后工作空间没变#检查当前Agentopenclawagentscurrent#检查配置openclawagentsconfig#重启网关openclawgatewayrestart问题2：找不到Agent#列出所有Agentopenclawagentslist#检查配置文件cat~/.openclaw/openclaw.json|