OpenClaw Windows 安装教程

本文档详细介绍如何在 Windows 系统上安装和配置 OpenClaw。

---

1. 事前准备

在开始安装之前，你需要准备以下内容：

1.1 大模型 API

OpenClaw 需要连接大模型才能工作，请提前准备好以下其中一种：

提供商	说明
MiniMax	推荐，国内访问快，API 地址: https://api.minimax.chat
硅基流动	国内可访问，支持多种模型
阿里云 DashScope	国内可访问
OpenAI	需要代理访问
Claude (Anthropic)	需要代理访问

1.2 Node.js 环境

• 操作系统: Windows 10/11 (64-bit)
• Node.js: v18 或更高版本
• npm: v9 或更高版本

安装 Node.js

1. 访问 Node.js 官网 下载 LTS 版本
2. 运行 .msi 安装包，勾选 “Add to PATH”
3. 验证安装：

node --version
npm --version

---

2. 安装 OpenClaw

# 全局安装
npm install -g openclaw

# 验证安装
openclaw --version

---

3. 首次配置

3.1 交互式配置向导（推荐）

openclaw configure

向导会一步步提示配置：

1. 大模型 API（选择提供商并输入 API Key）
2. Gateway 端口和认证 Token
3. 渠道登录（飞书）
4. 技能启用

3.2 手动初始化

openclaw init

配置文件结构：

%USERPROFILE%\.openclaw\
├── config.yaml          # 主配置文件
├── skills/              # 技能文件夹
└── memory/              # 记忆存储

---

4. Gateway 管理

# 启动 Gateway（前台运行）
openclaw gateway start

# 后台运行
openclaw gateway start -d

# 查看状态
openclaw gateway status

# 停止
openclaw gateway stop

# 重启
openclaw gateway restart

# 查看日志
openclaw gateway logs

---

5. 快速上手命令

5.1 openclaw tui — 终端对话

直接与 AI Agent 对话：

# 基本用法
openclaw tui

# 远程连接
openclaw tui --url ws://192.168.1.100:8080 --token your-token

# 发送消息后退出
openclaw tui --message "你好"

# 让 AI 回复消息（推送到渠道）
openclaw tui --deliver

常用选项：

选项	说明
--url	Gateway WebSocket 地址
--token	Gateway 认证 Token
--deliver	让 AI 回复消息
--session	会话键（默认 main）
--thinking	思考级别：off/low/high

5.2 openclaw dashboard — 控制面板

# 打开浏览器控制面板
openclaw dashboard

# 只打印 URL，不打开浏览器
openclaw dashboard --no-open

控制面板功能：查看 Gateway 状态、管理渠道连接、查看会话历史、配置技能插件

---

6. 飞书渠道配置

在 config.yaml 中添加：

channels:
  feishu:
    enabled: true
    app_id: "cli_xxxxxxxxxxxxxx"
    app_secret: "your_app_secret"
    verification_token: "your_verification_token"
    encryption_key: "your_encryption_key"

获取飞书配置：

1. 访问 飞书开放平台
2. 创建企业自建应用
3. 获取 App ID 和 App Secret
4. 配置应用权限（接收消息、发送消息、获取用户信息）
5. 创建事件订阅

---

7. 完整配置示例

# OpenClaw 主配置
openclaw:
  name: "My OpenClaw"
  model: "minimax-cn/MiniMax-M2.5"
  thinking: "low"

# Gateway 配置
gateway:
  host: "0.0.0.0"
  port: 8080
  auth:
    enabled: true
    token: "your-secure-token"

# 渠道配置
channels:
  feishu:
    enabled: true
    app_id: "cli_xxxxxxxxxxxxxx"
    app_secret: "your_feishu_app_secret"

# 技能配置
skills:
  enabled:
    - weather
    - feishu-doc
    - obsidian

---

8. 常见问题

npm 安装失败

• 权限错误：以管理员身份运行 PowerShell
• 网络超时：使用国内镜像

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

Gateway 启动失败

• 检查端口 8080 是否被占用
• 确认 config.yaml 格式正确
• 查看日志：openclaw gateway logs

渠道连接失败

• 确认 App ID / Token 正确
• 检查网络能否访问对应平台

---

9. 下一步

• 运行 openclaw skills 查看可用技能
• 配置更多渠道（ Telegram、Discord 等）
• 阅读 AGENTS.md 了解高级配置

---

10. 常用技能推荐

以下是推荐安装的常用技能：

飞书生态

技能	说明
feishu-doc	读取飞书文档、Wiki、Bitable 数据
feishu-drive	飞书云盘文件管理
feishu-perm	飞书文档权限管理
feishu-wiki	飞书知识库创建和管理

效率工具

技能	说明
obsidian	管理 Obsidian 笔记库
weather	查询天气和预报
coding-agent	委托代码任务（Codex/Claude Code）
healthcheck	安全审计和主机加固

进阶技能

技能	说明
aster	手机控制（短信、电话、TTS）
self-evolve-agent	Agent 自主进化引擎
mcp-builder	MCP 服务器开发指南
capability-evolver	能力持续进化

安装技能

告诉openclaw 你要安装哪个技能就行。

如果实在搞不定安装openclaw可以下载一个 TRAE 让它帮你搞定

更新时间: 2026-03-06