大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



OpenClaw 是一个功能强大的 AI 助手网关平台，支持通过飞书、Telegram、Discord、WhatsApp 等多种聊天渠道与 AI 模型交互。它可以作为你的个人 AI 助手，运行在你自己的服务器或电脑上，提供文件操作、代码编写、日程管理、消息收发等丰富能力。

在 Windows 上安装 OpenClaw，官方推荐使用 WSL2（Windows Subsystem for Linux 2）。WSL2 提供了完整的 Linux 运行环境，能够保证 OpenClaw 及其各种技能（Skills）的**兼容性。虽然也可以在原生 Windows（PowerShell）上直接安装，但可能会遇到更多工具兼容性问题。

本指南将详细介绍两种安装方式，并涵盖通道配置、模型设置、故障排查等完整内容。

• Windows Terminal — 微软官方终端，支持多标签和 WSL 集成，体验远优于传统 CMD
• Git for Windows — 版本控制工具，OpenClaw 的安装器脚本需要 Git
• Visual Studio Code — 配合 WSL 远程开发插件，方便编辑配置文件

💡 关于 Node.js 版本
OpenClaw 要求 Node.js 22+，这是硬性要求。如果你的系统已安装了旧版本的 Node.js，请务必先升级。建议使用 NodeSource 或 nvm 来管理 Node.js 版本。

这是 OpenClaw 官方推荐的方式。WSL2 在 Windows 内提供了一个完整的 Linux 环境，CLI 和 Gateway 网关在 Linux 内运行，保持了运行时的一致性，使得 Node/Bun/pnpm、Linux 二进制文件、Skills 等工具的兼容性大大提高。

打开 PowerShell（管理员），执行以下命令：

# 一键安装 WSL2 + 默认的 Ubuntu 发行版 wsl --install # 或者，显式指定 Ubuntu 24.04 wsl --list --online # 查看可用的发行版列表 wsl --install -d Ubuntu-24.04 

如果 Windows 提示需要重启，请保存工作后重启电脑。

重启后，Ubuntu 会自动弹出窗口，要求你设置用户名和密码。请记住这些信息，后续操作可能会用到。

⚠️ 已有 WSL2？
如果你已经安装了 WSL2，可以用 wsl --list --verbose 查看当前状态。确保你的发行版状态为 Running 或 Stopped（而不是 Unregistered）。如果没有安装 Ubuntu，用 wsl --install -d Ubuntu-24.04 安装。

systemd 是 Linux 的服务管理器，OpenClaw 的 Gateway 服务需要它来实现后台守护进程模式。默认情况下，WSL2 可能未启用 systemd。

在你的 WSL 终端中执行：

GPT plus 代充 只需 145# 写入 systemd 配置 sudo tee /etc/wsl.conf >/dev/null <<'EOF' [boot] systemd=true EOF 

然后，回到 PowerShell 中关闭 WSL：

wsl --shutdown 

重新打开 Ubuntu 终端，验证 systemd 是否启用：

GPT plus 代充 只需 145systemctl --user status # 如果能看到 systemd 的状态输出（而不是报错），说明已成功启用 

现在进入 WSL 终端，有三种安装方式可选：

方式 A：一键安装器（推荐）

这是最简单的方式。安装器会自动检测系统环境，确保 Node.js 22+，并选择合适的安装方式：

# 运行官方安装器脚本 curl -fsSL https://openclaw.ai/install.sh | bash 

安装器会自动完成以下工作：

1. 检测操作系统（macOS / Linux / WSL）
2. 确保 Node.js 22+（如未安装，通过 NodeSource 自动安装）
3. 确保 Git 已安装
4. 选择安装方式（默认使用 npm 全局安装）
5. 处理 npm 全局路径权限问题（自动切换到 ~/.npm-global）
6. 运行 openclaw doctor –non-interactive 进行健康检查

如果想查看安装器的所有选项：

GPT plus 代充 只需 145curl -fsSL https://openclaw.ai/install.sh | bash -s – –help 

方式 B：npm 全局安装

如果你已经手动安装好了 Node.js 22+，可以直接用 npm 安装：

# 安装最新版本 npm install -g openclaw@latest

验证安装

openclaw –version

也可以使用 pnpm：

GPT plus 代充 只需 145pnpm add -g openclaw@latest 

⚠️ 注意
安装命令是 openclaw@latest，不是 openclaw，也不是 @openclaw/cli。使用 @latest 确保你安装的是最新版本。

方式 C：源码编译安装（开发者推荐）

如果你想参与 OpenClaw 开发或需要最新功能，可以从源码编译：

# 克隆仓库 git clone https://github.com/openclaw/openclaw.git cd openclaw

安装依赖

pnpm install

构建 UI 资源（首次运行时自动安装 UI 依赖）

pnpm ui:build

构建项目

pnpm build

运行新手引导

openclaw onboard

源码安装方式下，如果未全局安装 CLI，可以通过 pnpm openclaw … 来运行命令。

安装完成后，运行新手引导向导来完成初始配置：

GPT plus 代充 只需 145# 运行引导向导（同时安装后台服务） openclaw onboard --install-daemon 

向导会引导你完成以下配置：

1. Gateway 设置 — 本地还是远程 Gateway
2. 模型/认证 — 选择 AI 提供商（OpenAI、Anthropic 等），配置 API Key
3. 通道配置 — 配置飞书、Telegram、Discord 等聊天通道
4. 配对设置 — 安全私聊默认值
5. 工作区引导 — 自动创建 AGENTS.md、SOUL.md 等工作区文件
6. Skills 安装 — 可选安装一些常用技能
7. 后台服务 — 安装 Gateway 守护进程（systemd 用户服务）

💡 快速聊天
如果你暂时不想配置通道，只想在浏览器中体验 OpenClaw，可以运行 openclaw dashboard，然后在浏览器中打开 http://127.0.0.1:18789/ 进行聊天。

如果你在新手引导中没有选择安装服务，后续可以手动安装：

# 方式一：通过 onboard 命令 openclaw onboard --install-daemon # 方式二：直接安装 Gateway 服务 openclaw gateway install # 方式三：通过 configure 命令，选择 Gateway service openclaw configure 

在 WSL2 中，Gateway 服务使用 systemd 用户服务管理，服务名称为 openclaw-gateway.service。安装后，Gateway 会在用户登录时自动启动，并在登出后继续运行（通过 systemd lingering）。

验证服务状态：

GPT plus 代充 只需 145# 查看 OpenClaw 状态 openclaw gateway status # 或直接检查 systemd 服务 systemctl --user status openclaw-gateway.service 

如果你不想使用 WSL2，也可以直接在 Windows PowerShell 中安装 OpenClaw。但请注意，原生 Windows 支持未经充分测试，可能会遇到更多兼容性问题。

OpenClaw 提供了 Windows PowerShell 版本的安装器，打开 PowerShell 执行：

# 运行 Windows 安装器（默认使用 npm 安装） iwr -useb https://openclaw.ai/install.ps1 | iex # 如果想从源码安装 iwr -useb https://openclaw.ai/install.ps1 | iex -InstallMethod git # 指定源码安装目录 iwr -useb https://openclaw.ai/install.ps1 | iex -InstallMethod git -GitDir "C:openclaw" 

安装器会自动完成以下工作：

1. 确保 Node.js 22+（通过 winget / Chocolatey / Scoop 安装）
2. 选择安装方式（npm 全局安装或 git 源码安装）
3. 运行 openclaw doctor --non-interactive 进行健康检查

查看安装器帮助：

GPT plus 代充 只需 145& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -? 

如果你已经手动安装好了 Node.js 22+：

# 安装最新版本 npm install -g openclaw@latest # 验证安装 openclaw --version # 运行新手引导 openclaw onboard 

如果安装时遇到"无法加载脚本，因为此系统禁止执行脚本"的错误，需要调整执行策略：

GPT plus 代充 只需 145# 查看当前执行策略 Get-ExecutionPolicy # 临时允许（仅当前会话） Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process # 永久修改（需要管理员权限，推荐） Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser 

• npm error spawn git / ENOENT — 需要先安装 Git for Windows，然后重新打开 PowerShell 再运行安装器
• "openclaw" 不是可识别的命令 — npm 全局 bin 目录不在 PATH 中。运行 npm config get prefix 查看全局路径，将其下的 bin 目录添加到系统 PATH，然后重新打开终端

Gateway 是 OpenClaw 的核心网关服务，负责管理所有通道连接和 AI 交互。

# 查看 Gateway 运行状态 openclaw gateway status # 启动 Gateway（前台运行，适合调试） openclaw gateway --port 18789 --verbose # 启动 Gateway（守护进程模式） openclaw gateway start # 停止 Gateway openclaw gateway stop # 重启 Gateway openclaw gateway restart # 安装 Gateway 服务（systemd/launchd） openclaw gateway install # 查看实时日志 openclaw logs --follow # 查看最近 50 行日志 openclaw logs --tail 50 

在 WSL2 中，Gateway 服务通过 systemd 用户服务管理：

GPT plus 代充 只需 145# 查看服务状态 systemctl --user status openclaw-gateway.service # 手动启动/停止/重启 systemctl --user start openclaw-gateway.service systemctl --user stop openclaw-gateway.service systemctl --user restart openclaw-gateway.service # 查看服务日志 journalctl --user -u openclaw-gateway.service -f # 启用开机自启 systemctl --user enable openclaw-gateway.service 

# 综合状态检查（推荐） openclaw status --all # 深度健康检查 openclaw health # 运行诊断工具 openclaw doctor # 安全审计 openclaw security audit --deep 

其中 openclaw status --all 是**的只读调试报告，可以一键查看所有关键信息。

OpenClaw 支持多种聊天通道。配置文件位于 ~/.openclaw/openclaw.json（WSL2 中是 Linux 路径，原生 Windows 中是 C:Users <用户名> .openclawopenclaw.json ）。

你也可以使用交互式命令添加通道：

GPT plus 代充 只需 145openclaw channels add # 然后根据提示选择通道类型（Feishu / Telegram / Discord 等） 

飞书是 OpenClaw 内置支持的生产级通道，支持机器人私聊和群组，使用 WebSocket 长连接模式接收消息，无需公网 URL。

第一步：创建飞书应用

1. 访问 飞书开放平台，登录飞书账号
2. 点击 「创建企业自建应用」，填写应用名称和描述
3. 在 「凭证与基础信息」 页面，复制 App ID（格式如 cli_xxx）和 App Secret

第二步：配置应用权限

在 「权限管理」 页面，点击 「批量导入」，粘贴以下 JSON 配置：

{ “scopes”: {

GPT plus 代充 只需 145"tenant": [ "aily:file:read", "aily:file:write", "application:application.app_message_stats.overview:readonly", "application:application:self_manage", "application:bot.menu:write", "cardkit:card:write", "contact:user.employee_id:readonly", "corehr:file:download", "docs:document.content:read", "event:ip_list", "im:chat", "im:chat.access_event.bot_p2p_chat:read", "im:chat.members:bot_access", "im:message", "im:message.group_at_msg:readonly", "im:message.group_msg", "im:message.p2p_msg:readonly", "im:message:readonly", "im:message:send_as_bot", "im:resource", "sheets:spreadsheet", "wiki:wiki:readonly" ], "user": [ "aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read" ] 

} }

第三步：启用机器人能力

在 「应用能力」 > 「机器人」 页面，开启机器人能力并配置机器人名称。

第四步：配置事件订阅

⚠️ 重要
配置事件订阅前，请确保已完成以下步骤：

1. 运行 openclaw channels add 添加了飞书通道
   
2. Gateway 处于启动状态（openclaw gateway status）

在 「事件订阅」 页面：

1. 选择 「使用长连接接收事件」（WebSocket 模式）
2. 添加事件：im.message.receive_v1（接收消息事件）

第五步：发布应用

在 「版本管理与发布」 页面创建版本并提交审核。企业自建应用通常自动通过审批。

第六步：配置 OpenClaw

运行交互式配置命令：

openclaw channels add

选择 Feishu，然后输入 App ID 和 App Secret

或者手动编辑 ~/.openclaw/openclaw.json：

GPT plus 代充 只需 145{ “channels”: {

"feishu": { "enabled": true, "dmPolicy": "pairing", "accounts": { "main": { "appId": "cli_xxx", "appSecret": "你的密钥", "botName": "我的AI助手" } } } 

} }

第七步：配对授权

默认情况下，陌生人给机器人发消息会收到一个配对码。你需要批准此代码：

GPT plus 代充 只需 145# 查看待审批列表 openclaw pairing list feishu

批准配对

openclaw pairing approve feishu <配对码>

批准后，该用户即可正常与机器人对话。

飞书群聊技巧

• 默认情况下，群聊中需要 @机器人 才会响应
• 可以通过 channels.feishu.groups. .requireMention 配置是否需要 @提及
• 群组 ID 格式为 oc_xxx，可以通过 openclaw logs –follow 查看日志获取
• 飞书支持流式卡片输出（默认启用），机器人会实时更新卡片内容显示生成进度

1. 在 Telegram 中找 @BotFather，创建一个新 Bot 并获取 Bot Token
2. 配置 OpenClaw：

openclaw channels add # 选择 Telegram，粘贴 Bot Token 

或者手动配置：

GPT plus 代充 只需 145{ "channels": { "telegram": { "accounts": { "default": { "botToken": ":ABC-DEF1234ghIkl-zyx57W2v1u123ew11" } } } } } 

⚠️ Telegram 私信提示
你的第一条私信会返回一个配对码，需要通过 openclaw pairing approve telegram 批准，否则 Bot 不会响应。

1. 在 Discord Developer Portal 创建一个 Application
2. 在 Bot 页面创建 Bot 并复制 Token
3. 配置 OpenClaw：

openclaw channels add # 选择 Discord，粘贴 Bot Token 

OpenClaw 支持多种 AI 模型提供商。你可以在新手引导中配置，也可以后续通过配置文件或命令行设置。

GPT plus 代充 只需 145{ "models": { "default": { "provider": "openai", "model": "gpt-4" }, "openai": { "auth": { "type": "api_key", "apiKey": "sk-xxx" } } } } 

也可以使用 OpenAI Code (Codex) 订阅的 OAuth 认证方式，新手引导中会提供选项。

对于 Anthropic，推荐使用 API 密钥方式：

{ "models": { "default": { "provider": "anthropic", "model": "claude-sonnet-4-" }, "anthropic": { "auth": { "type": "api_key", "apiKey": "sk-ant-xxx" } } } } 

也支持 claude setup-token 复用 Claude Code 凭证。

GPT plus 代充 只需 145{ "models": { "default": { "provider": "zhipu", "model": "glm-4" }, "zhipu": { "auth": { "type": "api_key", "apiKey": "xxx.xxx" } } } } 

如果你想使用本地运行的 AI 模型（完全免费，无需 API Key），可以安装 Ollama：

# 在 WSL2 中安装 Ollama curl -fsSL https://ollama.com/install.sh | sh # 启动 Ollama 服务 ollama serve & # 下载模型（例如 llama3） ollama pull llama3 

配置 OpenClaw 使用 Ollama：

GPT plus 代充 只需 145{ "models": { "default": { "provider": "ollama", "model": "llama3" }, "ollama": { "enabled": true, "baseURL": "http://localhost:11434" } } } 

可以配置多个模型提供商，实现自动故障转移。当首选模型不可用时，自动切换到备用模型：

{ "models": { "default": { "provider": "openai", "model": "gpt-4" }, "failover": [ { "provider": "openai", "model": "gpt-4" }, { "provider": "anthropic", "model": "claude-sonnet-4-" }, { "provider": "zhipu", "model": "glm-4" } ] } } 

OpenClaw 从工作区目录读取操作指令和"记忆"。默认工作区位于 ~/.openclaw/workspace。

GPT plus 代充 只需 145~/.openclaw/workspace/ ├── AGENTS.md # 工作区指令（Agent 行为规范） ├── SOUL.md # Agent 人格定义 ├── TOOLS.md # 工具配置和快捷参考 ├── IDENTITY.md # Agent 身份信息 ├── USER.md # 用户信息 ├── MEMORY.md # 长期记忆 ├── BOOTSTRAP.md # 首次运行引导（初始化后可删除） └── memory/ # 记忆目录 ├── working-buffer.md └── YYYY-MM-DD.md 

新手引导完成后，OpenClaw 会自动创建初始工作区文件。你可以随时编辑这些文件来定制你的 AI 助手的行为。

💡 备份建议
建议将工作区目录初始化为 Git 仓库（最好是私有的），这样你的配置和记忆就有了版本控制和备份。如果安装了 Git，全新工作区会自动初始化 Git 仓库。

{ "agent": { "workspace": "/home/yourname/my-openclaw-workspace" } } 

GPT plus 代充 只需 145# 1. 检查端口占用 # WSL2 中 ss -tlnp | grep 18789 # 或 lsof -i :18789 # 2. 查看详细错误日志 openclaw logs --tail 100 # 3. 运行诊断 openclaw doctor # 4. 尝试前台运行以查看详细输出 openclaw gateway --port 18789 --verbose 

常见原因：

• 端口 18789 被其他程序占用 — 更换端口或关闭占用程序
• Node.js 版本低于 22 — 升级 Node.js
• 配置文件语法错误 — 运行 openclaw config list 检查
• systemd 服务异常 — 运行 openclaw gateway install 重新安装

# 检查通道配置 openclaw config get channels.feishu # 测试飞书连接 openclaw channels test feishu # 查看实时日志中的通道相关输出 openclaw logs --follow | grep feishu 

按以下顺序排查：

1. 确认应用已发布并审批通过
2. 确认事件订阅配置正确（im.message.receive_v1）
3. 确认选择了长连接模式（WebSocket），不是 Webhook
4. 确认应用权限完整（对照上方权限列表检查）
5. 确认 Gateway 正在运行：openclaw gateway status
6. 查看实时日志：openclaw logs --follow

GPT plus 代充 只需 145# 检查 API Key 配置 openclaw config get models.openai.auth.apiKey # 检查默认模型设置 openclaw config get models.default # 运行健康检查 openclaw health 

如果 openclaw health 显示"未配置认证"，需要回到新手引导设置 OAuth 或 API Key 认证，没有认证 Agent 将无法响应。

WSL2 有自己的虚拟网络，与 Windows 主机的网络不完全相同。常见问题：

• DNS 解析失败：编辑 /etc/wsl.conf 添加 [network] generateResolvConf=false，然后手动创建 /etc/resolv.conf 指定 DNS
• 无法访问 Windows 服务：使用 cat /etc/resolv.conf 查看 Windows 主机 IP，通常为 172.x.x.1
• 代理问题：如果使用代理，需要在 WSL 中设置 http_proxy 和 https_proxy 环境变量

# 如果 npm install -g 报 EACCES 错误 # 方式一：切换 npm 前缀到用户目录（推荐） mkdir -p ~/.npm-global npm config set prefix '~/.npm-global' echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc source ~/.bashrc # 方式二：直接使用官方安装器（自动处理此问题） curl -fsSL https://openclaw.ai/install.sh | bash 

推荐方式：重新运行安装器脚本，它会自动检测并升级：

GPT plus 代充 只需 145# WSL2 中 curl -fsSL https://openclaw.ai/install.sh | bash # Windows PowerShell 中 iwr -useb https://openclaw.ai/install.ps1 | iex 

手动更新（npm 全局安装）：

npm install -g openclaw@latest 

更新后执行以下命令确保一切正常：

GPT plus 代充 只需 145openclaw doctor # 运行诊断修复（迁移配置、检查兼容性） openclaw gateway restart # 重启 Gateway openclaw health # 健康检查 

# 查看所有可用版本 npm view openclaw versions # 安装指定版本 npm install -g openclaw@ 
  
    
    
      # 重启 openclaw doctor openclaw gateway restart 
    

GPT plus 代充 只需 145# 1. 停止 Gateway openclaw gateway stop # 2. 卸载 Gateway 服务 openclaw gateway uninstall # 如果安装了 systemd 服务 # 3. 卸载 CLI npm uninstall -g openclaw@latest # 4. 删除配置和数据（可选，会清除所有设置和工作区数据） rm -rf ~/.openclaw rm -rf ~/openclaw # 如果你使用了默认工作区 

WSL2 有自己的虚拟网络。如果另一台机器需要访问 WSL 内运行的服务（如 Gateway 网关），你需要将 Windows 端口转发到 WSL 的 IP。

⚠️ 注意
WSL 的 IP 地址在每次重启后可能会改变，因此你可能需要在每次 WSL 重启后刷新端口转发规则。

以下操作需要在管理员权限的 PowerShell中执行：

# 设置变量 $Distro = "Ubuntu-24.04" # 你的 WSL 发行版名称 $ListenPort = 18789 # Windows 上监听的端口 $TargetPort = 18789 # WSL 内部端口 # 获取当前 WSL 的 IP 地址 $WslIp = (wsl -d $Distro -- hostname -I).Trim().Split(" ")[0] if (-not $WslIp) { throw "WSL IP not found." } Write-Host "WSL IP: $WslIp" # 添加端口转发规则 netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=$ListenPort ` connectaddress=$WslIp connectport=$TargetPort 

GPT plus 代充 只需 145# 允许端口通过 Windows 防火墙 New-NetFirewallRule -DisplayName "WSL OpenClaw $ListenPort" -Direction Inbound ` -Protocol TCP -LocalPort $ListenPort -Action Allow 

# 删除旧规则 netsh interface portproxy delete v4tov4 listenport=$ListenPort listenaddress=0.0.0.0 | Out-Null # 重新获取 WSL IP $WslIp = (wsl -d $Distro -- hostname -I).Trim().Split(" ")[0] # 添加新规则 netsh interface portproxy add v4tov4 listenport=$ListenPort listenaddress=0.0.0.0 ` connectaddress=$WslIp connectport=$TargetPort | Out-Null 

你可以将此脚本注册为计划任务，在 Windows 登录时自动运行，实现自动化端口转发刷新。

• 从其他机器访问时，目标是 Windows 主机的 IP（不是 WSL IP），例如 http://192.168.1.100:18789/
• 远程节点必须指向可访问的 Gateway URL（不是 127.0.0.1），使用 openclaw status --all 确认
• listenaddress=0.0.0.0 允许局域网访问；使用 127.0.0.1 则仅限本机访问

• OpenClaw 官方文档
• GitHub 仓库
• ClawHub 技能市场
• Discord 社区
• Microsoft WSL2 官方文档