OpenClaw 跨平台安装完全指南:Windows/macOS/Linux 三系统亲测有效!

OpenClaw 跨平台安装完全指南:Windows/macOS/Linux 三系统亲测有效!p p 本文详细介绍了如何在 Windows macOS 和 Linux 系统上安装配置 OpenClaw 让你快速拥有自己的 AI 助手 建议收藏 什么是 OpenClaw OpenClaw 是一个开源的 AI 助手框架 它让你能够在本地运行 AI 助手 并连接各种工具和服务 与单纯的网页版 ChatGPT 不同 OpenClaw 可以 执行本地命令 读写文件

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



 

 

本文详细介绍了如何在Windows、macOS和Linux系统上安装配置OpenClaw,让你快速拥有自己的AI助手。建议收藏!


什么是OpenClaw?

OpenClaw 是一个开源的AI助手框架,它让你能够在本地运行AI助手,并连接各种工具和服务。与单纯的网页版ChatGPT不同,OpenClaw可以:

  • 🔧 执行本地命令 — 读写文件、运行代码、管理项目
  • 🔗 集成多种服务 — Discord、Telegram、WhatsApp、邮件等
  • 🛠️ 扩展能力强 — 通过Skills(技能)系统添加新功能
  • 🔒 数据私密 — 本地运行,数据不上传云端
  • 🤖 多模型支持 — OpenAI、Claude、本地模型等
适用场景
场景 说明 个人助理 管理日程、提醒事项、查询信息 开发助手 代码审查、项目维护、自动化脚本 知识管理 整理笔记、搜索文档、生成摘要 多平台消息 统一管理多个聊天平台的消息

系统要求
项目 最低要求 推荐配置 操作系统 Windows 10 / macOS 12 / Ubuntu 20.04 Windows 11 / macOS 14 / Ubuntu 22.04 Node.js v18.0.0 v20.x LTS 内存 4GB 8GB+ 磁盘空间 1GB 5GB+ 网络 能访问OpenAI/Claude API 稳定的外网连接
必备工具
  1. Node.js — 运行环境
  2. Git — 克隆代码(可选,也可直接下载)
  3. 代码编辑器 — VS Code 推荐
  4. API Key — OpenAI 或 Claude 的API密钥

步骤1:安装 Node.js
  1. 访问 Node.js官网
  2. 下载 LTS版本(左侧绿色按钮)
  3. 运行安装程序,一路点击“下一步”
  4. 安装完成后,打开 PowerShell 验证:

powershell

node –version npm –version

看到版本号即表示安装成功。

步骤2:安装 OpenClaw
方式一:通过 npm 安装(推荐)

powershell

# 全局安装 OpenClaw CLI npm install -g openclaw

验证安装

openclaw –version

方式二:从源码安装

powershell

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

安装依赖

npm install

构建项目

npm run build

链接到全局

npm link

步骤3:初始化配置

powershell

# 创建工作目录 mkdir C:Users%USERNAME%.openclaw cd C:Users%USERNAME%.openclaw

初始化配置

openclaw init

运行后会生成基础配置文件。

步骤4:配置 API Key

编辑配置文件:

powershell

notepad C:Users%USERNAME%.openclawconfig.yaml

添加你的API密钥:

yaml

# OpenAI 配置 providers: openai:

apiKey: "sk-your-openai-api-key-here" defaultModel: "gpt-4o" 

# Claude 配置(可选) anthropic:

apiKey: "sk-ant-your-claude-api-key-here" defaultModel: "claude-3-5-sonnet-"

步骤5:启动 OpenClaw

powershell

# 启动交互式会话 openclaw chat

或者启动 Web 界面

openclaw web


步骤1:安装 Homebrew(如未安装)

bash

/bin/bash -c “$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)";
步骤2:安装 Node.js

bash

# 使用 Homebrew 安装 brew install node

验证安装

node –version npm –version

步骤3:安装 OpenClaw

bash

# 全局安装 npm install -g openclaw

验证

openclaw –version

步骤4:初始化与配置

bash

# 创建工作目录 mkdir -p ~/.openclaw cd ~/.openclaw

初始化

openclaw init

编辑配置

openclaw config edit

步骤5:启动

bash

# 命令行交互 openclaw chat

或启动 Web UI

openclaw web –port 3000


步骤1:安装 Node.js

bash

# 使用 NodeSource 安装最新版 curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt-get install -y nodejs

验证

node –version npm –version

步骤2:安装 OpenClaw

bash

# 全局安装 sudo npm install -g openclaw

验证

openclaw –version

步骤3:初始化配置

bash

mkdir -p ~/.openclaw cd ~/.openclaw openclaw init
步骤4:配置 API Key

bash

# 使用默认编辑器打开配置 openclaw config edit

或者手动编辑

nano ~/.openclaw/config.yaml

步骤5:启动服务

bash

# 前台运行 openclaw chat

后台运行 Web 服务

nohup openclaw web –port 3000 > openclaw.log 2>&1 &


6.1 配置文件结构

yaml

# ~/.openclaw/config.yaml

模型提供商配置

providers: openai:

apiKey: "${OPENAI_API_KEY}" baseUrl: "https://api.openai.com/v1" defaultModel: "gpt-4o" 

anthropic:

apiKey: "${ANTHROPIC_API_KEY}" defaultModel: "claude-3-5-sonnet-" 

# 本地模型(通过 Ollama) ollama:

baseUrl: "http://localhost:11434" defaultModel: "llama3.2" 

默认使用的提供商

defaultProvider: openai

网关配置(用于消息服务)

gateway: enabled: true port: 8080

技能配置

skills: directory: ”./skills“ autoLoad: true

日志配置

logging: level: info file: ”./logs/openclaw.log“

6.2 环境变量配置(更安全)

为了避免将API Key直接写在配置文件里,可以使用环境变量:

Windows (PowerShell):

powershell

[Environment]::SetEnvironmentVariable(”OPENAI_API_KEY“, ”sk-your-key“, ”User“)

macOS/Linux:

bash

# 添加到 ~/.bashrc 或 ~/.zshrc export OPENAI_API_KEY=”sk-your-key“ export ANTHROPIC_API_KEY=”sk-ant-your-key“

立即生效

source ~/.bashrc

然后在  中引用:

yaml

providers: openai:

apiKey: "${OPENAI_API_KEY}"

命令 说明 查看版本 查看帮助 初始化配置 编辑配置 验证配置 启动交互式会话 启动 Web 界面 指定端口启动 查看运行状态 启动网关服务 停止网关服务

8.1 接入 Discord
  1. 访问 Discord Developer Portal
  2. 创建新应用 → Bot → 复制 Token
  3. 添加到 :

yaml

channels: discord:

enabled: true botToken: "${DISCORD_BOT_TOKEN}"

8.2 接入 Telegram
  1. 找 @BotFather 创建机器人,获取 Token
  2. 配置:

yaml

channels: telegram:

enabled: true botToken: "${TELEGRAM_BOT_TOKEN}"

8.3 接入 WhatsApp

yaml

channels: whatsapp:

enabled: true # 扫描二维码登录

OpenClaw 的强大之处在于可扩展的 Skills 系统:

bash

# 列出可用技能 openclaw skills list

安装天气技能

openclaw skills install weather

安装文件系统技能

openclaw skills install filesystem

安装网页搜索技能

openclaw skills install web-search


Q1: 安装时提示权限错误?

Windows: 以管理员身份运行 PowerShell

macOS/Linux:

bash

sudo npm install -g openclaw –unsafe-perm
Q2: 启动时提示 ”API Key not found“?

检查:

  1.  中是否正确配置了 apiKey
  2. 环境变量是否正确设置
  3. 运行  验证
Q3: 如何切换模型?

在聊天中使用:

text

/model gpt-4o /model claude-3-5-sonnet

或在配置中修改 。

Q4: 如何更新 OpenClaw?

bash

npm update -g openclaw
Q5: 如何完全卸载?

bash

npm uninstall -g openclaw rm -rf ~/.openclaw # 删除配置和数据

11.1 使用本地模型(Ollama)
  1. 安装 Ollama:ollama.com
  2. 下载模型:

bash

ollama pull llama3.2 ollama pull qwen2.5
  1. 配置 OpenClaw 使用本地模型
11.2 配置代理(国内用户)

yaml

providers: openai:

apiKey: "${OPENAI_API_KEY}" baseUrl: "https://your-proxy-domain.com/v1"

11.3 自定义工作区

bash

# 指定工作目录启动 openclaw chat –workspace /path/to/workspace

恭喜你!现在你已经成功安装并配置了 OpenClaw。接下来可以:

  1. 🚀 尝试与AI助手对话
  2. 🔌 接入你喜欢的消息平台
  3. 🛠️ 安装更多 Skills 扩展功能
  4. 🤖 探索 Agent 的自动化能力

OpenClaw 的潜力远不止于此,随着你的使用,会发现更多有趣的玩法。


  • 📖 官方文档
  • 💻 GitHub 仓库
  • 🎮 Discord 社区
  • 🔍 Skills 市场

📌 如果本文对你有帮助,请点赞、收藏、关注三连支持!

💬 有问题欢迎在评论区留言,我会及时回复!

小讯
上一篇 2026-03-30 19:37
下一篇 2026-03-30 19:35

相关推荐

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/229939.html