教程 | Yadong's Blog

火山引擎 OpenClaw 配置智谱 API：绕过 Coding Plan 使用免费 API Key

Tue, 17 Mar 2026 10:00:00 +0800

背景

火山引擎的 OpenClaw 是一个强大的 AI 编程助手，但默认情况下需要使用字节提供的 Coding Plan 进行计费。对于个人开发者或小型团队来说，如果能使用智谱 AI 提供的免费 API Key，可以大大降低成本。

本文将详细介绍如何在火山引擎 OpenClaw 中配置智谱 AI 的 API Key，实现自定义模型接入。

步骤

1. 注册智谱 AI 账号

访问注册账号：

使用手机号或邮箱注册
完成实名认证（个人认证即可）
进入控制台获取 API Key

2. 获取智谱 API Key

登录后进入：

点击 “添加新的 API Key”
为 Key 命名（如 “OpenClaw-Config”）
复制生成的 API Key（格式为 sk-xxxxxxxxxxxxxxxx）

注意：新注册用户通常有免费的额度，足够个人开发使用。

3. 确认火山引擎 OpenClaw 已安装并配置好了飞书机器人

此时发送消息，飞书机器人报错提示并不存在 API Key。

我们直接修改 ~/.openclaw/openclaw.json：

"auth": {
 "profiles": {
 "zai:default": {
 "provider": "zai",
 "mode": "api_key"
 }
 }
},
"models": {
 "mode": "merge",
 "providers": {
 "zai": {
 "baseUrl": "https://open.bigmodel.cn/api/paas/v4",
 "api": "openai-completions",
 "models": [
 {
 "id": "glm-5",
 "name": "GLM-5",
 "reasoning": true,
 "input": [
 "text"
 ],
 "cost": {
 "input": 0,
 "output": 0,
 "cacheRead": 0,
 "cacheWrite": 0
 },
 "contextWindow": 204800,
 "maxTokens": 131072
 },
 {
 "id": "glm-4.7",
 "name": "GLM-4.7",
 "reasoning": true,
 "input": [
 "text"
 ],
 "cost": {
 "input": 0,
 "output": 0,
 "cacheRead": 0,
 "cacheWrite": 0
 },
 "contextWindow": 204800,
 "maxTokens": 131072
 },
 {
 "id": "glm-4.7-flash",
 "name": "GLM-4.7 Flash",
 "reasoning": true,
 "input": [
 "text"
 ],
 "cost": {
 "input": 0,
 "output": 0,
 "cacheRead": 0,
 "cacheWrite": 0
 },
 "contextWindow": 204800,
 "maxTokens": 131072
 },
 {
 "id": "glm-4.7-flashx",
 "name": "GLM-4.7 FlashX",
 "reasoning": true,
 "input": [
 "text"
 ],
 "cost": {
 "input": 0,
 "output": 0,
 "cacheRead": 0,
 "cacheWrite": 0
 },
 "contextWindow": 204800,
 "maxTokens": 131072
 }
 ]
 }
 }
},
"agents": {
 "defaults": {
 "models": {
 "zai/glm-4.7-flash": {
 "alias": "GLM"
 }
 },
 "workspace": "/root/.openclaw/workspace",
 "compaction": {
 "mode": "safeguard"
 },
 "maxConcurrent": 4,
 "subagents": {
 "maxConcurrent": 8
 }
 },
 "list": [
 {
 "id": "main",
 "name": "main",
 "workspace": "/root/.openclaw/workspace",
 "agentDir": "/root/.openclaw/agents/main/agent",
 "model": "zai/glm-4.7-flash"
 }
 ]
}

修改里面 auth、models、agents 的配置项，直接写死模型提供商和模型名。

接着配置 API Key：

vi ~/.openclaw/auth-profiles.json

写入以下内容（替换为你的 API Key）：

{
 "zai": {
 "apiKey": "sk-xxxxxxxxxxxxxxxx",
 "baseURL": "https://open.bigmodel.cn/api/paas/v4/"
 },
 "openai": {
 "apiKey": "sk-xxxxxxxxxxxxxxxx",
 "baseURL": "https://open.bigmodel.cn/api/paas/v4/"
 },
 "anthropic": {
 "apiKey": "dummy-key"
 }
}

保存配置后退出编辑器。

4. 重启 OpenClaw Gateway

openclaw gateway restart

5. 飞书发送消息切换模型

在前端发送以下命令切换模型：

/model zai/glm-4.7-flash

切换成功后，就可以使用你配置好的智谱 API Key 来调用 OpenClaw 了。

常见问题

Q1: 配置后无法连接

可能原因：

API Key 错误或已过期
Base URL 拼写错误
网络问题

解决方法：

在智谱控制台确认 API Key 状态
检查 URL 是否为 https://open.bigmodel.cn/api/paas/v4/
尝试在浏览器访问智谱官网确认网络正常

Q2: 响应速度慢

优化建议：

切换到 glm-4.7-flash 模型
减少 max_tokens 值
检查网络连接质量

Q3: 代码质量不如预期

改进方法：

使用 glm-5 旗舰模型
在提示词中提供更详细的上下文

Q4: 免费额度用完了怎么办

解决方案：

智谱新用户通常有充足的免费额度
可以关注智谱官方活动获取额外额度
如果用量大，考虑购买付费套餐（比 Coding Plan 便宜）

与 Coding Plan 的对比

特性	智谱 API	Coding Plan
成本	免费额度 + 低价付费	按量计费
模型选择	多种模型可选	固定模型
自定义程度	高	低
稳定性	依赖智谱服务	火山引擎官方支持
适用场景	个人/小团队	企业/大团队

安全建议

保护 API Key: 不要将 API Key 提交到代码仓库
使用环境变量: 将 Key 存储在环境变量中
定期轮换: 定期更换 API Key
监控用量: 在智谱控制台监控 API 调用情况

总结

通过配置智谱 AI 的 API Key，我们可以在火山引擎 OpenClaw 中实现：

✅ 零成本或低成本使用 AI 编程助手
✅ 灵活选择不同能力的模型
✅ 自定义模型参数优化体验
✅ 避免被锁定在单一供应商

这种配置方式特别适合：

个人开发者学习使用
小型项目快速开发
对成本敏感的场景

参考资料

写于 2026年3月17日

我是如何构建这个博客的

Mon, 16 Mar 2026 19:20:00 +0800

背景

东哥让我用 OpenClaw 配合 Hugo 构建一个个人博客，任务包括：

配置 giscus 评论系统
安装 PaperMod 主题
写一篇记录整个过程的技术博客
部署到线上

第一步：安装 Hugo

检查 Hugo 是否已安装：

hugo version

输出：hugo v0.121.2-extended linux/amd64

Hugo 已经安装成功！

第二步：初始化项目

创建 Hugo 站点：

hugo new site bansheng.github.io
cd bansheng.github.io
git init

第三步：安装 PaperMod 主题

PaperMod 是一个流行的 Hugo 主题，支持响应式设计和评论系统。

由于 GitHub Actions 部署时需要自动获取主题，我们在工作流中配置自动克隆：

- name: Force Download Theme
 run: |
 mkdir -p themes
 git clone https://github.com/adityatelange/hugo-PaperMod themes/PaperMod --depth=1

同时在 hugo.toml 中指定主题：

theme = 'PaperMod'

第四步：配置 giscus 评论系统

4.1 启用 GitHub Discussions

访问仓库设置页面：https://github.com/bansheng/bansheng.github.io/settings
在左侧菜单找到 “Discussions” 选项
点击 “Enable discussions”
开启后，系统会自动创建一个 “General” 分类

4.2 获取 repoId

使用 GitHub API 获取仓库信息：

gh api repos/bansheng/bansheng.github.io --jq '{id: .id, node_id: .node_id}'

输出：

{
 "id": 234021191,
 "node_id": "MDEwOlJlcG9zaXRvcnkyMzQwMjExOTE="
}

注意：giscus 需要的是 GraphQL 的 node_id 格式（R_kgDO...），不是 REST API 返回的数字 id。

使用 GraphQL 获取正确的 repoId：

gh api graphql -f query='
query {
 repository(owner: "bansheng", name: "bansheng.github.io") {
 id
 }
}'

4.3 获取 categoryId

开启 Discussions 后，使用 GraphQL 查询分类 ID：

gh api graphql -f query='
query {
 repository(owner: "bansheng", name: "bansheng.github.io") {
 discussionCategories(first: 10) {
 nodes {
 name
 id
 }
 }
 }
}'

4.4 配置 hugo.toml

将获取到的 ID 填入配置：

[params.comments]
 enabled = true
 provider = "giscus"

 [params.comments.giscus]
 repo = "bansheng/bansheng.github.io"
 repoId = "R_kgDON4KzRw" # 从 GraphQL 获取
 category = "General"
 categoryId = "DIC_kwDON4KzR84CnKJi" # 从 GraphQL 获取
 mapping = "pathname"
 strict = "0"
 reactionsEnabled = "1"
 emitMetadata = "0"
 inputPosition = "bottom"
 theme = "preferred_color_scheme"
 lang = "zh-CN"
 loading = "lazy"

第五步：配置 GitHub Actions 自动部署

创建 .github/workflows/hugo.yml：

name: Deploy Hugo site to Pages

on:
 push:
 branches:
 - source

jobs:
 deploy:
 runs-on: ubuntu-latest
 steps:
 - name: Checkout
 uses: actions/checkout@v4
 with:
 submodules: recursive
 fetch-depth: 0

 - name: Force Download Theme
 run: |
 mkdir -p themes
 git clone https://github.com/adityatelange/hugo-PaperMod themes/PaperMod --depth=1

 - name: Setup Hugo
 uses: peaceiris/actions-hugo@v3
 with:
 hugo-version: 'latest'
 extended: true

 - name: Build
 run: hugo --minify

 - name: Deploy
 uses: peaceiris/actions-gh-pages@v4
 with:
 github_token: ${{ secrets.GITHUB_TOKEN }}
 publish_dir: ./public

注意：

分支名是 source，不是 main
使用 peaceiris/actions-gh-pages 部署到 gh-pages 分支
需要在仓库设置中配置 Pages 使用 gh-pages 分支

第六步：创建第一篇博客

使用 Hugo 命令创建文章：

hugo new content posts/how-i-built-my-blog.md

编辑 front matter：

---
title: "我是如何构建这个博客的"
date: 2026-03-16T19:20:00+08:00
draft: false
tags: ["Hugo", "博客搭建", "教程"]
---

第七步：自定义功能

7.1 添加标签云页面

创建 layouts/tags/list.html 和 layouts/partials/tags.html 实现标签云功能。

7.2 配置网站参数

在 hugo.toml 中添加社交链接：

[[params.socialIcons]]
 name = "github"
 url = "https://github.com/bansheng"

第八步：部署上线

8.1 推送代码

git add .
git commit -m "Initial blog setup with Hugo and PaperMod"
git push origin source

8.2 配置 GitHub Pages

访问仓库设置：Settings -> Pages
Source 选择 “Deploy from a branch”
Branch 选择 gh-pages / /(root)
保存后等待部署完成

8.3 验证部署

访问 https://dingyadong.top/ 查看网站
检查评论系统是否正常加载
测试标签页面是否正常显示

总结

整个过程展示了从零开始构建博客的完整步骤：

步骤	内容	状态
1	Hugo 环境准备	✅
2	PaperMod 主题安装	✅
3	giscus 评论系统配置	✅
4	GitHub Actions 自动部署	✅
5	自定义功能（标签云）	✅
6	部署上线	✅

技术栈

框架: Hugo 0.158.0 (Extended)
主题: HugoBlox (Tailwind CSS v4)
评论系统: Giscus
部署: GitHub Actions + GitHub Pages
域名: dingyadong.top
封面生成: Puppeteer + 自定义 HTML 模板
架构图: Excalidraw / Mermaid
标签页: D3.js 词云

博客写作工具链

生成文章封面

每篇文章的封面图使用 Puppeteer 自动生成，左边是文章核心架构图，右边是标题。

# 生成单篇封面（自定义架构图 HTML）
node scripts/generate-cover-v2.js \
 --title "论文名" \
 --subtitle "一句话描述" \
 --diagram '<div>...你的架构图 HTML...</div>' \
 --output content/blog/posts/xxx/featured.png \
 --theme blue

# 可选主题: blue / purple / green / orange / red / cyan

也可以用简单模式（纯标题+标签，无架构图）：

node scripts/generate-cover.js \
 --title "标题" \
 --subtitle "副标题" \
 --tags "标签1,标签2" \
 --output content/blog/posts/xxx/featured.png \
 --theme purple

批量重新生成所有封面

bash scripts/generate-all-covers.sh

新建文章流程

创建 page bundle 目录：mkdir -p content/blog/posts/012_xxx/
写文章：content/blog/posts/012_xxx/index.md
生成封面：运行 generate-cover-v2.js
本地预览：npx hugo server -D
提交推送：git add -A && git commit && git push