n8n调用openclaw & hermes agents 工作流架构
This commit is contained in:
152
Clippings/n8n调用hermes agents的工作流架构.md
Normal file
152
Clippings/n8n调用hermes agents的工作流架构.md
Normal file
@@ -0,0 +1,152 @@
|
||||
---
|
||||
title: "n8n调用openclaw/hermes agents的工作流架构"
|
||||
source: "https://claude.ai/chat/a18d1fa2-7e98-4f86-bac0-1167281eb151"
|
||||
author:
|
||||
published:
|
||||
created: 2026-04-20
|
||||
description: "Claude conversation with 8 messages"
|
||||
tags:
|
||||
- "clippings"
|
||||
---
|
||||
好消息！**Hermes Agent 内置了 OpenAI 兼容的 API Server**，完全不需要额外写任何代码，直接配置开启就行。
|
||||
|
||||
---
|
||||
|
||||
## 第一步：开启 Hermes API Server
|
||||
|
||||
Hermes 的 API Server 会将 hermes-agent 暴露为一个 OpenAI 兼容的 HTTP 端点，默认端口是 **8642**。 [GitHub](https://github.com/NousResearch/hermes-agent/blob/main/website/docs/user-guide/features/api-server.md)
|
||||
|
||||
bash
|
||||
|
||||
```bash
|
||||
# 开启 API Server
|
||||
hermes config set API_SERVER_ENABLED true
|
||||
|
||||
# 设置一个访问密钥（必须）
|
||||
hermes config set API_SERVER_KEY your-secret-key
|
||||
|
||||
# 启动 Gateway（API Server 随之运行）
|
||||
hermes gateway install # 安装为系统服务
|
||||
hermes gateway start # 启动
|
||||
```
|
||||
|
||||
验证是否正常运行：
|
||||
|
||||
bash
|
||||
|
||||
```bash
|
||||
curl http://localhost:8642/v1/health
|
||||
# 返回 {"status": "ok"} 即成功
|
||||
```
|
||||
|
||||
```bash
|
||||
weishen@WeideMac-mini ~ % hermes config set API_SERVER_ENABLED true
|
||||
✓ Set API_SERVER_ENABLED = True in /Users/weishen/.hermes/config.yaml
|
||||
weishen@WeideMac-mini ~ % nano /Users/weishen/.hermes/config.yaml
|
||||
weishen@WeideMac-mini ~ % hermes config set API_SERVER_KEY 01KPN2YYSEV56BZQSQX9XGW6VH
|
||||
✓ Set API_SERVER_KEY = 01KPN2YYSEV56BZQSQX9XGW6VH in /Users/weishen/.hermes/config.yaml
|
||||
weishen@WeideMac-mini ~ % nano /Users/weishen/.hermes/config.yaml
|
||||
weishen@WeideMac-mini ~ % hermes gateway restart
|
||||
✓ Service restarted
|
||||
weishen@WeideMac-mini ~ % curl http://localhost:8642/v1/health
|
||||
{"status": "ok", "platform": "hermes-agent"}% weishen@WeideMac-mini ~ % curl http://localhost:8642/v1/chat/completions \
|
||||
-H "Authorization: Bearer 01KPN2YYSEV56BZQSQX9XGW6VH" \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"model": "hermes-agent", "messages": [{"role": "user", "content": "Hello!"}]}'
|
||||
{"id": "chatcmpl-e1569aadb12b4e36aedd9198b29e1", "object": "chat.completion", "created": 1776677020, "model": "hermes-agent", "choices": [{"index": 0, "message": {"role": "assistant", "content": "Hello! How can I help today?"}, "finish_reason": "stop"}], "usage": {"prompt_tokens": 11458, "completion_tokens": 63, "total_tokens": 11521}}%
|
||||
```
|
||||
---
|
||||
|
||||
## 第二步：为每个 Agent 创建独立 Profile
|
||||
|
||||
你可以用 Profile 的方式为每个用户/角色创建独立的 Hermes 实例，每个 profile 跑在不同端口，配置独立的 API key。 [GitHub](https://github.com/NousResearch/hermes-agent/blob/main/website/docs/user-guide/features/api-server.md)
|
||||
|
||||
bash
|
||||
|
||||
```bash
|
||||
# 创建三个专用 Agent（以任务分工为例）
|
||||
hermes profile create agent-researcher
|
||||
hermes profile create agent-writer
|
||||
hermes profile create agent-coder
|
||||
|
||||
# 分别配置端口和 key
|
||||
hermes -p agent-researcher config set API_SERVER_ENABLED true
|
||||
hermes -p agent-researcher config set API_SERVER_PORT 8643
|
||||
hermes -p agent-researcher config set API_SERVER_KEY key-researcher
|
||||
|
||||
hermes -p agent-writer config set API_SERVER_ENABLED true
|
||||
hermes -p agent-writer config set API_SERVER_PORT 8644
|
||||
hermes -p agent-writer config set API_SERVER_KEY key-writer
|
||||
|
||||
hermes -p agent-coder config set API_SERVER_ENABLED true
|
||||
hermes -p agent-coder config set API_SERVER_PORT 8645
|
||||
hermes -p agent-coder config set API_SERVER_KEY key-coder
|
||||
|
||||
# 分别启动三个 gateway
|
||||
hermes -p agent-researcher gateway &
|
||||
hermes -p agent-writer gateway &
|
||||
hermes -p agent-coder gateway &
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 第三步：在 n8n 中调用
|
||||
|
||||
每个 Agent 都是标准的 OpenAI 格式接口，在 n8n 中用 **HTTP Request 节点**：
|
||||
|
||||
|字段|填写内容|
|
||||
|---|---|
|
||||
|Method|POST|
|
||||
|URL|`http://localhost:8643/v1/chat/completions`|
|
||||
|Header: Authorization|`Bearer key-researcher`|
|
||||
|Header: Content-Type|`application/json`|
|
||||
|
||||
Body（JSON）：
|
||||
|
||||
json
|
||||
|
||||
```json
|
||||
{
|
||||
"model": "agent-researcher",
|
||||
"messages": [
|
||||
{
|
||||
"role": "system",
|
||||
"content": "你是一个专门负责网络调研的Agent，请搜索并总结信息"
|
||||
},
|
||||
{
|
||||
"role": "user",
|
||||
"content": "{{ $json.task }}"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 多轮对话保持上下文（重要）
|
||||
|
||||
v0.7.0 起 API Server 支持通过 `X-Hermes-Session-Id` header 来保持会话连续性，让 chat-completions 客户端也能跨请求共享同一个 session。 [GitHub](https://github.com/mudrii/hermes-agent-docs)
|
||||
|
||||
在 n8n 的 HTTP Request 节点 Header 中加一行：
|
||||
|
||||
```
|
||||
X-Hermes-Session-Id: my-workflow-session-001
|
||||
```
|
||||
|
||||
这样同一个工作流里的多次调用会共享上下文，非常适合需要多步推理的任务链。
|
||||
|
||||
---
|
||||
|
||||
## 完整架构示意
|
||||
|
||||
```
|
||||
n8n Workflow
|
||||
│
|
||||
├─ [HTTP Request] → localhost:8643 (agent-researcher) → 搜索/调研
|
||||
│
|
||||
├─ [HTTP Request] → localhost:8644 (agent-writer) → 内容生成
|
||||
│
|
||||
└─ [HTTP Request] → localhost:8645 (agent-coder) → 代码任务
|
||||
```
|
||||
|
||||
这套方案完全原生支持，不需要任何额外中间件。你现在的 Hermes 是哪个版本？可以用 `hermes version` 确认一下，部分特性需要 v0.4.0+。
|
||||
Reference in New Issue
Block a user