Windows 安装 OpenClaw 完整教程 - 含 API 配置与飞书对接

# Windows 安装 OpenClaw 完整教程 - 含 API 配置与飞书对接

OpenClaw 是一个开源的 AI 助手框架，支持多种 AI 模型和聊天平台。本教程从安装 Node.js 开始，手把手教你完成 OpenClaw 的部署、配置和飞书对接。

---

一、准备工作

系统要求

• Windows 10/11（64位）
• 至少 4GB 可用内存
• 稳定的网络连接

需要准备的账号

1. AI 模型 API Key（任选其一） - DeepSeek：https://platform.deepseek.com（推荐，免费额度多） - 百度千帆：https://qianfan.cloud.baidu.com - OpenAI：https://platform.openai.com - Claude：https://console.anthropic.com

2. 飞书账号（可选，用于飞书机器人） - 飞书开放平台：https://open.feishu.cn

---

二、安装 Node.js

Node.js 是 OpenClaw 的运行环境。

下载安装

1. 访问 Node.js 官网 2. 下载 LTS 版本（长期支持版，推荐 20.x） 3. 双击安装包运行

安装步骤

1. 欢迎界面点击「Next」 2. 勾选「I accept the terms...」点击「Next」 3. 选择安装路径，点击「Next」 4. 重要：确保勾选以下选项： - Node.js runtime - npm package manager - Add to PATH（自动添加环境变量） 5. 点击「Install」等待安装完成

验证安装

打开 PowerShell 或 命令提示符，输入：

node -v
npm -v

显示版本号即安装成功。

切换 npm 国内镜像源

npm config set registry https://registry.npmmirror.com

---

三、安装 OpenClaw

打开 PowerShell

• 按 Win + X，选择「Windows PowerShell（管理员）」
• 或搜索「PowerShell」右键以管理员身份运行

全局安装

npm install -g openclaw@latest

验证安装

openclaw --version

显示版本号即安装成功。

---

四、初始化配置

启动配置向导

openclaw onboard

按提示完成配置： 1. 选择 AI 模型提供商 2. 输入 API Key 3. 选择默认模型

或手动配置 API

如果跳过配置向导，可以手动配置：

DeepSeek 配置：

openclaw config set providers.deepseek.apiKey "your-api-key"
openclaw config set agents.defaults.model.primary "deepseek/deepseek-chat"

百度千帆配置：

openclaw config set providers.baiduqianfan.apiKey "your-api-key"
openclaw config set providers.baiduqianfan.secretKey "your-secret-key"
openclaw config set agents.defaults.model.primary "baiduqianfancodingplan/qianfan-code-latest"

OpenAI 配置：

openclaw config set providers.openai.apiKey "sk-xxxxx"
openclaw config set agents.defaults.model.primary "openai/gpt-4o-mini"

Claude 配置：

openclaw config set providers.anthropic.apiKey "sk-ant-xxxxx"
openclaw config set agents.defaults.model.primary "anthropic/claude-3-sonnet"

---

五、启动服务

前台启动（调试用）

openclaw gateway run

后台启动（推荐）

# 启动服务
openclaw gateway start
# 查看状态
openclaw gateway status
# 停止服务
openclaw gateway stop
# 重启服务
openclaw gateway restart

访问 Web Chat

启动后，打开浏览器访问：

http://localhost:18789

即可开始与 AI 对话。

---

六、对接飞书机器人

创建飞书应用

1. 访问 飞书开放平台 2. 点击「开发者后台」→「创建企业自建应用」 3. 填写应用名称和描述 4. 创建后，记录 App ID 和 App Secret

配置应用权限

在飞书应用后台，添加以下权限：

配置 OpenClaw

# 启用飞书通道
openclaw config set channels.feishu.enabled true
# 配置 App ID 和 Secret
openclaw config set channels.feishu.appId "cli_xxxxx"
openclaw config set channels.feishu.appSecret "your-app-secret"
# 使用长连接模式（无需公网 IP）
openclaw config set channels.feishu.connectionMode "websocket"

重启服务

openclaw gateway restart

发布应用

1. 在飞书应用后台，点击「版本管理」→「发布版本」 2. 提交审核，等待通过 3. 审核通过后，在飞书中搜索你的机器人即可开始对话

---

七、安装推荐技能

OpenClaw 支持技能扩展，以下是推荐的实用技能：

内置技能

飞书扩展技能

使用技能

查询北京天气
检查系统安全
帮我创建一个技能

---

八、常用命令汇总

# 启动服务（后台）
openclaw gateway start
# 停止服务
openclaw gateway stop
# 重启服务
openclaw gateway restart
# 查看状态
openclaw gateway status
# 查看详细状态
openclaw status --deep
# 查看日志
openclaw logs --follow
# 诊断问题
openclaw doctor
# 卸载服务（取消自启）
openclaw gateway uninstall
# 更新版本
npm update -g openclaw

---

九、常见问题

1. 端口被占用

# 查看端口占用
netstat -ano | findstr :18789
# 结束占用进程
taskkill /PID <进程ID> /F
# 重启服务
openclaw gateway restart

2. 命令找不到

检查环境变量是否正确配置：

# 查看 Node.js 路径
where node
# 查看 npm 全局安装路径
npm config get prefix

将 npm 全局路径添加到系统环境变量 PATH 中。

3. API 调用失败

检查 API Key 是否正确：

openclaw config get providers.deepseek.apiKey

4. 飞书机器人不响应

# 检查通道状态
openclaw status --deep
# 查看错误日志
openclaw logs --follow

5. 配置文件位置

# Windows 配置文件位置
%USERPROFILE%\.openclaw\openclaw.json

---

十、开机自启动设置

方式一：使用 OpenClaw 内置服务

# 安装为系统服务
openclaw gateway install
# 启动服务
openclaw gateway start

方式二：添加到启动项

1. 按 Win + R，输入 shell:startup 2. 创建快捷方式，指向：

   C:\Users\你的用户名\AppData\Roaming\npm\openclaw.cmd gateway start
   

---

十一、进阶配置

设置多个模型

# 添加备用模型
openclaw config set agents.defaults.model.fallback "deepseek/deepseek-coder"

配置定时任务

# 每天早上 8 点提醒
openclaw cron add --name "morning" --schedule "0 8 * * *" --message "早安！今天有什么计划？"

开启隐私模式

# 启用工作区限制
openclaw config set tools.fs.workspaceOnly true

---

十二、卸载 OpenClaw

卸载程序

npm uninstall -g openclaw

删除配置文件

Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"

---

十三、获取帮助

• 官方文档：https://docs.openclaw.ai
• GitHub：https://github.com/openclaw/openclaw
• 社区：https://discord.com/invite/clawd
• 插件市场：https://clawhub.com

OpenClaw 让你轻松拥有自己的 AI 助手，开始你的智能化之旅吧！

作者：廖万里

发布时间：2026年3月16日

本文链接：https://www.kkkliao.cn/?id=696 转载需授权！