OpenClaw 接入 HuanCode 配置指南（国内直连，无需梯子）

OpenClaw 是一个开源的 AI Agent 框架，基于 Hermes Agent 构建，专为开发者设计，支持通过 OpenAI 兼容接口调用各种大语言模型。

国内使用 OpenClaw 面临同样的问题：官方 API 需要代理，境外信用卡才能充值。本文介绍通过 HuanCode 解决——国内直连，微信支付，改一行 base_url 即可。

前提条件

• 已安装 OpenClaw（见下方安装步骤）
• 已在 HuanCode 控制台 创建 API Key
• 账户余额充足（微信充值，余额永久有效）

安装 OpenClaw

# 安装 Hermes Agent（OpenClaw 的运行环境）
npm install -g @hermes-agi/hermes

# 验证安装
hermes --version

配置方式

OpenClaw 通过 Hermes Agent 的配置文件管理 LLM 接入，配置文件位于 ~/.hermes/config.yaml。

配置 HuanCode 作为 Provider

编辑 ~/.hermes/config.yaml，添加 HuanCode provider：

providers:
  - name: huancode
    type: openai
    base_url: https://api.huancode.com/v1
    api_key: 你的 HuanCode API Key

default_provider: huancode
default_model: claude-sonnet-4.6

将 你的 HuanCode API Key 替换为在 控制台 创建的 Key。

通过环境变量配置

也可以用环境变量，适合 CI/CD 或不想明文写配置文件的场景：

export OPENAI_API_KEY="你的 HuanCode API Key"
export OPENAI_BASE_URL="https://api.huancode.com/v1"

写入 shell 配置文件使其永久生效：

export OPENAI_API_KEY="你的 HuanCode API Key"
export OPENAI_BASE_URL="https://api.huancode.com/v1"

验证配置

启动 Hermes Agent，发一条测试消息：

hermes

或者直接调用 API 验证连通性：

curl https://api.huancode.com/v1/models \
  -H "Authorization: Bearer 你的 HuanCode API Key"

能返回模型列表说明配置正确。

切换模型

HuanCode 支持多家主流模型，在配置文件中修改 default_model 即可切换：

常见问题

提示 "Invalid API Key" 或 401

• 确认 api_key 填的是 HuanCode 的 Key，不是 OpenAI 官方的
• Key 前后不要有多余空格
• 在 控制台 确认 Key 处于启用状态

提示 "Connection refused" 或超时

• 确认 base_url 为 https://api.huancode.com/v1，末尾不要多余的 /
• HuanCode 是国内直连，不需要也不应该开代理访问

余额不足

登录 控制台 → 充值 微信充值，用量页面 可查看每次请求的 token 消耗。

下一步

• 查看 支持的模型列表 了解所有可用模型
• 查看 API 参考 了解完整接口说明
• 遇到问题？查看 常见问题