用 Hermes 安装 OpenClaw 并配置 Claude Opus 4.7 模型

OpenClaw 是一个个人 AI 助手框架，支持多模型、多平台接入。本文记录如何通过 Hermes Agent 来安装 OpenClaw，并配置 Claude Opus 4.7 作为主力模型——使用 apikey.fun 代理，不需要 Anthropic 官方 API Key。

为什么选 OpenClaw + Claude Opus 4.7

对比Hermes AgentOpenClaw
定位全能 AI agent，工具链整合轻量对话助手，专注多模型切换
优势技能系统、定时任务、持久记忆快速模型切换、飞书原生集成
适合复杂自动化任务日常问答、多模型对比

两者并行使用：Hermes 做重活，OpenClaw 做轻对话。Claude Opus 4.7 是目前最强的通用模型之一，配上 apikey.fun 代理可以大幅降低成本。

前置条件

第一步：安装 OpenClaw

通过 npm 全局安装：

npm install -g openclaw

Hermes 的 node 环境会自动处理路径，安装后二进制位于：

~/.hermes/node/bin/openclaw

验证安装：

openclaw --version

第二步：初始化配置

openclaw configure

按向导选择：

第三步：注册 apikeyfun Provider

OpenClaw 原生支持 Anthropic、OpenRouter 等 provider，但我们要用 apikey.fun 代理。需要手动注册自定义 provider：

openclaw config set models.providers.apikeyfun.baseUrl "https://api.apikey.fun"
openclaw config set models.providers.apikeyfun.api "anthropic-messages"
openclaw config set models.providers.apikeyfun.models '[{"id":"claude-opus-4-7","name":"Claude Opus 4.7","contextWindow":200000,"maxTokens":16384,"reasoning":false,"input":["text"],"cost":{"input":0,"output":0,"cacheRead":0,"cacheWrite":0}}]' --strict-json

关键参数说明：

第四步：配置认证

设置 apikeyfun 的 API Key：

openclaw auth set apikeyfun:api-key --key "你的apikey.fun密钥"

第五步：设置主力模型

openclaw config set agents.defaults.model.primary "apikeyfun/claude-opus-4-7"
openclaw config set agents.defaults.model.fallbacks '["deepseek/deepseek-v4-pro"]' --strict-json

这样 Claude Opus 4.7 作为主模型，DeepSeek V4 Pro 作为回退。

第六步：接入飞书

openclaw configure

选择飞书通道，填入 App ID 和 App Secret。连接模式选 websocket。

第七步：启动网关

openclaw gateway

看到 gateway ready 和 WebSocket client started 就说明成功了。

踩坑记录

这次配置过程中遇到了几个坑，记录下来供参考：

坑一：模型名带前缀导致 503

apikey.fun 只接受 claude-opus-4-7 作为模型名。如果用 OpenRouter provider，它会自动拼成 anthropic/claude-opus-4-7，导致 503 错误：

503 No available accounts: no available accounts

解决：不用 openrouter provider，创建独立的 apikeyfun provider。

坑二：maxTokens 未设置

Anthropic Messages 协议要求必须传 max_tokens 参数。如果模型配置里 maxTokens 为 0 或缺失：

Anthropic Messages transport requires a positive maxTokens value

解决：模型配置里 maxTokens 设为 16384。

坑三：Session 级模型覆盖

OpenClaw 的 session 会记住你选过的模型。即使全局配置改了，旧 session 还是用老模型。表现为改完配置重启后还是报错。

解决：在飞书发 /new 开新 session，或手动编辑 ~/.openclaw/agents/main/sessions/sessions.json 清除 modelOverride 字段。

坑四：Auth Profile 绑定

切换 provider 后，session 可能还绑着旧的 auth profile（比如 openrouter:default）。需要清除 authProfileOverride 字段。

最终效果

配好之后，在飞书里直接跟 OpenClaw 对话，底层走的是 Claude Opus 4.7：

环境信息

💬 评论