8 Agent 一人公司：OpenClaw + 硅基流动 API Windows 部署

文档说明：本文档为最终整合版，融合信息管理部门调整、Agent 无冲突命名优化、多模型 / 多渠道配置等全部内容；所有命令可直接复制至管理员模式 PowerShell 执行（仅需替换飞书 / 微信 / 模型密钥等个性化参数）；部署前建议通读「常见问题排查」章节，提前规避部署风险。

一、基础信息

1.1 适配环境

Windows 10/11 + PowerShell（管理员模式）+ Node.js v24+（LTS 稳定版）

1.2 核心特性

全独立 Workspace，进程 / 数据 / 日志完全隔离 全程基于 OpenClaw 原生命令操作，无自定义脚本 一键创建 / 管理 Agent，支持单 / 多 Agent 差异化配置 Agent 命名避开发环境关键词，杜绝环境冲突 支持主备模型自动降级，兼容飞书 / 微信 / 钉钉多消息渠道 多 Agent 串行 / 并行 / 混合组合执行，指令自动分发汇总

1.3 技术依赖

核心框架：OpenClaw（一站式 Agent 管理，官方原生支持多能力适配） 运行环境：Node.js v24+（LTS，OpenClaw 官方强制要求） 包管理：npm（Node.js 依赖管理，需配置国内镜像加速） 可选工具：Git v2.40+（OpenClaw 官方推荐，部分依赖拉取需用）

1.4 核心原则

1. 操作优先级：OpenClaw 原生命令为主，Windows 原生命令仅作补充 / 备用
2. 命名原则：Agent 采用强业务语义化命名，避开所有开发 / 环境 / 通用技术关键词
3. 隔离原则：每个 Agent 分配唯一端口 + 专属 Workspace，故障互不影响
4. 扩展原则：新增 Agent 不修改原有配置，端口递增、独立管理
5. 配置原则：多模型 / 多渠道按需配置，Agent 本地配置覆盖网关全局配置

二、架构设计（全独立 Workspace・无冲突命名）

2.1 核心 Agent 组件（最终版）

所有 Agent 由 OpenClaw 原生命令自动生成专属目录，无需手动创建；总调度 Agent 为核心入口，负责指令接收、分发与结果汇总。

表格

序号	Agent 名称（新・无冲突）	定位	运行端口	核心职责	专属 Workspace 目录（Windows）
1	dispatcher（总调度）	入口 / 分发	3000	指令接收、路由分发、多 Agent 组合、结果汇总	%USERPROFILE%\openclaw-enterprise\dispatcher
2	creator（内容创作）	创作	3001	选题策划、文案撰写、脚本创作、素材建议	%USERPROFILE%\openclaw-enterprise\creator
3	publisher（运营发布）	推广	3002	内容排期、多平台发布、账号管理、效果初监控	%USERPROFILE%\openclaw-enterprise\publisher
4	infoman（信息管理）	信息管理	3003	信息采集、信息整合、效果分析、策略建议	%USERPROFILE%\openclaw-enterprise\infoman
5	lifestyler（生活管理）	生活管理	3004	日程安排、提醒设置、购物清单、健康规划	%USERPROFILE%\openclaw-enterprise\lifestyler
6	designer（设计）	视觉设计	3005	视觉设计建议、素材制作、版式规划、设计选型	%USERPROFILE%\openclaw-enterprise\designer
7	businesser（商务）	商务运营	3006	客户对接、报价方案、合同拟写、商务复盘	%USERPROFILE%\openclaw-enterprise\businesser
8	coder（编程）	技术开发	3007	代码编写、脚本开发、小工具制作、技术问题排查	%USERPROFILE%\openclaw-enterprise\coder

说明：% USERPROFILE% 为 Windows 默认用户目录，实际路径如 C:\Users\ 你的用户名，所有子目录（files/memory/logs/config）由 OpenClaw 自动生成。

2.2 Agent 灵活组合机制

由总调度（dispatcher）Agent 自动识别组合符号实现多 Agent 协同，全程无需手动干预，组合规则与 Agent 名称完全适配。

表格

组合方式	执行规则	组合符号	触发示例
串行	按顺序依次执行，前一个完成后执行后一个	￫	写文章并发布 → creator ￫ publisher设计海报并发布 → designer ￫ publisher
并行	多个 Agent 同时执行，互不干扰	+	写文章 + 安排日程 → creator + lifestyler写代码 + 制作报价方案 → coder + businesser
混合	串行 + 并行结合，括号内为串行优先级	()+	写文章发布并分析信息 → (creator ￫ publisher) + infoman设计封面并发布 + 分析运营数据 → (designer ￫ publisher) + infoman

三、环境准备（纯命令行・管理员 PowerShell 执行）

全程在管理员模式 PowerShell 操作（Win+R 输入 powershell，右键以管理员身份运行），避免权限不足；每步操作后必须执行验证步骤，确保环境生效。

3.1 Node.js 环境安装与验证（v24+ 强制要求）

方式 1：新手推荐 - 官方安装包（一键配置环境变量）

1. 下载地址：nodejs.org/（自动识别 Windows 系统，选择 64 位 LTS 安装包）
2. 安装操作：务必勾选「Add to PATH」，其余默认下一步，完成后重启 PowerShell。

方式 2：开发人员推荐 - nvm for Windows 升级（多版本管理）

powershell

# 安装nvm（若未安装）
iwr -useb https://raw.githubusercontent.com/coreybutler/nvm-windows/master/nvm-setup.exe -OutFile nvm-setup.exe
# 安装Node.js v24 LTS
nvm install 24
# 切换使用v24版本
nvm use 24

通用验证 + 国内镜像加速（必做）

powershell

# 验证：查看Node.js和npm版本，确保Node.js≥v24.0.0
node -v
npm -v
# 配置npm淘宝镜像，解决OpenClaw下载慢问题
npm config set registry https://registry.npmmirror.com/

避坑提示：若提示「node 不是内部或外部命令」，说明环境变量未配置，重启电脑后重新验证；仍失败则手动将 Node.js 安装目录添加至系统 PATH。

3.2 OpenClaw 框架安装与初始化（官方原生命令）

放弃原 npm 安装方式，使用 OpenClaw 官方一键安装命令，自动处理依赖、下载最新版本。

powershell

# OpenClaw原生命令：Windows一键安装（官方推荐）
iwr -useb https://openclaw.ai/install.ps1 | iex

初始化配置向导（必做，中文引导）

安装完成后自动进入配置向导，若未自动进入，执行以下命令手动启动：

powershell

# 启动初始化配置向导，安装守护进程
openclaw onboard --install-daemon

配置步骤：

1. 网关配置：选「本地网关」，端口默认 18789（与 Agent 3000+ 端口无冲突，无需修改）
2. 模型配置：选「Skip for now」（后续可在 Agent 中单独配置）
3. 守护进程：选「y」（后台运行，关闭终端不中断）
4. 消息渠道：选「Skip for now」（后续接入飞书 / 微信可单独配置）
5. 技能配置：选「No」（按需后续添加）

安装成功验证

powershell

# 验证1：查看OpenClaw版本，确认安装成功
openclaw --version
# 验证2：检查网关状态，确保核心服务运行
openclaw gateway status

成功标志：gateway status 输出「Gateway is running」，无红色报错。

避坑提示：若提示 sharp 安装失败，重新执行一键安装命令；网络超时则切换手机热点重试。

四、项目初始化（OpenClaw+Windows 原生命令）

创建项目根目录，所有 Agent 的 Workspace 均存放于此，命令为 Windows 通用路径，适配所有电脑。

powershell

# Windows原生命令：创建项目根目录并进入
mkdir $env:USERPROFILE\openclaw-enterprise
cd $env:USERPROFILE\openclaw-enterprise
# 验证：查看目录是否创建成功
dir

成功标志：输出中显示 openclaw-enterprise 目录，且当前路径已切换至该目录。

五、核心操作：一键创建所有 Agent（OpenClaw 原生命令）

使用 openclaw agent add 原生命令一键生成 Agent，通过 --cwd 参数实现 Workspace 隔离，自动生成配置 / 日志 / 数据目录，无需手动创建任何文件。

5.1 参数说明

表格

参数	作用	必填性
–name	Agent 名称（无冲突语义化命名）	是
–port	唯一运行端口	是
–cwd	专属 Workspace 目录	是
–model-provider	模型服务商（如 miaoda/qwen/openai）	是
–model-name	具体模型名称（与服务商匹配）	是
–channel-xxx-enabled	是否启用某渠道（如 feishu/wechat）	可选
–channel-xxx-appid/secret	渠道密钥 / ID	可选（启用渠道则必填）

5.2 一键创建命令（逐行执行）

powershell

# 1. 总调度Agent（dispatcher，3000端口·核心入口）
openclaw agent add --name dispatcher --port 3000 --cwd .\dispatcher --model-provider miaoda --model-name miaoda-model-auto --channel-feishu-enabled true --channel-feishu-appid cli_xxxx --channel-feishu-secret xxx
# 2. 内容创作Agent（creator，3001端口）
openclaw agent add --name creator --port 3001 --cwd .\creator --model-provider miaoda --model-name miaoda-model-auto --channel-feishu-enabled true --channel-feishu-appid cli_xxxx --channel-feishu-secret xxx
# 3. 运营发布Agent（publisher，3002端口）
openclaw agent add --name publisher --port 3002 --cwd .\publisher --model-provider miaoda --model-name miaoda-model-auto --channel-feishu-enabled true --channel-feishu-appid cli_xxxx --channel-feishu-secret xxx
# 4. 信息管理Agent（infoman，3003端口）
openclaw agent add --name infoman --port 3003 --cwd .\infoman --model-provider miaoda --model-name miaoda-model-auto --channel-feishu-enabled true --channel-feishu-appid cli_xxxx --channel-feishu-secret xxx
# 5. 生活管理Agent（lifestyler，3004端口）
openclaw agent add --name lifestyler --port 3004 --cwd .\lifestyler --model-provider miaoda --model-name miaoda-model-auto --channel-feishu-enabled true --channel-feishu-appid cli_xxxx --channel-feishu-secret xxx
# 6. 设计Agent（designer，3005端口·视觉设计）
openclaw agent add --name designer --port 3005 --cwd .\designer --model-provider qwen --model-name qwen-plus --channel-feishu-enabled true --channel-feishu-appid cli_xxxx --channel-feishu-secret xxx
# 7. 商务Agent（businesser，3006端口·商务运营）
openclaw agent add --name businesser --port 3006 --cwd .\businesser --model-provider miaoda --model-name miaoda-model-auto --channel-feishu-enabled true --channel-feishu-appid cli_xxxx --channel-feishu-secret xxx
# 8. 编程Agent（coder，3007端口·技术开发）
openclaw agent add --name coder --port 3007 --cwd .\coder --model-provider openai --model-name gpt-3.5-turbo --channel-feishu-enabled true --channel-feishu-appid cli_xxxx --channel-feishu-secret xxx

说明：无需某消息渠道则删除对应渠道参数；模型服务商 / 名称可按需替换（如 qwen/openai），各 Agent 模型为业务适配推荐配置，可根据自身密钥情况调整。

5.3 创建结果验证

powershell

# 验证1：查看已创建的Agent列表，确认8个均存在
openclaw agent list
# 验证2：检查Agent专属目录，确认自动生成4个子目录
dir .\dispatcher\
dir .\infoman\
dir .\designer\
dir .\coder\

成功标志：agent list 显示 8 个 Agent 的名称 / 端口 / 状态；每个 Agent 目录下均有 files/、memory/、logs/、config/ 子目录。

5.4 Agent 配置修改（无需重建）

若需修改端口 / 模型 / 渠道，直接编辑对应 Agent 的配置文件，修改后重启 Agent 即可生效，无需重新创建。

powershell

# 示例1：打开总调度Agent配置文件
notepad .\dispatcher\config\openclaw.json
# 示例2：打开信息管理Agent配置文件
notepad .\infoman\config\openclaw.json
# 示例3：打开编程Agent配置文件
notepad .\coder\config\openclaw.json

可修改项：port（端口）、model-provider（模型服务商）、channel-xxx-enabled（渠道开关）、各类渠道 appid/secret 等。

六、Agent 定义文件（AGENTS.md）创建与验证

为每个 Agent 配置职责 / 触发词 / 工作流程，文件由 Windows 命令自动创建，OpenClaw 会自动识别加载；内容与 Agent 名称、职责完全适配，可按需修改。

6.1 一键创建定义文件（项目根目录执行）

powershell

# 确保在项目根目录
cd $env:USERPROFILE\openclaw-enterprise

# 1. 总调度Agent定义文件
@"
# 总调度 Agent（dispatcher）
你是公司总调度，负责接收用户指令并智能分发给合适的Agent，支持多Agent串行/并行组合执行。
## 下属部门
- 内容创作 (creator)：写文章、创作文案、脚本创作、选题策划
- 运营发布 (publisher)：内容发布、排期安排、多平台运营、账号管理
- 信息管理 (infoman)：信息采集、整合、效果分析、策略建议
- 生活管理 (lifestyler)：日程管理、提醒设置、购物清单、健康提醒
- 设计 (designer)：设计、海报、封面、视觉、素材制作、版式规划
- 商务 (businesser)：客户对接、报价方案、合同拟写、商务复盘
- 编程 (coder)：代码编写、脚本开发、小工具制作、技术问题排查
## 工作流程
1. 接收用户消息
2. 判断触发词，匹配对应Agent
3. 单Agent直接派发，多Agent自动组建团队按组合规则执行
4. 收集所有Agent执行结果，汇总后返回给用户
## 组合符号
- ￫：串行执行（先执行前一个，再执行后一个）
- +：并行执行（多个Agent同时执行）
## 触发词匹配
| 关键词 | 对应Agent |
|--------|-----------|
| 写、创作、文案、文章、脚本、选题 | creator |
| 发布、排期、运营、推广、账号、多平台 | publisher |
| 信息、采集、整合、分析、报表、统计、效果、复盘 | infoman |
| 生活、安排、提醒、日历、购物、买菜、健康 | lifestyler |
| 设计、海报、封面、视觉、素材、版式、排版 | designer |
| 客户、报价、合同、商务、对接、谈单、方案 | businesser |
| 代码、编程、脚本、工具、开发、调试、写代码 | coder |
"@ | Out-File -FilePath .\dispatcher\AGENTS.md -Encoding utf8

# 2. 内容创作Agent定义文件
@"
# 内容创作 Agent（creator）
你是专业的内容创作专家，专注于高质量文案、脚本、文章创作与选题策划。
## 核心职责
- 热点选题与内容策划
- 各类文案、文章撰写
- 短视频/直播脚本创作
- 创作素材建议与搭配
## 触发词
写、创作、文案、文章、内容、脚本、选题、素材
"@ | Out-File -FilePath .\creator\AGENTS.md -Encoding utf8

# 3. 运营发布Agent定义文件
@"
# 运营发布 Agent（publisher）
你是专业的运营推广专家，负责内容排期与多平台发布运营。
## 核心职责
- 内容发布排期制定
- 多平台内容发布
- 运营账号日常管理
- 发布效果初步监控
## 支持平台
小红书、抖音、微博、微信公众号
## 触发词
发布、排期、运营、推广、账号、多平台、上架
"@ | Out-File -FilePath .\publisher\AGENTS.md -Encoding utf8

# 4. 信息管理Agent定义文件
@"
# 信息管理 Agent（infoman）
你是专业的信息管理专家，负责全维度信息采集、整合分析与运营策略建议。
## 核心职责
- 多平台运营信息采集
- 各类业务信息整理与整合
- 信息分析与报表生成
- 运营策略优化建议
- 效果复盘与信息总结
## 触发词
信息、采集、整合、分析、数据、报表、统计、效果、复盘、策略、优化
"@ | Out-File -FilePath .\infoman\AGENTS.md -Encoding utf8

# 5. 生活管理Agent定义文件
@"
# 生活管理 Agent（lifestyler）
你是贴心的生活管家，负责日常日程、提醒与生活规划。
## 核心职责
- 日程创建与管理
- 自定义提醒设置
- 购物/买菜清单制作
- 健康作息与饮食提醒
- 日常生活动效建议
## 触发词
生活、安排、提醒、日历、购物、买菜、做饭、健康、作息
"@ | Out-File -FilePath .\lifestyler\AGENTS.md -Encoding utf8

# 6. 设计Agent定义文件
@"
# 设计 Agent（designer）
你是专业的视觉设计专家，专注于各类视觉设计、素材制作与版式规划，适配自媒体/商业场景设计需求。
## 核心职责
- 海报/封面/配图视觉设计建议
- 短视频/直播素材制作思路
- 自媒体版式/排版规划优化
- 设计素材选型与搭配推荐
- 商业宣传物料设计建议
## 触发词
设计、海报、封面、视觉、素材、版式、排版、配图、制作、物料
"@ | Out-File -FilePath .\designer\AGENTS.md -Encoding utf8

# 7. 商务Agent定义文件
@"
# 商务 Agent（businesser）
你是专业的商务运营专家，专注于中小微企业/个人的商务对接、报价方案与合同拟写，适配轻资产商务场景。
## 核心职责
- 客户需求对接与沟通技巧建议
- 产品/服务报价方案制定
- 简易商务合同拟写与优化
- 商务谈单策略建议
- 商务合作复盘与总结
## 触发词
客户、报价、合同、商务、对接、谈单、方案、合作、复盘
"@ | Out-File -FilePath .\businesser\AGENTS.md -Encoding utf8

# 8. 编程Agent定义文件
@"
# 编程 Agent（coder）
你是专业的开发工程师，专注于轻量代码编写、脚本开发与小工具制作，适配个人/小型业务技术需求。
## 核心职责
- Python/JavaScript/Shell等轻量代码编写
- 自动化脚本开发（办公/运营/数据处理）
- 个人轻量小工具制作建议
- 基础代码调试与技术问题排查
- 代码注释与文档编写
## 支持语言
Python、JavaScript、HTML/CSS、Shell、Batch（批处理）
## 触发词
代码、编程、脚本、工具、开发、调试、写代码、自动化、排查
"@ | Out-File -FilePath .\coder\AGENTS.md -Encoding utf8

6.2 定义文件验证

powershell

# 验证1：查看总调度Agent定义文件内容
Get-Content .\dispatcher\AGENTS.md
# 验证2：查看信息管理Agent定义文件内容
Get-Content .\infoman\AGENTS.md
# 验证3：查看编程Agent定义文件内容
Get-Content .\coder\AGENTS.md

成功标志：输出显示文件完整内容，无乱码（编码为 UTF-8），Agent 名称和职责与配置一致。

七、Agent 全生命周期管理（优先 OpenClaw 原生命令）

所有操作在项目根目录执行，优先使用 OpenClaw 原生命令（优雅操作，避免数据丢失），Windows 原生命令仅作为进程残留 / 端口占用的备用方案。

7.1 启动所有 Agent（后台运行 + 日志定向）

通过 start /b 实现 Windows 后台运行，日志定向到 Agent 专属 logs 目录，添加 2 秒间隔避免端口冲突。

powershell

cd $env:USERPROFILE\openclaw-enterprise
# 1. 总调度Agent（3000）
start /b openclaw start --port 3000 --cwd .\dispatcher > .\dispatcher\logs\start.log 2>&1
Start-Sleep -Seconds 2
# 2. 内容创作Agent（3001）
start /b openclaw start --port 3001 --cwd .\creator > .\creator\logs\start.log 2>&1
Start-Sleep -Seconds 2
# 3. 运营发布Agent（3002）
start /b openclaw start --port 3002 --cwd .\publisher > .\publisher\logs\start.log 2>&1
Start-Sleep -Seconds 2
# 4. 信息管理Agent（3003）
start /b openclaw start --port 3003 --cwd .\infoman > .\infoman\logs\start.log 2>&1
Start-Sleep -Seconds 2
# 5. 生活管理Agent（3004）
start /b openclaw start --port 3004 --cwd .\lifestyler > .\lifestyler\logs\start.log 2>&1
Start-Sleep -Seconds 2
# 6. 设计Agent（3005）
start /b openclaw start --port 3005 --cwd .\designer > .\designer\logs\start.log 2>&1
Start-Sleep -Seconds 2
# 7. 商务Agent（3006）
start /b openclaw start --port 3006 --cwd .\businesser > .\businesser\logs\start.log 2>&1
Start-Sleep -Seconds 2
# 8. 编程Agent（3007）
start /b openclaw start --port 3007 --cwd .\coder > .\coder\logs\start.log 2>&1

7.2 查看 Agent 运行状态

方式 1：OpenClaw 原生命令（首选，精准查询）

powershell

cd $env:USERPROFILE\openclaw-enterprise
openclaw status --port 3000 --cwd .\dispatcher
openclaw status --port 3001 --cwd .\creator
openclaw status --port 3002 --cwd .\publisher
openclaw status --port 3003 --cwd .\infoman
openclaw status --port 3004 --cwd .\lifestyler
openclaw status --port 3005 --cwd .\designer
openclaw status --port 3006 --cwd .\businesser
openclaw status --port 3007 --cwd .\coder

方式 2：Windows 命令（备用，查看端口监听）

powershell

netstat -ano | findstr :3000
netstat -ano | findstr :3001
netstat -ano | findstr :3002
netstat -ano | findstr :3003
netstat -ano | findstr :3004
netstat -ano | findstr :3005
netstat -ano | findstr :3006
netstat -ano | findstr :3007

成功标志：OpenClaw 命令输出「Agent is running」；Windows 命令显示对应端口有 PID 监听。

7.3 停止所有 Agent

方式 1：OpenClaw 原生命令（首选，优雅停止）

powershell

cd $env:USERPROFILE\openclaw-enterprise
openclaw stop --port 3000 --cwd .\dispatcher
openclaw stop --port 3001 --cwd .\creator
openclaw stop --port 3002 --cwd .\publisher
openclaw stop --port 3003 --cwd .\infoman
openclaw stop --port 3004 --cwd .\lifestyler
openclaw stop --port 3005 --cwd .\designer
openclaw stop --port 3006 --cwd .\businesser
openclaw stop --port 3007 --cwd .\coder

方式 2：Windows 命令（备用，强制清理进程残留）

powershell

taskkill /f /im node.exe /fi "WINDOWTITLE eq openclaw*" 2>NUL || echo "无OpenClaw进程运行"

成功标志：OpenClaw 命令输出「Agent is stopped」；Windows 命令检查端口无监听。

7.4 删除无用 Agent（谨慎操作）

遵循「只加不减」架构原则，若需删除，优先使用 OpenClaw 原生命令，避免残留配置 / 目录（以下为编程 Agent 示例）。

powershell

cd $env:USERPROFILE\openclaw-enterprise
# OpenClaw原生命令：删除Agent
openclaw agent remove --name coder --cwd .\coder
# Windows原生命令：彻底删除残留目录（可选）
rm -Recurse .\coder -Force

八、部署全维度验证（必做）

从端口监听、Agent 状态、接口访问、日志查看四个维度验证部署结果，核心入口为总调度 Agent（3000 端口），其运行正常则代表整体部署成功。

powershell

cd $env:USERPROFILE\openclaw-enterprise
# 1. 批量检查所有Agent端口监听
$ports = 3000,3001,3002,3003,3004,3005,3006,3007
foreach ($port in $ports) {
  Write-Host "========== 检查端口 $port =========="
  netstat -ano | findstr :$port || Write-Host "端口 $port 未启动/未监听"
}
# 2. 批量检查Agent状态（核心验证）
openclaw status --port 3000 --cwd .\dispatcher
openclaw status --port 3001 --cwd .\creator
openclaw status --port 3002 --cwd .\publisher
openclaw status --port 3003 --cwd .\infoman
openclaw status --port 3004 --cwd .\lifestyler
openclaw status --port 3005 --cwd .\designer
openclaw status --port 3006 --cwd .\businesser
openclaw status --port 3007 --cwd .\coder
# 3. 访问Agent接口，验证服务可用
curl http://localhost:3000
curl http://localhost:3003
curl http://localhost:3005
curl http://localhost:3007
# 4. 查看启动日志，排查问题（最新10行）
Get-Content .\dispatcher\logs\start.log -Tail 10
Get-Content .\infoman\logs\start.log -Tail 10
Get-Content .\designer\logs\start.log -Tail 10
Get-Content .\coder\logs\start.log -Tail 10

部署成功最终标志

1. 所有 3000-3007 端口均有监听进程；
2. 所有 Agent 执行 openclaw status 均显示「running」；
3. 访问 http://localhost:3000 返回正常（无 404/500 错误）；
4. 所有 Agent 日志文件无红色报错信息。

九、独立 Workspace 隔离规则（自动实现）

所有隔离由 openclaw agent add 的 --cwd 参数和唯一端口实现，无需手动配置，确保单个 Agent 故障不影响全局，降低运维成本。

表格

隔离类型	实现方式	核心保障
进程隔离	每个 Agent 分配唯一端口，以独立 Node 进程运行（OpenClaw 管控）	端口不冲突，进程互不干扰，单个崩溃不影响全局
数据隔离	每个 Agent 有专属 files/、memory/ 目录，业务数据单独存储	数据不交叉、不泄露，可单独备份 / 恢复
日志隔离	运行日志定向到各 Agent 专属 logs/ 目录	问题精准定位，日志不混杂，无需筛选排查
故障隔离	单个 Agent 崩溃，仅需重启对应 Agent 即可	总调度 Agent 不中断，整体架构稳定性高

十、Agent 扩展规则（纯 OpenClaw 原生命令）

若需新增 Agent（如客服 / 法务 / 财务），遵循以下规则，不修改任何原有 Agent 配置 / 目录，保证架构稳定性和可扩展性；同时严格遵守无冲突命名规范。

10.1 扩展核心规则

1. 端口递增：新增 Agent 使用 3008、3009…… 依次递增，避免端口冲突；
2. 无冲突命名：强业务语义化，避开所有开发 / 环境 / 通用技术关键词；
3. 独立 Workspace：通过 --cwd .\ 新 Agent 名称 创建专属目录，完全隔离；
4. 纯原生命令：全程使用 openclaw agent add 一键创建，不手动改配置；
5. 单独管理：启动 / 停止 / 状态检查独立执行，与原有 Agent 无关联。

10.2 永久禁用命名关键词清单

表格

关键词类型	禁用清单
环境类	dev、test、prod、stage、release、debug、build、deploy
通用技术类	data、operation、service、server、node、core、main、master、slave、info
系统类	system、admin、root、user、local、remote
原简易命名	coordinator、content、life、analyst、lifestyle

10.3 扩展示例：新增客服 Agent（serviceer・3008 端口）

powershell

cd $env:USERPROFILE\openclaw-enterprise
# 1. 一键创建客服Agent（独立Workspace）
openclaw agent add --name serviceer --port 3008 --cwd .\serviceer --model-provider miaoda --model-name miaoda-model-auto
# 2. 创建定义文件AGENTS.md
@"
# 客服 Agent（serviceer）
你是专业的客服专员，负责客户咨询解答、问题处理与客情维护。
## 核心职责
- 客户日常咨询问题解答
- 产品/服务使用问题指导
- 客户投诉与问题处理建议
- 客情维护与回访话术制定
## 触发词
客服、咨询、问题、解答、投诉、客情、回访
"@ | Out-File -FilePath .\serviceer\AGENTS.md -Encoding utf8
# 3. 后台启动客服Agent（日志定向）
start /b openclaw start --port 3008 --cwd .\serviceer > .\serviceer\logs\start.log 2>&1
# 4. 验证客服Agent状态
openclaw status --port 3008 --cwd .\serviceer

十一、高级配置

11.1 Agent 多模型配置（差异化 / 主备降级）

OpenClaw 支持为不同 Agent 配置差异化专属模型，或为单个 Agent 配置主备模型（故障自动切换），提升 Agent 适配性与稳定性；配置前需先添加模型服务商密钥。

11.1.1 前置准备：添加模型服务商密钥

powershell

# OpenAI密钥（替换为你的API Key）
openclaw config set model.openai.apiKey sk-xxxx
# 通义千问密钥（替换为你的AccessKey）
openclaw config set model.qwen.accessKeyId xxx --model-provider qwen
openclaw config set model.qwen.accessKeySecret xxx --model-provider qwen
# 百度文心一言密钥
openclaw config set model.ernie.apiKey xxx --model-provider ernie
# 智谱AI密钥
openclaw config set model.zhipu.apiKey xxx --model-provider zhipu

11.1.2 核心参数说明

表格

参数名	作用	常见有效值
model.provider	模型服务商	miaoda（阿里云妙搭）、qwen（通义千问）、openai、ernie（文心一言）、zhipu（智谱 AI）
model.name	具体模型（与服务商匹配）	miaoda：miaoda-model-autoqwen：qwen-turbo、qwen-plusopenai：gpt-3.5-turbo、gpt-4oernie：ernie-4.0、ernie-3.5zhipu：glm-4、glm-3-turbo

11.1.3 方式一：多 Agent 差异化配置（创建时指定）

powershell

cd $env:USERPROFILE\openclaw-enterprise
# 1. 总调度（dispatcher）：通义千问（qwen-turbo，擅长逻辑分发）
openclaw agent add --name dispatcher --port 3000 --cwd .\dispatcher `
--model-provider qwen --model-name qwen-turbo `
--channel-feishu-enabled true --channel-feishu-appid cli_xxxx --channel-feishu-secret xxx
# 2. 内容创作（creator）：阿里云妙搭（miaoda-model-auto，擅长文案）
openclaw agent add --name creator --port 3001 --cwd .\creator `
--model-provider miaoda --model-name miaoda-model-auto `
--channel-feishu-enabled true --channel-feishu-appid cli_xxxx --channel-feishu-secret xxx
# 3. 运营发布（publisher）：OpenAI（gpt-3.5-turbo，擅长平台规则）
openclaw agent add --name publisher --port 3002 --cwd .\publisher `
--model-provider openai --model-name gpt-3.5-turbo `
--channel-feishu-enabled true --channel-feishu-appid cli_xxxx --channel-feishu-secret xxx
# 4. 信息管理（infoman）：文心一言（ernie-3.5，擅长数据分析）
openclaw agent add --name infoman --port 3003 --cwd .\infoman `
--model-provider ernie --model-name ernie-3.5 `
--channel-feishu-enabled true --channel-feishu-appid cli_xxxx --channel-feishu-secret xxx
# 5. 生活管理（lifestyler）：智谱AI（glm-3-turbo，擅长生活化场景）
openclaw agent add --name lifestyler --port 3004 --cwd .\lifestyler `
--model-provider zhipu --model-name glm-3-turbo `
--channel-feishu-enabled true --channel-feishu-appid cli_xxxx --channel-feishu-secret xxx
# 6. 设计（designer）：通义千问（qwen-plus，擅长视觉设计思路）
openclaw agent add --name designer --port 3005 --cwd .\designer `
--model-provider qwen --model-name qwen-plus `
--channel-feishu-enabled true --channel-feishu-appid cli_xxxx --channel-feishu-secret xxx
# 7. 商务（businesser）：阿里云妙搭（miaoda-model-auto，擅长方案拟写）
openclaw agent add --name businesser --port 3006 --cwd .\businesser `
--model-provider miaoda --model-name miaoda-model-auto `
--channel-feishu-enabled true --channel-feishu-appid cli_xxxx --channel-feishu-secret xxx
# 8. 编程（coder）：OpenAI（gpt-4o，擅长代码开发调试）
openclaw agent add --name coder --port 3007 --cwd .\coder `
--model-provider openai --model-name gpt-4o `
--channel-feishu-enabled true --channel-feishu-appid cli_xxxx --channel-feishu-secret xxx

11.1.4 方式二：修改已有 Agent 模型配置

powershell

# 示例：修改编程Agent为通义千问plus
notepad $env:USERPROFILE\openclaw-enterprise\coder\config\openclaw.json

修改配置文件中 model 字段：

json

{
  "port": 3007,
  "name": "coder",
  "model": {
    "provider": "qwen",
    "name": "qwen-plus"
  },
  "channels": {
    "feishu": {
      "enabled": true,
      "appid": "cli_xxxx",
      "secret": "xxx"
    }
  }
}

重启 Agent 生效：

powershell

openclaw stop --port 3007 --cwd .\coder
openclaw start --port 3007 --cwd .\coder

11.1.5 方式三：单个 Agent 主备模型配置（故障自动切换）

以 coder 为例，修改配置文件替换原有 model 字段：

json

{
  "port": 3007,
  "name": "coder",
  "model": {
    "primary": {  // 主模型（优先使用）
      "provider": "openai",
      "name": "gpt-4o"
    },
    "fallback": [  // 备用模型（按顺序切换）
      {
        "provider": "qwen",
        "name": "qwen-plus"
      },
      {
        "provider": "zhipu",
        "name": "glm-4"
      }
    ]
  },
  "channels": {
    "feishu": {
      "enabled": true,
      "appid": "cli_xxxx",
      "secret": "xxx"
    }
  }
}

重启 Agent 生效，主模型故障时自动切换至备用模型，全程无感知。

11.1.6 多模型配置验证

powershell

cd $env:USERPROFILE\openclaw-enterprise
# 1. 查看配置文件，确认模型参数
Get-Content .\coder\config\openclaw.json | Select-String "model"
# 2. 调用接口测试模型响应
curl -X POST http://localhost:3007/chat -H "Content-Type: application/json" -d '{"message":"写一个Python自动化办公脚本"}'
# 3. 查看日志，验证主备切换（模拟主模型故障后执行）
Get-Content .\coder\logs\start.log -Tail 20

11.1.7 关键注意事项

1. 模型名称必须与服务商匹配（如 provider=openai 时，name 不能填 qwen-turbo）；
2. 所有配置的模型服务商均需提前添加密钥，否则调用 / 切换失败；
3. 配置修改后必须重启 Agent 才能生效；
4. 网关全局模型仅为兜底，Agent 本地配置会覆盖全局配置。

11.2 Agent 消息渠道配置（飞书 / 微信 / 钉钉）

OpenClaw 支持为 Agent 配置多消息渠道，实现从渠道接收指令、推送执行结果；以下以飞书为核心示例，微信 / 钉钉配置逻辑一致。

11.2.1 核心渠道参数说明

表格

渠道类型	核心参数	作用	获取方式
飞书（feishu）	enabled	渠道开关	布尔值（true/false）
	appid	飞书应用 ID	飞书开发者后台 - 自建应用 - 凭证与基础信息
	secret	飞书应用密钥	飞书开发者后台 - 自建应用 - 凭证与基础信息
微信（wechat）	appId	公众号 / 小程序 AppID	微信公众平台 - 开发 - 基本配置
	appSecret	公众号 / 小程序 AppSecret	微信公众平台 - 开发 - 基本配置
钉钉（dingtalk）	appKey	钉钉应用 Key	钉钉开发者后台 - 应用管理 - 基础信息
	appSecret	钉钉应用密钥	钉钉开发者后台 - 应用管理 - 基础信息

11.2.2 前置准备：渠道权限配置

 飞书：开发者后台为应用开启「消息接收」「机器人」权限，事件订阅 URL 设为 http:// 你的 IP:18789/channel/feishu 微信：公众平台配置服务器地址为 http:// 你的 IP:18789/channel/wechat，完成 Token 验证 钉钉：开发者后台配置回调 URL 为 http:// 你的 IP:18789/channel/dingtalk

11.2.3 方式一：创建 Agent 时指定渠道（推荐新部署）

powershell

cd $env:USERPROFILE\openclaw-enterprise
# 1. 总调度Agent：飞书+微信双渠道
openclaw agent add --name dispatcher --port 3000 --cwd .\dispatcher `
--model-provider qwen --model-name qwen-turbo `
--channel-feishu-enabled true --channel-feishu-appid cli_xxxx --channel-feishu-secret xxx `
--channel-wechat-enabled true --channel-wechat-appId wx_xxxx --channel-wechat-appSecret xxx
# 2. 内容创作Agent：仅飞书渠道
openclaw agent add --name creator --port 3001 --cwd .\creator `
--model-provider miaoda --model-name miaoda-model-auto `
--channel-feishu-enabled true --channel-feishu-appid cli_xxxx --channel-feishu-secret xxx
# 3. 编程Agent：飞书+钉钉双渠道
openclaw agent add --name coder --port 3007 --cwd .\coder `
--model-provider openai --model-name gpt-4o `
--channel-feishu-enabled true --channel-feishu-appid cli_xxxx --channel-feishu-secret xxx `
--channel-dingtalk-enabled true --channel-dingtalk-appKey ding_xxxx --channel-dingtalk-appSecret xxx

11.2.4 方式二：修改已有 Agent 渠道配置

单渠道（飞书）示例

powershell

# 打开编程Agent配置文件
notepad $env:USERPROFILE\openclaw-enterprise\coder\config\openclaw.json

修改 channels 字段：

json

{
  "port": 3007,
  "name": "coder",
  "model": {
    "provider": "openai",
    "name": "gpt-4o"
  },
  "channels": {
    "feishu": {
      "enabled": true,
      "appid": "cli_xxxx",
      "secret": "xxx"
    }
  }
}

多渠道（飞书 + 微信）示例

json

{
  "port": 3007,
  "name": "coder",
  "model": {
    "provider": "openai",
    "name": "gpt-4o"
  },
  "channels": {
    "feishu": {
      "enabled": true,
      "appid": "cli_xxxx",
      "secret": "xxx"
    },
    "wechat": {
      "enabled": true,
      "appId": "wx_xxxx",
      "appSecret": "xxx"
    }
  }
}

修改后重启 Agent 生效：

powershell

openclaw stop --port 3007 --cwd .\coder
openclaw start --port 3007 --cwd .\coder

11.2.5 方式三：全局渠道配置（所有 Agent 共用）

若需所有 Agent 共用同一渠道配置，可配置网关全局渠道（Agent 本地配置会覆盖全局）：

powershell

# 配置全局飞书渠道
openclaw config set channel.feishu.enabled true
openclaw config set channel.feishu.appid cli_xxxx
openclaw config set channel.feishu.secret xxx
# 重启网关使配置生效
openclaw gateway restart

11.2.6 渠道功能验证

powershell

# 1. 查看Agent渠道配置
Get-Content $env:USERPROFILE\openclaw-enterprise\dispatcher\config\openclaw.json | Select-String "channels"
# 2. 测试飞书渠道消息收发（Agent和网关均需运行）
curl -X POST http://localhost:18789/channel/feishu/test -H "Content-Type: application/json" -d '{"message":"测试飞书渠道"}'

实际场景验证：在飞书 / 微信 / 钉钉向机器人发送指令（如「写一个 Python 自动化脚本」），查看 Agent 日志确认指令接收，并验证是否收到返回结果。

11.2.7 关键注意事项

1. 渠道 enabled 设为 false 可临时禁用，无需删除配置；
2. 多渠道可同时启用，Agent 从所有启用渠道接收指令并推送结果；
3. 渠道配置错误会导致 Agent 启动失败，需检查 appid/secret 和权限；
4. 公网访问需暴露网关端口 18789，建议配置防火墙仅允许指定 IP 访问；
5. 渠道消息日志存于 Agent 的 logs 目录，可排查收发失败问题。

十二、技术栈清单（修正 OpenClaw 官方最新要求）

表格

技术模块	核心选型	备注
运行环境	Node.js v24+（LTS）	OpenClaw 官方强制要求，低于 v24 会安装 / 运行失败
核心框架	OpenClaw	一站式 Agent 管理，原生支持多 Agent 组合 / 隔离 / 多模型 / 多渠道
包管理工具	npm	Node.js 依赖管理，配置国内镜像加速下载
进程管理	OpenClaw start/stop + Windows start /b	优先 OpenClaw 原生命令，start /b 实现 Windows 后台运行
操作终端	Windows PowerShell（管理员模式）	官方推荐，兼容所有 OpenClaw 命令，避免权限不足
路径标识	%USERPROFILE%	Windows 通用用户目录，适配所有电脑，无需手动修改
可选依赖	Git v2.40+	OpenClaw 官方推荐，部分依赖拉取需要 Git

十三、常见问题排查（99% 部署问题可解决）

所有问题优先通过 OpenClaw 原生命令排查，Windows 命令仅作补充；排查命令与 Agent 无冲突名称、端口完全适配。

13.1 端口占用问题（最常见）

powershell

# 步骤1：找到占用3007端口的进程PID（示例：编程Agent）
netstat -ano | findstr :3007
# 步骤2：强制结束该进程（替换PID为实际数字，如1234）
taskkill /f /pid 1234
# 步骤3：重新启动对应Agent
openclaw start --port 3007 --cwd .\coder

13.2 Agent 启动失败 / 状态显示 stopped

powershell

# 核心排查：查看启动日志，定位错误原因（示例：总调度Agent）
Get-Content .\dispatcher\logs\start.log -Tail 20
# 编程Agent日志排查
Get-Content .\coder\logs\start.log -Tail 20

常见原因：配置文件 openclaw.json 格式错误、渠道 appid/secret 填写错误、模型服务商未配置，修正后重启 Agent 即可

备注：

适配硅基流动（SiliconFlow）API 的 Agent 大模型推荐方案

以下推荐基于硅基流动平台可调用的主流大模型，结合每个 Agent 的核心职责匹配最优模型（兼顾效果与性价比），同时提供可直接复用的 OpenClaw 配置命令，确保与你现有部署架构完全兼容。

一、前置准备：配置硅基流动 API 密钥

在管理员模式 PowerShell 中执行以下命令，配置硅基流动全局密钥（所有 Agent 可共用，也可单独为 Agent 配置）：

powershell

# 配置硅基流动 API 密钥（替换为你的实际密钥）
openclaw config set model.siliconflow.apiKey sk-xxxxxxx --model-provider siliconflow
# 验证密钥配置
openclaw config get model.siliconflow.apiKey

硅基流动 API 密钥获取路径：硅基流动控制台 → 个人中心 → API 密钥管理。

二、各 Agent 最优模型推荐（硅基流动专属）

1. dispatcher（总调度）

表格

推荐模型	模型类型	推荐理由	OpenClaw 配置参数
GLM-4（智谱）	通用大模型	逻辑推理能力强，擅长指令分发、多 Agent 协同规则解析，中文语义理解精准	--model-provider siliconflow --model-name glm-4

配置示例（创建 / 修改总调度 Agent 时使用）：

powershell

openclaw agent add --name dispatcher --port 3000 --cwd .\dispatcher `
--model-provider siliconflow --model-name glm-4 `
--channel-feishu-enabled true --channel-feishu-appid cli_xxxx --channel-feishu-secret xxx

2. creator（内容创作）

表格

推荐模型	模型类型	推荐理由	OpenClaw 配置参数
Qwen-2-14B-Instruct（通义千问）	中文创作大模型	中文创作能力顶尖，适配文案、脚本、选题策划等场景，输出风格灵活	--model-provider siliconflow --model-name qwen-2-14b-instruct

配置示例：

powershell

openclaw agent add --name creator --port 3001 --cwd .\creator `
--model-provider siliconflow --model-name qwen-2-14b-instruct `
--channel-feishu-enabled true --channel-feishu-appid cli_xxxx --channel-feishu-secret xxx

3. publisher（运营发布）

表格

推荐模型	模型类型	推荐理由	OpenClaw 配置参数
ERNIE 4.0（文心一言）	通用大模型	熟悉各平台运营规则，擅长排期文案、多平台发布话术优化，数据分析能力适配	--model-provider siliconflow --model-name ernie-4.0

配置示例：

powershell

openclaw agent add --name publisher --port 3002 --cwd .\publisher `
--model-provider siliconflow --model-name ernie-4.0 `
--channel-feishu-enabled true --channel-feishu-appid cli_xxxx --channel-feishu-secret xxx

4. infoman（信息管理）

表格

推荐模型	模型类型	推荐理由	OpenClaw 配置参数
GLM-4（智谱）	通用大模型	信息整合、数据分析、报表解读能力突出，适配运营数据复盘、策略建议场景	--model-provider siliconflow --model-name glm-4

配置示例：

powershell

openclaw agent add --name infoman --port 3003 --cwd .\infoman `
--model-provider siliconflow --model-name glm-4 `
--channel-feishu-enabled true --channel-feishu-appid cli_xxxx --channel-feishu-secret xxx

5. lifestyler（生活管理）

表格

推荐模型	模型类型	推荐理由	OpenClaw 配置参数
Spark 4.0（讯飞星火）	口语化交互模型	生活化场景适配性强，擅长日程安排、购物清单、健康提醒等口语化指令处理	--model-provider siliconflow --model-name spark-4.0

配置示例：

powershell

openclaw agent add --name lifestyler --port 3004 --cwd .\lifestyler `
--model-provider siliconflow --model-name spark-4.0 `
--channel-feishu-enabled true --channel-feishu-appid cli_xxxx --channel-feishu-secret xxx

6. designer（设计）

表格

推荐模型	模型类型	推荐理由	OpenClaw 配置参数
Qwen-VL（通义千问多模态）	多模态大模型	支持图文理解与生成，擅长海报 / 封面设计思路、版式规划、视觉素材建议	--model-provider siliconflow --model-name qwen-vl

配置示例：

powershell

openclaw agent add --name designer --port 3005 --cwd .\designer `
--model-provider siliconflow --model-name qwen-vl `
--channel-feishu-enabled true --channel-feishu-appid cli_xxxx --channel-feishu-secret xxx

7. businesser（商务）

表格

推荐模型	模型类型	推荐理由	OpenClaw 配置参数
Baichuan 4（百川）	商务场景模型	商务谈判、报价方案、合同拟写等场景适配性强，输出内容专业且符合商业逻辑	--model-provider siliconflow --model-name baichuan-4

配置示例：

powershell

openclaw agent add --name businesser --port 3006 --cwd .\businesser `
--model-provider siliconflow --model-name baichuan-4 `
--channel-feishu-enabled true --channel-feishu-appid cli_xxxx --channel-feishu-secret xxx

8. coder（编程）

表格

推荐模型	模型类型	推荐理由	OpenClaw 配置参数
Qwen-Coder-14B（通义千问代码版）	代码专用模型	硅基流动平台代码能力 TOP 级，支持 Python/JS/Shell 等多语言，调试能力突出	--model-provider siliconflow --model-name qwen-coder-14b

配置示例：

powershell

openclaw agent add --name coder --port 3007 --cwd .\coder `
--model-provider siliconflow --model-name qwen-coder-14b `
--channel-feishu-enabled true --channel-feishu-appid cli_xxxx --channel-feishu-secret xxx

三、批量配置所有 Agent 模型（替换原有配置）

若已创建 Agent 需修改为硅基流动模型，可批量执行以下命令（先停止 Agent，修改后重启）：

powershell

cd $env:USERPROFILE\openclaw-enterprise
# 1. 停止所有 Agent
openclaw stop --port 3000 --cwd .\dispatcher
openclaw stop --port 3001 --cwd .\creator
openclaw stop --port 3002 --cwd .\publisher
openclaw stop --port 3003 --cwd .\infoman
openclaw stop --port 3004 --cwd .\lifestyler
openclaw stop --port 3005 --cwd .\designer
openclaw stop --port 3006 --cwd .\businesser
openclaw stop --port 3007 --cwd .\coder

# 2. 修改各 Agent 配置文件（替换模型参数）
# 总调度
notepad .\dispatcher\config\openclaw.json  # 手动修改model.provider为siliconflow，model.name为glm-4
# 内容创作
notepad .\creator\config\openclaw.json    # 修改为siliconflow + qwen-2-14b-instruct
# 运营发布
notepad .\publisher\config\openclaw.json  # 修改为siliconflow + ernie-4.0
# 信息管理
notepad .\infoman\config\openclaw.json    # 修改为siliconflow + glm-4
# 生活管理
notepad .\lifestyler\config\openclaw.json # 修改为siliconflow + spark-4.0
# 设计
notepad .\designer\config\openclaw.json   # 修改为siliconflow + qwen-vl
# 商务
notepad .\businesser\config\openclaw.json # 修改为siliconflow + baichuan-4
# 编程
notepad .\coder\config\openclaw.json      # 修改为siliconflow + qwen-coder-14b

# 3. 重启所有 Agent
start /b openclaw start --port 3000 --cwd .\dispatcher > .\dispatcher\logs\start.log 2>&1
Start-Sleep -Seconds 2
start /b openclaw start --port 3001 --cwd .\creator > .\creator\logs\start.log 2>&1
# 其余 Agent 启动命令省略（参考原有批量启动脚本）

四、模型配置验证

执行以下命令验证模型是否配置成功并可正常调用：

powershell

cd $env:USERPROFILE\openclaw-enterprise
# 1. 验证编程 Agent 模型调用（代码场景）
curl -X POST http://localhost:3007/chat -H "Content-Type: application/json" -d '{"message":"用Python写一个读取Excel的脚本"}'
# 2. 验证设计 Agent 模型调用（多模态场景）
curl -X POST http://localhost:3005/chat -H "Content-Type: application/json" -d '{"message":"给自媒体海报设计一个视觉方案"}'
# 3. 查看 Agent 日志，确认无模型调用错误
Get-Content .\coder\logs\start.log -Tail 10
Get-Content .\designer\logs\start.log -Tail 10

验证成功标志：接口返回对应场景的有效内容，日志中无「API Key 错误」「模型不存在」等报错。