|OpenClaw
访问官网

OpenClaw

开源

开源AI助手平台，支持飞书集成，一键部署私人AI助理

BLUF 摘要（点开查看）

这篇教程说明如何配置 OpenClaw，重点是先准备 API Key、Base URL 和模型名称，再按章节完成安装、配置、验证与排错。

配置前检查

  • 确认工具读取的是哪个配置文件，避免改错项目目录或用户目录
  • 准备 API Key、Base URL、模型名称和计费平台登录方式
  • 先用测试模型跑通一次简单对话，再切换到更贵或更强的模型
  • 把 API Key 放在环境变量或工具密钥管理里，不要写进公开仓库

常见排错

  • 401/403：优先检查 API Key 是否复制完整、是否过期、是否有调用权限
  • 404/模型不存在：检查模型名、Base URL、供应商兼容接口路径是否匹配
  • 429：降低并发，开启重试退避，或升级额度与限速套餐
  • 超时：先切换更快模型或国内直连 API，再缩短输入上下文测试
目录（7 章）
1. OpenClaw 简介2. 前置准备3. 配置环境变量4. 安装 OpenClaw5. Onboard 配置步骤6. 验证与连接7. 完整安装命令速查
1

OpenClaw 简介

OpenClaw 是一个开源的 AI 助手平台，支持多种 AI 模型，可集成飞书等通讯工具，打造私人 AI 助理。

什么是 OpenClaw

OpenClaw 让你在本地部署 AI 助手，通过飞书等平台与 AI 对话，数据安全可控。

  • 支持 Anthropic Claude、OpenAI GPT、GLM 等多种模型
  • 支持飞书集成，随时随地与 AI 对话
  • 开源免费，数据完全本地化
  • 支持技能插件扩展功能

核心要点

OpenClaw 需要本地运行 Gateway 服务

默认监听地址：127.0.0.1:18789

支持多种 AI 模型切换，按需选择

2

前置准备

安装 OpenClaw 前，需要确保系统已安装必要的环境。

安装 Node.js（>=22）

OpenClaw 需要 Node.js 22 或更高版本

  • 访问 Node.js 官网下载 LTS 版本：nodejs.org
  • 安装完成后在命令行验证：node -v
  • 确保 NPM 也已安装：npm -v
⚠ Node.js 版本必须 >= 22，旧版本无法运行 OpenClaw

安装 Git Bash

Windows 用户需要安装 Git Bash 来运行 OpenClaw

核心要点

推荐使用 Git Bash 而非 CMD 运行 OpenClaw

国内用户建议先设置 NPM 镜像加速下载

注意事项

确保 Node.js 版本 >= 22，否则安装后无法正常运行

3

配置环境变量

在安装 OpenClaw 前，先配置环境变量，指定工作目录，避免占用 C 盘空间。

创建工作区目录

在 D 盘创建 OpenClaw 工作区

bash
mkdir D:\software\openclaw\workspace

设置系统环境变量

通过 Win+R 输入 sysdm.cpl 打开系统属性，添加以下环境变量

  • OPENCLAW_HOME = D:\software\openclaw
  • OPENCLAW_WORKSPACE = D:\software\openclaw\workspace
  • OPENCLAW_CONFIG_PATH = D:\software\openclaw\openclaw.json
  • OPENCLAW_STATE_DIR = D:\software\openclaw

验证环境变量

在 Git Bash 中验证环境变量是否生效

bash
echo $OPENCLAW_HOME
echo $OPENCLAW_WORKSPACE
echo $OPENCLAW_CONFIG_PATH
echo $OPENCLAW_STATE_DIR
  • 如果输出为空，说明环境变量未生效，需重启终端
  • Windows CMD 中使用 echo %OPENCLAW_HOME% 验证

核心要点

建议将工作区放在 D 盘，避免占用 C 盘空间

环境变量设置后需要重启终端才能生效

注意事项

环境变量必须配置正确，否则 OpenClaw 无法找到工作区

4

安装 OpenClaw

使用 NPM 全局安装 OpenClaw，并运行配置向导。

安装 OpenClaw

在 Git Bash 或 PowerShell 中执行安装命令

bash
npm install -g openclaw
 
# 或使用最新版
npm install -g openclaw@latest
 
# 或使用 pnpm
pnpm add -g openclaw@latest
  • npm：Node.js 默认包管理器
  • -g：全局安装，安装后可在命令行直接使用
  • 安装过程可能需要 30 秒左右

运行配置向导

执行 onboard 命令启动配置向导

bash
openclaw onboard --workspace D:\software\openclaw\workspace --install-daemon
  • --workspace：指定工作区路径
  • --install-daemon：安装后台守护进程服务，开机自启
  • 不指定工作区则默认在 C 盘：~/.openclaw/workspace

核心要点

建议使用 --install-daemon 参数，让服务开机自启

安装失败时可尝试以管理员身份运行终端

5

Onboard 配置步骤

运行 onboard 命令后，需要完成以下交互式配置步骤。

步骤 1：确认使用协议

选择 Yes 继续

  • 提示 "I understand this is personal-by-default..." 选择 Yes

步骤 2：选择 QuickStart

选择 QuickStart 快速开始模式

步骤 3：选择 AI 模型

选择你要使用的 AI 模型提供商

  • Anthropic Claude：官方模型，效果最好但较贵
  • OpenAI GPT：通用性强
  • GLM（智谱）：国内首选，性价比高
  • 其他：Moonshot、MiniMax、Google、xAI 等
⚠ 推荐国内用户选择 GLM (Z.AI)，访问稳定且性价比高

步骤 4：输入 API Key

根据选择的模型输入对应的 API Key

  • 如果选择 GLM Coding Plan：
  • 访问智谱AI Coding Plan 注册获取 API Key：bigmodel.cn/glm-coding
  • 选择 Coding-Plan-CN（国内）或 Coding-Plan-Global（国际）
  • 粘贴 API Key 完成认证

步骤 5：配置飞书集成

输入飞书 App ID 和 App Secret

  • 在飞书开放平台创建应用获取 App ID 和 Secret
  • 输入后完成飞书集成

步骤 6-8：可选配置（可跳过）

Web 搜索、技能安装、API 配置均可跳过

  • Web 搜索：选择 Skip for now 跳过
  • 技能安装：选择 Skip for now 跳过（后续可单独安装）
  • API 配置：全部选择 No 跳过
⚠ 初次安装建议全部跳过，先让基础功能跑起来

步骤 9：Hooks 配置

选择 Skip for now 跳过钩子配置

步骤 10：重启 Gateway 服务

选择 Restart 重启服务让配置生效

  • 选择 Restart（默认选项）
  • 按 Enter 确认重启

核心要点

所有可选配置均可后续通过 openclaw configure 重新设置

技能插件可通过 openclaw skills install <名称> 单独安装

6

验证与连接

安装配置完成后，验证服务是否正常运行。

验证安装版本

检查 OpenClaw 是否安装成功

bash
openclaw --version

访问 Gateway 仪表盘

打开浏览器访问本地 Gateway 服务

  • 默认地址：127.0.0.1:18789
  • 需要在 openclaw.json 中查看 Gateway token
  • 输入 token 完成认证后即可使用

飞书配对

将飞书机器人与 OpenClaw 配对连接

bash
# 在飞书中与机器人对话获取配对码
# 然后在命令行中批准配对
openclaw pairing approve feishu <配对码>
  • 在飞书中找到你的 OpenClaw 机器人
  • 发送任意消息获取配对码
  • 在命令行执行配对批准命令
  • 配对成功后即可在飞书中与 AI 对话

核心要点

Gateway 服务开机自启，无需手动启动

飞书配对只需一次，后续直接对话即可

注意事项

如果无法访问仪表盘，检查 18789 端口是否被占用

Token 在 openclaw.json 中，务必妥善保管

7

完整安装命令速查

以下是从零开始的完整安装步骤命令汇总。

一键安装命令

按顺序执行以下命令完成安装

bash
# 1. 创建工作区
mkdir D:\software\openclaw\workspace
 
# 2. 配置环境变量（在系统属性中设置）
# OPENCLAW_HOME = D:\software\openclaw
# OPENCLAW_WORKSPACE = D:\software\openclaw\workspace
# OPENCLAW_CONFIG_PATH = D:\software\openclaw\openclaw.json
# OPENCLAW_STATE_DIR = D:\software\openclaw
 
# 3. 安装 OpenClaw
npm install -g openclaw
 
# 4. 运行配置向导
openclaw onboard --workspace D:\software\openclaw\workspace --install-daemon
 
# 5. 验证安装
openclaw --version
 
# 6. 飞书配对
openclaw pairing approve feishu <配对码>

核心要点

安装前确保 Node.js >= 22 且 Git Bash 已安装

环境变量设置后需重启终端

国内用户建议先设置 NPM 镜像

其他应用教程

CC Switch

推荐

跨平台 AI 终端配置管理工具，统一管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 的 API 供应商、模型、MCP 和 Skills。

OpenAI Codex

官方

OpenAI 官方 AI 编程助手安装与使用教程，覆盖 CLI、IDE 扩展、云端任务、AGENTS.md、权限审批、安全规范和真实项目工作流。

Claude Code

热门

Claude Code 安装、区域限制处理、CC Switch 配置与 DeepSeek 模型接入完整教程

OpenClaw 接入飞书

飞书

基于飞书开放平台创建机器人，并通过 OpenClaw Feishu 插件把本地 AI 助手接入飞书对话

Claudian Obsidian 插件

插件

在Obsidian中直接使用Claude AI助手，结合笔记与AI提升效率

Hermes Agent

Agent

Nous Research 开源 AI Agent 安装与初始化教程，覆盖一键安装、模型配置、健康检查和常见问题排查

LLM Wiki 知识编译器

知识管理

将零散信息编译成结构化知识网络的AI驱动知识管理系统，基于Obsidian和Claude构建