OpenClaw + WisGate 配置中心

OpenClaw 专区

把 WhatsApp、Telegram、Discord、Slack 等渠道接到自托管 AI agent gateway,再用 WisGate 统一管理模型、成本和回退策略。

多频道
聊天、工具与自动化入口
/v1
OpenAI-compatible endpoint
2 套
OpenClaw 与 Hermes 配置

先弄清楚它是什么

OpenClaw 是自托管的 AI assistant gateway

它不是单个抓取模型,而是把消息渠道、工具、定时任务和 LLM 连接在一起的本地优先 agent 框架。

自托管优先

核心服务运行在您自己的环境里,便于控制数据、密钥、日志和权限边界。

多渠道接入

将 WhatsApp、Telegram、Discord、Slack、iMessage 等入口统一到同一套 agent 工作流。

模型无关

可接 OpenAI-compatible endpoint、本地模型或前沿模型,让不同任务走不同能力与价格。

自动化友好

支持 cron、webhook、工具调用和多步骤任务,适合做常驻助手与团队自动化。

为什么配 WisGate

一个统一入口,给 OpenClaw 和 Hermes 选模型

WisGate 提供 OpenAI-compatible API。您可以先把 agent 接到统一 endpoint,再按任务选择 Claude、GPT、DeepSeek、Gemini 或其他可用模型。

推荐 endpoint
https://api.wisgate.cn/v1

减少密钥分散

把多家模型供应商的 key 管理压力收敛到一个 WisGate API key,便于团队配置和轮换。

兼容现有 agent

使用 OpenAI-compatible `/v1` 接口,OpenClaw、Hermes 这类支持自定义 endpoint 的工具都能接入。

按任务切模型

日常聊天、代码修复、长文研究、低成本批处理可以走不同模型,而不是被单一订阅锁死。

更容易做回退

当高阶模型不可用或成本过高时,可配置备用模型,降低常驻 agent 中断风险。

场景地图

这些任务最适合放进 Claw 专区

页面不堆概念,而是帮用户判断:我该用 OpenClaw 做什么,什么时候需要 Hermes。

OpenClaw

个人常驻助手

跨聊天软件收消息、整理提醒、回答上下文问题,并把常用工具接进同一入口。

OpenClaw

团队协作入口

在 Slack 或 Discord 中接入项目问答、任务分派、知识库检索和工程自动化。

OpenClaw + Hermes

研究与摘要

定时追踪新闻、财报、产品动态或技术文章,再把摘要推送给团队。

OpenClaw

DevOps 与自愈

接收告警、执行诊断、触发 webhook 或 n8n 流程,处理重复性的运行维护动作。

OpenClaw

社媒监听

监控 X、Reddit、YouTube 或社区关键词,按规则汇总趋势和风险信号。

OpenClaw + Hermes

创作流水线

把资料收集、脚本草稿、图片生成、发布检查拆成多个 agent 步骤。

OpenClaw 配置速查

从 onboarding 到安全上线

页面建议给用户一条可执行路径:先初始化,再配置 WisGate endpoint,最后做权限和连通性检查。

01

初始化 OpenClaw

运行 `openclaw onboard` 完成首次引导,生成本地配置并确认需要启用的消息渠道。

02

编辑 OpenClaw 配置文件

把主要配置放在 `~/.openclaw/openclaw.json`,密钥通过环境变量注入,不直接提交到代码仓库。

03

接入 WisGate provider

使用 `https://api.wisgate.cn/v1` 作为 OpenAI-compatible base URL,并设置默认模型与备用模型。

04

设置 allowlist 与 webhook token

只允许可信用户或群组调用 agent,为 webhook 单独配置 token,避免公开入口被滥用。

05

上线前运行检查

通过 `openclaw doctor` 检查配置、连接和权限,再用小范围频道试运行。

示例配置

~/.openclaw/openclaw.json
{
  "llm": {
    "provider": "openai-compatible",
    "baseUrl": "https://api.wisgate.cn/v1",
    "apiKey": "$WISGATE_API_KEY",
    "model": "claude-opus-4-7",
    "fallbackModels": ["gpt-5.5", "deepseek-v4-pro"]
  },
  "security": {
    "allowedUsers": ["you@example.com"],
    "webhookToken": "$OPENCLAW_WEBHOOK_TOKEN"
  }
}

常用检查命令

openclaw onboard
openclaw doctor
hermes model

Hermes 配置补全

Hermes 接 WisGate 的清晰路径

把 Hermes 当作 OpenClaw 专区里的补充配置:先用官方向导连上 WisGate,再把可复用的 YAML、密钥和验证步骤整理清楚。

01

运行 Hermes 模型向导

运行 `hermes model`,选择 `Add Custom Endpoint` 或 `Custom endpoint`,填写 WisGate base URL、API key 和模型名。

02

固化到 config.yaml

确认向导可用后,把团队模板整理到 `~/.hermes/config.yaml`,主模型 provider 使用 `custom`。

03

填入 WisGate endpoint

默认使用 `https://api.wisgate.cn/v1` 作为接入地址。

04

密钥用变量引用

在 YAML 里写 `api_key: $`,再通过 `.env` 或部署环境注入,避免复制配置时泄露 key。

05

新会话验证

运行 `hermes config check`,再用新 session 测试;如果使用 gateway 模式,改完配置后重启 gateway。

Hermes 手动配置

~/.hermes/config.yaml
model:
  default: claude-opus-4-7
  provider: custom
  base_url: https://api.wisgate.cn/v1
  api_key: ${WISGATE_API_KEY}

auxiliary:
  compression:
    provider: auto
    model: ''
  vision:
    provider: auto
    model: ''

terminal:
  backend: docker
  cwd: "."
  timeout: 180

推荐优先用 `hermes model` 配置 Custom endpoint;手动编辑时使用 `~/.hermes/config.yaml`。API key 建议通过 `~/.hermes/.env` 或部署环境注入,不写死在可提交文件里。

验证命令与排错

hermes model
hermes config check
hermes gateway restart

怎么选

OpenClaw vs Hermes

二者不是简单替代关系。OpenClaw 更像入口和编排层,Hermes 更像会积累技能的长期执行者。

维度OpenClawHermes
最适合多频道个人助手、团队入口、聊天驱动的自动化。重复任务、自我改进、长期技能沉淀和批量执行。
核心优势连接渠道、工具、webhook、cron 和模型路由。把经验沉淀为可复用技能,适合越跑越熟的工作流。
部署心智先把 gateway 和渠道跑稳,再逐步增加自动化。先定义任务环境和模型配置,再观察执行质量。
记忆与学习偏消息上下文、工具上下文和会话编排。偏长期任务经验、技能生成和自我优化。
WisGate 的角色统一 LLM endpoint,让不同频道共享模型策略。作为 Custom endpoint,给 Hermes 提供稳定模型入口。

安全上线清单

让常驻 agent 可控、可查、可回退

密钥不入库

API key、webhook token、聊天平台 token 都通过环境变量或密钥管理服务注入。

限制用户和频道

先只开放给可信账号或内部频道,再根据日志逐步扩大范围。

Webhook 单独鉴权

为 webhook 设置独立 token,并记录来源、时间和执行结果。

工具最小权限

文件、浏览器、终端、第三方 API 都按任务最小授权,不给默认全权限。

保留审计日志

记录触发来源、输入摘要、调用工具、模型响应和执行结果,方便追踪误操作与回滚。

上线前做连通性检查

先检查配置、模型、网络和权限;如果工具提供 `doctor` 或 `config check` 命令,可作为上线前检查的一部分。