Skip to main content
OpenClaw 是一个在您自己的设备上运行的个人 AI 助手，可以连接到各种消息平台。它可以通过 GLM Coding Plan 等渠道配置使用智谱的 GLM 模型。

​
安装和配置 OpenClaw

1

获取 API Key

2

安装 OpenClaw

详细的安装指南，请参考 官方文档

前置条件：安装 OpenClaw 最简单的方法是使用官方安装脚本：macOS/Linux：
curl -fsSL https://openclaw.ai/install.sh | bash
Windows (PowerShell)：
iwr -useb https://openclaw.ai/install.ps1 | iex
Description
3

设置 OpenClaw

运行上述安装命令后，配置过程将自动开始。如果没有开始，您可以运行以下命令开始配置：
openclaw onboard --install-daemon
Description开始配置：
  • I understand this is powerful and inherently risky. Continue? | 选择 ● Yes
  • Onboarding mode | 选择 ● Quick Start
  • Model/auth provider | 选择 ● Z.AI
Description
4

配置 Z.AI 提供商

选择 Z.AI 作为 Model/auth provider 后，系统会提示您输入 API Key。
粘贴您的智谱 API Key 并按 Enter 键。
5

完成设置

继续完成剩余的 OpenClaw 功能配置。
  • Select channel | 选择并配置您需要的功能。
  • Configure skills | 选择并安装您需要的功能。
  • 完成设置
6

变更API端点和最新模型

修改 OpenClaw 的配置文件 ~/.openclaw/openclaw.json, 在 models.providers 增加 provider（或更新已有项）
{
  "models": {
    "mode": "merge",
    "providers": {
      "zai": {
        "baseUrl": "https://open.bigmodel.cn/api/coding/paas/v4",
        "auth": "api-key",
        "api": "openai-completions",
        "models": [
          {
            "id": "glm-5",
            "name": "GLM 5 Bigmodel",
            "reasoning": false,
            "input": [
              "text"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 204800,
            "maxTokens": 131072
          }
        ]
      }
    }
  }
}
7

重启网关

变更配置后需要重启 openclaw gateway 生效，执行以下命令
openclaw gateway restart
8

重新选择模型

变更配置后需要执行 openclaw onboard 重新走一遍之前的初始化配置在配置 Z.AI Provider 后，模型选择时就能选择到您上一步所配置的 Bigmodel Coding 端点的 zai/glm-5
9

与机器人交互

命令行执行 openclaw tui 开启与机器人交互现在您可以在 Terminal UI 中开始与您的机器人聊天了。DescriptionOpenClaw 提供了更多渠道供您与机器人交互，如 Web UI、Discord、Slack 等。 您可以通过参考官方文档来设置这些渠道：Channels Setup
  • 对于 Web UI，您可以通过打开终端中显示的 Web UI (with token) 链接来访问。
DescriptionDescription
10

安装后验证

验证一切是否正常工作：
openclaw doctor # 检查配置问题
openclaw status # 查看网关状态
openclaw dashboard # 浏览器打开 Dashboard

详细的配置指南，请参考 官方文档

若配置不当或在没有适当访问控制的情况下部署，OpenClaw 可能会涉及安全风险。参考 官方安全文档

​
高级配置

​
模型故障转移

配置模型故障转移以确保可靠性：.openclaw/openclaw.json 
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "zai/glm-5",
        "fallbacks": ["zai/glm-4.7-flash"]
      }
    }
  }
}

​
使用技能

技能是一个包含 SKILL.md 文件的文件夹。如果您想为 OpenClaw 代理添加新功能，ClawHub 是查找安装技能的最佳方法。

​
安装 clawhub

npm i -g clawhub

​
管理技能

搜索技能 
clawhub search "postgres backups"
下载新技能 
clawhub install my-skill-pack
更新已安装的技能 
clawhub update --all

​
插件管理

插件是一个小的代码模块，通过额外功能（命令、工具和 Gateway RPC）扩展 OpenClaw。
查看已加载的插件： 
openclaw plugins list
安装官方插件（示例：voice-call）： 
openclaw plugins install @openclaw/voice-call
重启网关 
openclaw gateway restart

​
故障排除

​
常见问题

  1. API Key 认证
  • 确保您的 智谱 API key 有效且已订阅 GLM Coding Plan
  • 检查 API key 在环境中是否正确设置
  1. 模型可用性
  • 验证 GLM 模型在您所在的地区是否可用
  • 检查模型名称格式
  1. 连接问题
  • 确保 OpenClaw gateway 正在运行
  • 检查到智谱端点的网络连接

​
资源