本文详细介绍了如何在Windows、macOS和Linux系统上安装配置OpenClaw,让你快速拥有自己的AI助手。建议收藏!
什么是OpenClaw?
OpenClaw 是一个开源的AI助手框架,它让你能够在本地运行AI助手,并连接各种工具和服务。与单纯的网页版ChatGPT不同,OpenClaw可以:
- 🔧 执行本地命令 — 读写文件、运行代码、管理项目
- 🔗 集成多种服务 — Discord、Telegram、WhatsApp、邮件等
- 🛠️ 扩展能力强 — 通过Skills(技能)系统添加新功能
- 🔒 数据私密 — 本地运行,数据不上传云端
- 🤖 多模型支持 — OpenAI、Claude、本地模型等
适用场景
系统要求
必备工具
- Node.js — 运行环境
- Git — 克隆代码(可选,也可直接下载)
- 代码编辑器 — VS Code 推荐
- API Key — OpenAI 或 Claude 的API密钥
步骤1:安装 Node.js
- 访问 Node.js官网
- 下载 LTS版本(左侧绿色按钮)
- 运行安装程序,一路点击“下一步”
- 安装完成后,打开 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}"
8.1 接入 Discord
- 访问 Discord Developer Portal
- 创建新应用 → Bot → 复制 Token
- 添加到 :
yaml
channels: discord:
enabled: true botToken: "${DISCORD_BOT_TOKEN}"
8.2 接入 Telegram
- 找 @BotFather 创建机器人,获取 Token
- 配置:
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“?
检查:
- 中是否正确配置了 apiKey
- 环境变量是否正确设置
- 运行 验证
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)
- 安装 Ollama:ollama.com
- 下载模型:
bash
ollama pull llama3.2 ollama pull qwen2.5
- 配置 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。接下来可以:
- 🚀 尝试与AI助手对话
- 🔌 接入你喜欢的消息平台
- 🛠️ 安装更多 Skills 扩展功能
- 🤖 探索 Agent 的自动化能力
OpenClaw 的潜力远不止于此,随着你的使用,会发现更多有趣的玩法。
- 📖 官方文档
- 💻 GitHub 仓库
- 🎮 Discord 社区
- 🔍 Skills 市场
📌 如果本文对你有帮助,请点赞、收藏、关注三连支持!
💬 有问题欢迎在评论区留言,我会及时回复!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/229939.html