OpenClaw Windows 部署教程 - 10 分钟打造你的 AI 助手

需要准备的账号

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

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

---

二、安装 Node.js

下载安装

1. 访问 Node.js 官网：https://nodejs.org 2. 下载 LTS 版本（推荐 20.x） 3. 运行安装程序，一路下一步

验证安装

打开 PowerShell，输入：

node -v
npm -v

显示版本号即安装成功。

---

三、安装 OpenClaw

使用 npm 安装

# 全局安装 OpenClaw
npm install -g openclaw
# 验证安装
openclaw --version

初始化配置

# 进入配置向导
openclaw configure

按提示选择：

• 选择 AI 模型提供商（如 DeepSeek）
• 输入 API Key
• 选择默认模型

四、配置 AI 模型

DeepSeek 配置

# 设置 API Key
openclaw config set providers.deepseek.apiKey "your-api-key"
# 设置默认模型
openclaw config set agents.defaults.model.primary "deepseek/deepseek-chat"

百度千帆配置

# 设置 API Key 和 Secret Key
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"

---

五、启动服务

启动 Gateway

# 启动核心服务
openclaw gateway start
# 查看状态
openclaw status

访问 Web Chat

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

http://localhost:18789

即可开始与 AI 对话。

---

六、接入飞书机器人

创建飞书应用

1. 访问 飞书开放平台 2. 创建企业自建应用 3. 获取 App ID 和 App Secret

配置权限

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

• im:message - 获取与发送消息
• im:message.p2p_msg - 接收单聊消息
• im:message.group_msg - 接收群聊消息

配置 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

现在在飞书中搜索你的机器人，即可开始对话。

---

七、常用命令

# 查看状态
openclaw status
# 查看详细状态
openclaw status --deep
# 查看日志
openclaw logs --follow
# 重启服务
openclaw gateway restart
# 停止服务
openclaw gateway stop
# 检查问题
openclaw doctor

---

八、常见问题

1. 端口被占用

# 查看端口占用
netstat -ano | findstr :18789
# 结束占用进程
taskkill /PID <进程ID> /F

2. API 调用失败

检查 API Key 是否正确：

openclaw config get providers.deepseek.apiKey

3. 飞书机器人不响应

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

4. 配置文件位置

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

---

九、进阶配置

设置多个模型

# 添加备用模型
openclaw config set agents.defaults.model.fallback "deepseek/deepseek-coder"
# 设置模型别名
openclaw config set models.claude.provider "anthropic"
openclaw config set models.claude.name "claude-3-sonnet"

配置定时任务

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

开启隐私模式

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

---

十、安全建议

1. 保护 API Key

# 设置飞书群组策略为白名单模式
openclaw config set channels.feishu.groupPolicy "allowlist"

# 查看操作日志
openclaw logs --follow

npm uninstall -g openclaw

# 删除配置文件
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"