OpenClaw安装与运行教程：Windows+MAC配置中转API教程

OpenClaw 是当前 AI Agent 领域最受关注的开源工具之一，它把 AI 从“只能聊天的助手”升级为“能执行任务的智能体”。通过接入大模型并调用工具，OpenClaw可以自动完成搜索网页、编写代码、管理文件、安排日程等复杂任务，甚至像一个全天候工作的“AI员工”。相比传统聊天机器人，它的核心价值在于让 AI 不只是回答问题，而是能够真正 思考-行动-反馈 的循环执行任务，从而实现自动化工作流和个人 AI 助手的能力。

它不仅在技术上带来了 AI 从“对话”到“执行”的关键跨越，也在开发者社区掀起了巨大的创新热潮。自开源以来，它在 GitHub 上迅速积累了数十万星标，大量创业团队和开发者围绕它开发插件、工具和自动化应用，甚至有人把它称为“AI时代的 Linux”或“Agent 操作系统”。在中国市场尤其火爆，教程、案例和创业项目快速涌现，许多团队正基于 OpenClaw 构建新的 AI 产品和自动化服务，推动 AI Agent 生态迅速成长。

OpenClaw是什么

OpenClaw 是一个开源、本地部署的 AI Agent 网关。它的核心思路不是“只回答问题”，而是让 AI 具备执行动作的能力，例如访问网页、运行命令、调度任务、连接聊天渠道和管理会话。根据资料，它原先还经历过名称变动：先后出现过 Clawdbot、Moltbot，最终在 2026 年 1 月底确定为 OpenClaw。

OpenClaw适合谁使用

如果你只是想体验普通 AI 对话，网页聊天产品已经够用了；但如果你想让 AI 真正“动手做事”，例如：

• 在本机或服务器上长期运行一个 AI 助手

• 通过 Web、Slack、Telegram 等入口随时调用它

• 让它搜索网页、打开页面、执行命令、自动化处理任务

• 接入自己的模型或中转 API，统一管理模型调用

那 OpenClaw 会更适合。第三方教程也特别强调，它更像“基础设施型 AI 助手”，而不是简单 Demo。

安装配置OpenClaw

安装前准备，系统与环境要求

如果你是新手，建议这样理解：

• macOS：体验最好，适合本地长期运行

• Windows：可用，适合一般用户

• Linux：适合开发者和服务器部署

• Node.js：建议使用 22+

• 磁盘/内存：普通本地使用不需要特别高配置，但长期运行建议 8GB 内存以上更稳妥。

Mac本地部署（推荐）

最佳体验：如果你有Mac电脑，强烈推荐本地部署，体验最好、功能最全！

硬件要求：

• CPU：M系列芯片或Intel i5以上
• 内存：8GB以上（推荐16GB）
• 硬盘：10GB以上空闲空间

系统版本：

• macOS 12 Monterey 或更高版本
• 推荐 macOS 14 Sonoma 或 macOS 15 Sequoia

前置软件：

• Node.js 22.0.0+（会自动安装）
• Homebrew（可选，用于安装依赖）

安装步骤

第一步：打开终端

1. 按 Command + 空格 打开 Spotlight
2. 输入 Terminal 或终端
3. 按回车打开终端

第二步：安装 OpenClaw

在终端中执行以下命令：

curl -fsSL https://openclaw.ai/install.sh | bash

安装过程会自动：

• 检测系统环境
• 安装Node.js（如果未安装）
• 下载OpenClaw
• 配置环境变量

预计时间：2-5分钟

第三步：验证安装

安装完成后，执行以下命令验证：

openclaw --version

如果显示版本号（如 2026.3.7），说明安装成功！

第四步：初始化配置

运行配置向导：

openclaw onboard

配置流程：

1. 接受风险提示：

选择 Yes 继续

2. 选择启动模式：

推荐选择 QuickStart 快速启动：

3. 选择AI模型：

选择你的AI供应商选择Custom Provider：

4. 输入BaseURL和API Key：

输入模型BaseURL：https://api.whatai.cc/v1，输入对应的API Key，选择OpenAI-compatible，输入模型ID如：claude-sonnet-4-6

5. 选择聊天工具：

• 如果要接入飞书/Telegram，选择对应选项
• 如果暂时不接入，选择 None（后续可配置）

6. Gateway端口设置：

默认 18789 即可：

7. 选择Skills：

使用空格键选择你需要的技能，也可以直接跳过：

8. API Key配置：

没有的可以选择 no 跳过：

9. 启用Hooks：

推荐启用这三个钩子（用于内容引导、日志和会话记录）：

10. 完成配置：

配置完成后，会自动启动Gateway服务并打开Web UI（http://127.0.0.1:18789/chat）

第五步：验证安装

# 检查Gateway状态
openclaw channels status

# 应该显示：
# Gateway reachable.

Windows本地部署

🪟 Windows用户：完全可用，但部分系统集成功能受限。

硬件要求：

• CPU：2核以上
• 内存：4GB以上（推荐8GB）
• 硬盘：10GB以上空闲空间

操作系统：

• Windows 10 或 Windows 11

前置软件：

• Node.js 22.0.0+

WSL2 + Ubuntu部署（强烈推荐）

这是官方推荐的Windows部署方式，提供最完整的Linux环境支持。

第一步：启用WSL2

以管理员身份打开PowerShell，执行：

# 启用WSL功能
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

# 设置WSL 2为默认版本
wsl --set-default-version 2

重启计算机。

第二步：安装Ubuntu

方法一：Microsoft Store安装（推荐）

1. 打开Microsoft Store
2. 搜索「Ubuntu 22.04 LTS」或「Ubuntu 24.04 LTS」
3. 点击「获取」并安装
4. 首次启动设置用户名和密码

安装完成后会自动打开Ubuntu终端，按提示设置用户名和密码。

第三步：更新Ubuntu系统

在Ubuntu终端中执行：

# 更新软件包列表
sudo apt update && sudo apt upgrade -y

# 安装基础工具
sudo apt install -y curl git wget build-essential

第四步：安装Node.js 22+

#运行 NVM 安装脚本
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

#使 NVM 生效
source ~/.bashrc

#安装 Node.js：
nvm install 22

#验证 Node.js 版本（必须≥22.x）
node --version
npm --version

第五步：安装 OpenClaw

一键脚本安装

curl -fsSL https://openclaw.ai/install.sh | bash

选择AI模型：

选择你的AI供应商选择Custom Provider：

输入BaseURL和API Key：

输入模型BaseURL：https://api.whatai.cc/v1，输入对应的API Key，选择OpenAI-compatible，输入模型ID如：claude-sonnet-4-6

第六步：验证安装

# 查看版本
openclaw --version

# 查看帮助
openclaw --help

# 查看系统状态
openclaw status

第七步：配置Windows访问WSL2服务

由于OpenClaw运行在WSL2中，需要配置端口转发以便Windows访问。

创建启动脚本 start-openclaw.bat：

@echo off
echo Starting OpenClaw Gateway in WSL2...
wsl -d Ubuntu-22.04 -u root service openclaw start
timeout /t 3
start http://localhost:18789

或直接在WSL2中启动：

# 在WSL2 Ubuntu终端中
openclaw gateway run --port 18789

然后在Windows浏览器访问 http://localhost:18789

配置模型Custom Provider

这一步决定 OpenClaw 调用哪个大模型。

常见做法有三种：

1. 直接使用官方模型服务

例如 OpenAI、Anthropic、OpenRouter 等。

2. 使用 OpenAI 兼容中转 API

配置逻辑是：

• 选择 Custom Provider

• 输入 BaseURL

• 输入 API Key

• Provider 类型选 OpenAI-compatible

• 再填写模型 ID

选择你的AI供应商选择Custom Provider：

4. 输入BaseURL和API Key：

输入模型BaseURL：https://api.whatai.cc/v1，输入对应的API Key，选择OpenAI-compatible，输入模型ID如：claude-sonnet-4-6

配置聊天入口

在 openclaw onboard 过程中，还会让你选择聊天渠道。如果暂时不接入 Slack、飞书等外部平台，可以直接选：

None

后续再配置即可。

如果你想在聊天软件里直接使用 OpenClaw，就在向导里选择对应平台并填入 Token。知乎教程重点演示了 Slack 的接入流程，并说明 Gateway 后台运行后，即使关闭 TUI 或 Web 面板，Slack 仍可正常和 Bot 对话。

Gateway 端口与技能选择

1. Gateway 端口

一般保持默认即可：

18789

多个教程都使用这个默认端口。

2. Skills 选择

向导会让你选择 Skills，可以用空格勾选，也可以暂时跳过。第三方教程提到，Skills 主要用于扩展文件管理、知识管理、自动化等能力。

不过根据官方新文档，OpenClaw 现在更强调“一级工具”能力，浏览器、画布、节点、定时任务等已经是原生工具；Skills 和插件仍然存在，但更偏扩展与提示注入，而不是过去那种完全依赖 skill shell 的方式。

完成安装后如何进入界面

当 onboarding 完成后，OpenClaw 会自动启动 Gateway，并打开 Web UI。常见地址为：

http://127.0.0.1:18789/chat

或者用：

openclaw dashboard

直接打开控制面板。知乎文章也提到，某些情况下会生成带 token 的本地访问地址。

如果你偏好终端界面，也可以使用：

openclaw tui

这会进入终端聊天模式。

安装后必会的常用命令

OpenClaw 常用命令一览表：

改完配置后记得运行 openclaw gateway restart 让改动生效～

OpenClaw的核心工具能力

这一部分最值得理解，因为它决定了 OpenClaw 和普通聊天机器人的区别。

官方工具页显示，OpenClaw 已经内置了大量工具，包括：

• exec：执行 shell 命令

• web_search / web_fetch：网页搜索与抓取

• browser：控制专用浏览器

• canvas：界面/内容操作

• pdf：PDF 处理

• message：消息相关

• cron：定时任务

• gateway：重启、应用配置、更新网关

• sessions_*：会话管理

• agents_list：Agent 管理 

尤其是 browser 工具，官方列出了很多动作能力，包括打开标签页、截图、点击、输入、导航、上传文件、导出 PDF 等，说明它不只是“看网页”，而是具备较强的页面操作能力。

cron 工具则支持定时任务管理，比如查看、添加、更新、移除和立即触发任务；gateway 工具则支持应用配置后自动重启和唤醒网关。

怎么用 OpenClaw：实际使用方式

安装并完成配置后，你通常会通过下面三种方式使用它。

1. Web 控制面板使用

最直观。打开浏览器访问本地面板后，直接像和 AI 聊天一样下达指令：

• 帮我搜索今天的科技新闻

• 打开某个网页并总结内容

• 帮我写一个 shell 脚本

• 查看这个项目目录并修改某个文件

• 创建一个定时提醒任务

2. 终端 TUI 使用

在终端输入：

openclaw tui

适合喜欢命令行的人。退出 TUI 不影响后台 Gateway。

3. 聊天平台使用

如果你接入了 Slack、Telegram 等渠道，只要 Gateway 还在后台运行，就可以直接在这些平台和 OpenClaw 对话。知乎教程特别说明了：Gateway 守护进程才是核心后台服务，TUI/Web 控制面板只是额外入口。

配置文件怎么改

OpenClaw 的配置文件位置通常如下：
系统文件路径示例

Windows:
C:Users用户名.openclawopenclaw.json

macOS:
~/.openclaw/openclaw.json

Linux:
~/.openclaw/openclaw.json

需要手动编辑配置文件
~/.openclaw/openclaw.json，指定：

• baseUrl：API服务地址
• apiKey：认证密钥
• api：API协议类型（如
  openai-completions、
  anthropic-messages）
• models：模型列表和参数

配置神马中转API代理

如果你使用API代理服务，配置如下：

{
  "models": {
    "mode": "merge",
    "providers": {
      "whataicc": {
        "baseUrl": "https://api.whatai.cc/v1",
        "apiKey": "sk-xxxxx-你的神马中转API密钥",
        "auth": "api-key",
        "api": "openai-completions",
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "claude-sonnet-4-6",
            "contextWindow": 200000,
            "maxTokens": 8192
          },
          {
            "id": "gpt-4",
            "name": "GPT-4",
            "contextWindow": 128000,
            "maxTokens": 4096
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "whataicc/claude-sonnet-4-6"
      }
    }
  }
}

配置参数说明

常见API协议类型

• openai-completions：OpenAI兼容接口（最常用）
• anthropic-messages：Anthropic Claude接口
• google-generative-ai：Google Gemini接口

配置后重启服务

# 方式1：重启Gateway
openclaw gateway restart

# 方式2：停止后重新启动
systemctl --user stop openclaw-gateway.service
systemctl --user start openclaw-gateway.service

# 方式3：完全重启
systemctl --user restart openclaw-gateway.service

验证配置

# 查看当前配置的模型
openclaw models list

# 测试模型连接
openclaw models test whataicc/claude-sonnet-4-6

工作台页面也可以可视化编辑：

工具权限与安全配置

这一部分非常重要。

官方文档明确提到，OpenClaw 支持通过 tools.allow / tools.deny 来控制工具权限，还支持 tools.profile 这种基础工具白名单配置，例如：

• minimal

• coding

• messaging

• full

例如，官方给出的示例里可以只允许文件工具和浏览器，或者使用 coding 模式但禁用运行时命令。

示意配置如下：

{
  "tools": {
    "profile": "coding",
    "deny": ["group:runtime"]
  }
}

这表示使用 coding 工具集，但禁用 exec/process 这类高风险运行工具。

官方安全提示还明确指出，不应随意使用高风险系统执行能力，并且涉及摄像头、屏幕捕获等操作时要尊重用户授权。

常见问题

1. openclaw –version没输出

大概率是安装不完整，或 Node.js 版本太低。先确认 Node.js ≥ 22，再重新执行一键脚本或 npm 安装。

2. Web 页面打不开

先检查 Gateway 是否正常运行：

openclaw status
openclaw gateway status

必要时手动前台运行观察日志：

openclaw gateway --port 18789 --verbose

3. 不知道配置文件在哪

先执行：

openclaw config file

或者去 ~/.openclaw/ 目录下找 Agent 配置。菜鸟教程指出，认证相关文件通常在 ~/.openclaw/agents/<agentId>/agent/auth-profiles.json。

4. 模型能聊天，但工具不能用

这通常不是模型本身的问题，而是工具配置、权限策略、对应 API Key 或外部依赖未启用。官方工具文档里明确写了：像 web_search、web_fetch 等工具需要先在对应配置中启用，并准备好相关 API Key。

5. 想统一接多模型怎么办

可以采用 OpenAI-compatible 神马中转 API 方案，把 BaseURL 和统一 Key 配到 OpenClaw 中，这样切换模型时不必频繁改多套配置。

如果只说一句结论：OpenClaw 最适合“想把 AI 当成可长期运行助手”的用户。 它的入门门槛主要在安装和首次配置，但一旦用 openclaw onboard 跑通模型、Gateway 和 Web 面板，后续使用体验会比较顺。它已经具备浏览器控制、网页搜索、命令执行、会话管理、定时任务和网关配置等较完整的工具能力。