2026年【2026最新】OpenClaw安装与运行教程，WINDOWS+MAC保姆级安装配置教程

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

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

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

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

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

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

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

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

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

硬件要求：

系统版本：

前置软件：

安装步骤

第一步：打开终端

第二步：安装 OpenClaw

在终端中执行以下命令：

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

安装过程会自动：

预计时间：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. 选择聊天工具：

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用户：完全可用，但部分系统集成功能受限。

硬件要求：

操作系统：

前置软件：

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安装（推荐）

安装完成后会自动打开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

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

常见做法有三种：

例如 OpenAI、Anthropic、OpenRouter 等。

配置逻辑是：

选择你的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 对话。

一般保持默认即可：

18789

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

向导会让你选择 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 已经内置了大量工具，包括：

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

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

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

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

在终端输入：

openclaw tui

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

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

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

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

macOS: /.openclaw/openclaw.json

Linux: /.openclaw/openclaw.json

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

配置神马中转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": ,

"maxTokens": 8192

{

"id": "gpt-4",

"name": "GPT-4",

"contextWindow": ,

"maxTokens": 4096

}

]

}

"agents": {

"defaults": {

"model": {

"primary": "whataicc/claude-sonnet-4-6"

}

配置参数说明

常见API协议类型

配置后重启服务

# 方式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 这种基础工具白名单配置，例如：

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

示意配置如下：

{

"tools": {

"profile": "coding",

"deny": ["group:runtime"]

}

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

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

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

先检查 Gateway 是否正常运行：

openclaw status

openclaw gateway status

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

openclaw gateway –port 18789 –verbose

先执行：

openclaw config file

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

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

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

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

2026年【2026最新】OpenClaw安装与运行教程，WINDOWS+MAC保姆级安装配置教程

相关推荐