从零搭建多Agent系统：30分钟实操指南

一份从零开始的实操手册，带你用最短路径搭建一个可运行的多 Agent 系统原型，并直接复用 StockAgent 验证过的架构模式和工程经验。

一、环境准备：30 分钟跑通第一个 Agent

1.1 前置条件

项目

最低要求

推荐配置

1.2 安装 OpenClaw

# 1. 安装 Node.js（如果没有）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash –
sudo apt-get install -y nodejs

# 2. 全局安装 OpenClaw CLI
npm install -g openclaw

# 3. 初始化工作区
mkdir -p my-agent-project && cd my-agent-project
openclaw init

# 4. 验证安装
openclaw –version
# 输出类似: OpenClaw V2026.x.x

1.3 配置模型 Provider

OpenClaw 本身不包含 LLM——你需要接入一个模型服务。以下是最常见的三种方式：

方式一：DeepSeek 官方 API（最简单，推荐新手起步）

// ~/.openclaw/openclaw.json → models.providers 部分
{
\”my-deepseek\”: {
\”type\”: \”openai-compatible\”,
\”baseUrl\”: \”https://api.deepseek.com/v1\”,
\”apiKey\”: \”sk-你的API密钥\”,
\”models\”: [
{ \”id\”: \”deepseek-chat\”, \”contextWindow\”: 64000, \”maxTokens\”: 8192 }
]
}
}

方式二：腾讯云 LKEAP（我们生产环境用的，支持 DeepSeek-V3.2）

{
\”tcloud-lkeap\”: {
\”type\”: \”openai-compatible\”,
\”baseUrl\”: \”https://lkeap.cloud.tencent.com/v1\”,
\”apiKey\”: \”你的腾讯云API密钥\”,
\”models\”: [
{ \”id\”: \”deepseek-v3.2-exp\”, \”contextWindow\”: 131072, \”maxTokens\”: 8192 }
]
}
}

方式三：本地 Ollama（完全免费，适合开发调试）

# 先装 Ollama
curl -fsSL https://ollama.ai/install.sh | sh

# 拉取模型
ollama pull qwen2.5:7b # 7B 参数，普通电脑就能跑

# 配置 OpenClaw
{
\”local-ollama\”: {
\”type\”: \”openai-compatible\”,
\”baseUrl\”: \”http://localhost:11434/v1\”,
\”models\”: [
{ \”id\”: \”qwen2.5:7b\”, \”contextWindow\”: 32768, \”maxTokens\”: 4096 }
]
}
}

验证模型连通性：

openclaw gateway status
# 如果看到 \”Gateway is running\” + 模型列表，说明配置成功

1.4 创建你的第一个 Agent

# 创建 Agent 目录结构
cd ~/.openclaw/agents
mkdir -p my-first-agent/skills

# 写入 SOUL.md（Agent 的\”大脑\”）
cat > my-first-agent/SOUL.md << \’EOF\’
# 我的第一个 Agent

你是一个智能助手。

## 核心能力
– 回答用户问题
– 使用工具获取信息
– 用中文回复

## 行为规则
[必须] 使用中文回答所有问题。
[必须] 不知道的事情就说不知道，不要编造。
[禁止] 输出过长的回答（超过500字时请精简）。

## 工具使用
使用工具前请先查看 tool-catalog.md 了解每个工具的用法。
EOF

# 写入 tool-catalog.md（工具手册）
cat > my-first-agent/skills/tool-catalog.md << \’EOF\’
# 工具调用手册

## 可用工具

### exec — 执行命令
用法: `exec <命令字符串>`
说明: 在服务器上执行 shell 命令并获取输出
示例:
– `exec python3 hello.py` — 运行 Python 脚本
– `exec cat /tmp/data.txt` — 读取文件内容
注意: 复合命令（含 && | ; ）可能被 Gateway 拦截，请使用独立命令

### web_search — 网络搜索
用法: `web_search \”<搜索关键词>\”`
说明: 搜索互联网获取最新信息
示例: `web_search \”2025年GDP数据\”`
EOF

# 注册 Agent 到 openclaw.json
# 编辑 ~/.openclaw/openclaw.json，在 agents 部分添加：
// ~/.openclaw/openclaw.json → agents 部分
{
\”agents\”: {
\”my-first-agent\”: {
\”model\”: { \”provider\”: \”my-deepseek\”, \”model\”: \”deepseek-chat\” },
\”soulFile\”: \”SOUL.md\”
}
}
}
# 重启 Gateway 使配置生效
openclaw gateway restart

# 测试你的第一个 Agent
openclaw chat my-first-agent
# 输入: 你好，介绍一下你自己
# 如果 Agent 正常回复 → 🎉 恭喜，你的第一个 Agent 跑通了！

常见问题：

问题

可能原因

解决方案