OpenClaw 与 agency-agents-zh 部署指南：构建你的本地AI助手团队与多智能体工作流

本文介绍如何通过搭建 OpenClaw 个人 AI 助手网关并集成丰富的中文智能体集合 agency-agents-zh，来组建一个高效、专业的本地多智能体协作团队。

1. 项目简介

什么是 OpenClaw？

OpenClaw 是一款 本地优先的个人 AI 助手网关（🦞 龙虾方式），支持：

• 多通讯渠道接入（微信、飞书、Telegram、WhatsApp、Discord、Slack 等）
• 多智能体路由（让不同专业智能体处理不同类型任务）
• 本地运行，数据自主可控
• 技能（Skills）、记忆、定时任务等扩展能力

什么是 agency-agents-zh？

jnMetaCode/agency-agents-zh 是一个 中文版 AI 智能体人设集合，包含：

• 80+ 个专业智能体，覆盖开发、设计、营销、测试、运维等领域
• 针对中国场景定制的专属智能体（小红书运营、抖音剪辑师、微信私域运营等）
• 每个智能体都有完整的人设文件，可直接被 OpenClaw/Claude Code 使用
• 基于英文原版 msitarzewski/agency-agents（MIT 协议）翻译并扩展

两者结合能做什么？

你的消息 → OpenClaw 网关 → 智能路由 → 对应专业智能体 → 精准回复

比如你说“帮我写一篇小红书种草文”，OpenClaw 会自动路由给“小红书运营专家”智能体处理。

---

2. 环境准备

系统要求

项目	要求
操作系统	macOS / Linux / Windows（WSL2 推荐）
Node.js	v18 或更高版本
npm	v9 或更高版本
Git	任意最新版本
API Key	Anthropic / OpenAI / ZhipuAI 等任一模型 API

检查环境

# 检查 Node.js 版本
node --version   # 应输出 v18.x.x 或更高

# 检查 npm 版本
npm --version    # 应输出 9.x.x 或更高

# 检查 Git
git --version

如果 Node.js 版本过低，推荐使用 nvm 进行版本管理：

# 安装 nvm（macOS/Linux）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# 安装并使用 Node.js 20
nvm install 20
nvm use 20

---

3. 安装 OpenClaw

方式一：npm 全局安装（推荐新手）

# 全局安装 OpenClaw CLI
npm install -g openclaw@latest

# 验证安装
openclaw --version

方式二：从源码安装

git clone https://github.com/openclaw/openclaw.git
cd openclaw
npm install
npm run build
npm link

首次初始化（Onboard）

# 运行引导向导，自动安装守护进程
openclaw onboard --install-daemon

向导会引导你完成：

1. 选择默认 AI 模型（建议先选 claude-3-5-sonnet 或国产 zai/glm-5）
2. 输入对应的 API Key
3. 选择是否安装系统守护进程（推荐选 Yes，开机自启）

验证 OpenClaw 正在运行

# 查看网关状态
openclaw status

# 运行健康检查
openclaw doctor

如果看到 Gateway: running 表示安装成功。

---

4. 克隆 agency-agents-zh

# 克隆仓库到本地
git clone https://github.com/jnMetaCode/agency-agents-zh.git

# 进入目录
cd agency-agents-zh

# 查看智能体列表
ls -la

仓库目录预览

agency-agents-zh/
├── README.md               # 项目说明
├── CONTRIBUTING.md         # 贡献指南
├── agents/                 # 所有智能体人设文件
│   ├── 开发/
│   │   ├── 前端开发者.md
│   │   ├── 后端工程师.md
│   │   ├── DevOps工程师.md
│   │   └── ...
│   ├── 设计/
│   │   ├── UI设计师.md
│   │   └── ...
│   ├── 营销/
│   │   ├── 小红书运营专家.md
│   │   ├── 抖音内容创作者.md
│   │   ├── 微信私域运营.md
│   │   └── ...
│   ├── 测试/
│   ├── 运维/
│   └── ...
└── templates/              # 智能体模板（用于自定义）

---

5. 智能体目录结构说明

每个智能体是一个 Markdown 文件，包含以下核心字段：

---
name: 前端开发者
description: 专注于 React/Vue/TypeScript 的全栈前端工程师
model: claude-3-5-sonnet   # 可选，不填则用全局默认模型
---

# 前端开发者

## 角色定位
你是一名资深前端工程师，擅长...

## 核心技能
- React 18 / Next.js 14
- TypeScript 严格模式
- Tailwind CSS / shadcn/ui
- ...

## 工作风格
- 代码优先，先写测试
- 注重性能优化...

## 禁止事项
- 不使用 class components
- 不省略 TypeScript 类型...

关键字段说明

字段	作用	是否必填
name	智能体名称，用于路由匹配	✅ 必填
description	描述，帮助 OpenClaw 自动路由	✅ 必填
model	指定该智能体使用的模型	❌ 可选
正文	智能体的详细人设和行为指南	✅ 必填

---

6. 部署智能体到 OpenClaw

OpenClaw 的智能体配置存放在 ~/.openclaw/agents/ 目录下。

方式一：批量复制（快速上手）

# 确保目标目录存在
mkdir -p ~/.openclaw/agents/

# 复制所有智能体文件
cp -r agency-agents-zh/agents/* ~/.openclaw/agents/

# 验证复制结果
ls ~/.openclaw/agents/

方式二：选择性部署（推荐）

只部署你需要的智能体，避免配置过多影响路由精确度：

# 只复制开发相关智能体
cp -r agency-agents-zh/agents/开发/* ~/.openclaw/agents/

# 只复制营销相关智能体
cp -r agency-agents-zh/agents/营销/* ~/.openclaw/agents/

方式三：通过 CLI 注册单个智能体

# 注册单个智能体
openclaw agents add ~/.openclaw/agents/前端开发者.md

# 或者用相对路径
openclaw agents add agency-agents-zh/agents/开发/前端开发者.md

验证智能体已加载

# 列出所有已注册的智能体
openclaw agents list

# 查看特定智能体详情
openclaw agents show 前端开发者

输出示例：

┌─────────────────────────────────────────┐
│ 已注册智能体列表                         │
├──────────────────┬──────────────────────┤
│ 名称             │ 描述                   │
├──────────────────┼──────────────────────┤
│ 前端开发者       │ React/Vue 全栈前端...  │
│ 小红书运营专家   │ 专注小红书内容创作...   │
│ DevOps 工程师    │ CI/CD 流水线专家...   │
│ ...              │ ...                   │
└──────────────────┴──────────────────────┘

---

7. 绑定通讯渠道（频道配置）

OpenClaw 支持将不同智能体绑定到不同的通讯群组。

支持的通讯渠道

渠道	支持状态	备注
飞书（Feishu）	✅ 支持	国内企业首选
Telegram	✅ 支持	个人使用推荐
Discord	✅ 支持	社区使用
WhatsApp	✅ 支持	需要设备配对
Slack	✅ 支持	企业协作
微信	⚠️ 有限支持	需要第三方桥接

飞书渠道配置示例

# 设置飞书机器人 Token
openclaw channels add feishu \
  --app-id YOUR_APP_ID \
  --app-secret YOUR_APP_SECRET \
  --encrypt-key YOUR_ENCRYPT_KEY

# 绑定默认群组（所有智能体都可用）
openclaw channels bind feishu \
  --group-id oc_xxxxxxxxxxxxxxxx \
  --agent default

# 绑定特定智能体到特定群组
openclaw channels bind feishu \
  --group-id oc_dev_group_id \
  --agent 前端开发者

openclaw channels bind feishu \
  --group-id oc_marketing_group_id \
  --agent 小红书运营专家

Telegram 渠道配置示例

# 添加 Telegram Bot Token
openclaw channels add telegram \
  --token YOUR_TELEGRAM_BOT_TOKEN

# 将 Telegram 群组绑定到前端开发者智能体
openclaw channels bind telegram \
  --chat-id -1001234567890 \
  --agent 前端开发者

# 验证渠道状态
openclaw channels status --probe

无渠道模式（本地直接使用）

如果不需要绑定任何通讯渠道，可以直接通过 CLI 或 WebChat 使用：

# 启动 WebChat 界面
openclaw webchat

# 直接 CLI 对话（指定智能体）
openclaw chat --agent 前端开发者 "帮我写一个 React 登录组件"

---

8. 激活与测试

启动 OpenClaw 网关

# 前台启动（调试用）
openclaw start

# 后台守护进程启动（推荐）
openclaw daemon start

# 查看运行状态
openclaw status

测试智能体响应

# 方式一：CLI 直接对话
openclaw chat --agent 前端开发者 "用 TypeScript 写一个防抖函数"

# 方式二：指定模型测试
openclaw chat --agent 小红书运营专家 --model claude-3-5-sonnet \
"帮我写一篇关于护肤品的种草文，产品是玻尿酸精华"

# 方式三：交互式对话
openclaw chat --agent DevOps工程师
> 你好！帮我设计一个 Kubernetes 部署方案

通过 WebChat 测试

# 启动 WebChat（默认端口 18789）
openclaw webchat

# 浏览器访问
open http://localhost:18789

在 WebChat 界面中，你可以：

• 顶部下拉菜单切换不同智能体
• 查看路由日志，确认消息被正确路由
• 查看 token 消耗和对话历史

在飞书群测试

在飞书群中发送消息时，使用 @ 提及智能体：

@前端开发者 帮我 review 这段代码：
const add = (a, b) => a + b

或者直接发送消息（需要开启自动路由）：

用 Vue3 写一个轮播图组件

---

9. 多智能体协作工作流

场景一：开发团队工作流

假设你在开发一个电商网站，以下是典型的协作流程：

# 步骤 1：产品经理智能体整理需求
openclaw chat --agent 产品经理 \
"我们要做一个商品详情页，用户可以查看图片、加入购物车、查看评价"

# 步骤 2：前端开发者实现 UI
openclaw chat --agent 前端开发者 \
"基于上述需求，用 React + TypeScript 实现商品详情页组件结构"

# 步骤 3：后端工程师设计 API
openclaw chat --agent 后端工程师 \
"为商品详情页设计 RESTful API 接口文档"

# 步骤 4：测试工程师编写测试
openclaw chat --agent 测试工程师 \
"为商品详情页功能编写测试用例"

场景二：内容营销工作流

# 策划阶段
openclaw chat --agent 内容策划师 \
"给我规划一个护肤品牌在小红书的一周内容矩阵"

# 文案创作
openclaw chat --agent 小红书运营专家 \
"根据上述规划，写周一的种草文，主题是‘懒人护肤步骤’"

# 短视频脚本
openclaw chat --agent 抖音内容创作者 \
"把这篇种草文改成 60 秒的抖音视频脚本"

场景三：Agent-to-Agent（A2A）自动协作

OpenClaw 支持智能体之间直接通信，无需人工中转：

在智能体配置文件中添加 agentToAgent 工具调用：

---
name: 技术 Lead
description: 技术负责人，负责任务分发和成果整合
tools:
  - agentToAgent
---

## 工作流程

当收到开发任务时：
1. 将 UI 任务委派给 `前端开发者`
2. 将 API 任务委派给 `后端工程师`
3. 整合两者输出，给出完整方案

使用 agentToAgent 工具时，指定 `agent` 参数为目标智能体名称。

---

10. 自定义与扩展

修改现有智能体

# 编辑智能体配置
vim ~/.openclaw/agents/前端开发者.md

# 或者直接在 agency-agents-zh 目录中编辑后重新复制
vim agency-agents-zh/agents/开发/前端开发者.md
cp agency-agents-zh/agents/开发/前端开发者.md ~/.openclaw/agents/

# 重新加载（无需重启网关）
openclaw agents reload 前端开发者

创建全新智能体

参考以下模板创建新智能体：

---
name: 你的智能体名称
description: 一句话描述，OpenClaw 用它来自动路由
model: claude-3-5-sonnet   # 可选
tags:
  - 开发
  - 中文
---

# [智能体名称]

## 角色定位
你是...（明确的角色定义）

## 专业技能
- 技能 1
- 技能 2
- ...

## 回复风格
- 使用简洁的中文
- 代码示例要完整可运行
- ...

## 工作流程
1. 首先理解用户需求...
2. 然后...
3. 最后...

## 禁止事项
- 不做 X
- 不说 Y

保存为 ~/.openclaw/agents/你的智能体名称.md，然后：

openclaw agents add ~/.openclaw/agents/你的智能体名称.md

为智能体配置不同模型

不同智能体可以使用不同的模型，根据需求和预算灵活配置：

---
name: 代码评审专家
model: claude-opus-4-5   # 复杂任务用更强的模型
---

---
name: 快速问答助手
model: claude-haiku-4-5  # 简单任务用轻量模型节省成本
---

使用国内模型（降低成本）

---
name: 小红书运营专家
model: zai/glm-5    # 智谱 GLM，对中文场景更友好
---

支持的国内模型（需要在 OpenClaw 中配置对应 API Key）：

• zai/glm-5 - 智谱 AI GLM-5
• deepseek/deepseek-chat - DeepSeek
• qwen/qwen-max - 通义千问 Max
• moonshot/moonshot-v1-128k - Kimi

---

11. 常见问题 FAQ

Q1：智能体没有被正确路由，怎么办？

原因： 智能体的 description 字段不够清晰，导致 OpenClaw 无法判断路由目标。

解决方案：

# 查看路由日志
openclaw logs --filter routing

# 手动指定智能体（绕过自动路由）
openclaw chat --agent 精确的智能体名称 “你的消息”

也可以优化 description 字段，加入更多关键词：

---
description: 前端开发专家，负责 React、Vue、HTML、CSS、JavaScript、TypeScript、组件开发、UI 实现等任务
---

Q2：API Key 如何配置？

# 查看当前模型配置
openclaw config show

# 设置 Anthropic API Key
openclaw config set anthropic.apiKey "sk-ant-xxxxx"

# 设置智谱 AI Key
openclaw config set zai.apiKey "your-zhipu-key"

# 设置 OpenAI Key（如果使用 GPT 模型）
openclaw config set openai.apiKey "sk-xxxxx"

Q3：如何在飞书中让机器人只响应被 @ 的消息？

编辑 OpenClaw 配置：

openclaw config set feishu.requireMention true

或者在 setup.sh 中传入参数（如果使用自动安装脚本）：

./setup.sh --channel feishu --require-mention true --group-id oc_xxx

Q4：智能体数量太多，消息路由变慢怎么办？

建议：

1. 只部署你常用的 10-20 个智能体
2. 对不同群组绑定不同智能体（减少路由搜索范围）
3. 在对话时直接 @智能体名称 绕过路由

Q5：如何查看对话历史？

# 查看所有对话历史
openclaw sessions list

# 查看特定智能体的对话历史
openclaw sessions list --agent 前端开发者

# 导出对话记录
openclaw sessions export --format json > history.json

Q6：网关崩溃了怎么恢复？

# 查看错误日志
openclaw logs --level error --tail 50

# 重启网关
openclaw daemon restart

# 如果仍有问题，运行诊断
openclaw doctor --fix

Q7：如何贡献新的中文智能体到 agency-agents-zh？

1. Fork https://github.com/jnMetaCode/agency-agents-zh
2. 在对应分类目录下创建新的 .md 文件
3. 参考项目的 CONTRIBUTING.md 规范
4. 提交 Pull Request

特别欢迎贡献针对中国平台的专属智能体：

• 微信小程序开发者
• B站视频创作者
• 知乎专栏作者
• 拼多多商家运营
• 高德/百度地图 LBS 开发者

---

附录：常用命令速查表

# 安装与初始化
npm install -g openclaw@latest        # 安装 OpenClaw
openclaw onboard --install-daemon     # 首次初始化

# 智能体管理
openclaw agents list                  # 列出所有智能体
openclaw agents add <file>            # 注册智能体
openclaw agents show <name>           # 查看智能体详情
openclaw agents reload <name>         # 热重载智能体配置

# 对话
openclaw chat                         # 默认智能体对话
openclaw chat --agent <name> “<msg>”  # 指定智能体对话
openclaw webchat                      # 启动 Web 界面

# 渠道管理
openclaw channels list                # 列出渠道
openclaw channels status --probe      # 检查渠道连接状态
openclaw channels bind <ch> --agent   # 绑定智能体到渠道

# 系统管理
openclaw status                       # 查看网关状态
openclaw daemon start/stop/restart    # 守护进程控制
openclaw logs --tail 100              # 查看日志
openclaw doctor                       # 运行诊断
openclaw config show                  # 查看配置

---

教程基于 OpenClaw 最新版本和 jnMetaCode/agency-agents-zh 仓库内容整理。

https://github.com/jnMetaCode/agency-agents-zh

https://github.com/msitarzewski/agency-agents（原版）

如果你对本地部署多智能体人工智能助手感兴趣，欢迎到 云栈社区 的相关板块交流讨论。