openclaw快速安装教程，养龙虾必备，五分钟搞定

#
OpenClaw
快速配置完整指南
OpenClaw 是一款功能强大的跨平台
AI 助手工具，支持多种大语言模型接入和灵活的部署方式。下面将详细介绍在不同环境下的
快速配置方法。 🛠️ 环境准备与前置依赖 1. Node.js 环境配置
OpenClaw 基于 Node.js 开发，需要先
安装合适的 Node.js 版本： bash # 使用 NVM
安装 Node.js（推荐） curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash source ~/.bashrc nvm install 22.22.0 nvm use 22.22.0 # 验证
安装 node –version # 应该显示 v22.22.0 npm –version 2. Git 配置 确保 Git 已正确
安装并配置： bash # 检查 Git 版本 git –version # 配置用户信息（如未配置） git config –global user.name “Your Name” git config –global user.em
ail “your.em
ai” 3. PowerShell 执行策略调整（Windows 环境） 在 Windows 环境下需要调整 PowerShell 执行策略： powershell # 以管理员身份运行 PowerShell Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser Get-ExecutionPolicy # 验证设置 🚀 核心
安装步骤 方法一：CLI
快速
安装（推荐） bash # 使用 npm 全局
安装
OpenClaw CLI npm install -g @
openclaw/cli # 或者使用 yarn yarn global add @
openclaw/cli # 验证
安装
openclaw –version 方法二：一键脚本
安装（Ubuntu/Linux） bash # 下载并执行一键
安装脚本 curl -fsSL https://raw.githubusercontent.com/
openclaw/
openclaw/m
ain/scripts/install.sh | bash # 或者使用 wget wget -qO- https://raw.githubusercontent.com/
openclaw/
openclaw/m
ain/scripts/install.sh | bash 方法三：Docker 容器化部署 bash # 拉取官方镜像 docker pull
openclaw/
openclaw:latest # 运行容器 docker run -d -p 18789:18789 –name
openclaw
openclaw/
openclaw:latest # 或者使用 nanobot 轻量级镜像 docker run -d -p 8000:8000 –name nanobot nanobot/
openclaw:latest ⚙️ 模型配置详解 1. 交互式模型配置
安装完成后，运行配置命令： bash # 启动交互式配置向导
openclaw config # 或者直接编辑配置文件
openclaw config edit 配置过程会引导您选择并配置支持的模型： | 模型类型 | 适用场景 | 配置要点 | API 成本 | |———|———|———|———| | Moonshot (Kimi) | 长文本处理、复杂推理 | 需要 API Key，支持 128K 上下文 | 中等 [ref_1] | | Open
AI GPT 系列 | 通用对话、代码生成 | 需要 Open
AI API Key | 较高 | | Claude 系列 | 创意写作、逻辑分析 | 需要 Anthropic API Key | 中等 [ref_1] | | Qwen 系列 | 中文优化、本地部署 | 支持本地模型，无需 API Key | 免费/低 [ref_4] | | MiniMax | 国产模型、中文场景 | 需要国内 API 接入 | 低 [ref_2] | | GLM 系列 | 中文对话、知识问答 | 智谱
AI 提供 | 中等 | | 通义千问 | 阿里生态、电商场景 | 阿里云 API 接入 | 中等 | | 讯飞星火 | 语音交互、教育场景 | 科大讯飞 API | 中等 | | 字节豆包 | 内容创作、营销文案 | 字节跳动 API | 中等 | | 百度文心 | 搜索增强、多模态 | 百度智能云 API | 中等 [ref_1] | 2. API 密钥配置示例 yaml # config.yaml 配置文件示例 models: – name: “moonshot” type: “moonshot” api_key: “sk-your-moonshot-api-key-here” base_url: “https://api.moonshot.cn/v1” – name: “open
ai” type: “open
ai” api_key: “sk-your-open
ai-api-key-here” base_url: “https://api.open
ai.com/v1″ – name: “qwen-local” type: “qwen” base_url: “http://localhost:8080/v1” # 无需 API Key，本地部署 3. 本地模型部署配置 对于希望完全本地化运行的用户，可以配置 Qwen 等开源模型： bash # 使用 Ollama 部署本地模型 ollama pull qwen2.5:7b ollama serve # 然后在
OpenClaw 中配置
openclaw config set model.qwen.base_url http://localhost:11434/v1 🎯 平台特定配置 Windows 环境完整流程 powershell # 1.
安装 Node.js 22.22.0 # 2. 调整 PowerShell 执行策略 Set-ExecutionPolicy RemoteSigned # 3.
安装
OpenClaw npm install -g @
openclaw/cli # 4. 初始化配置
openclaw init # 5. 启动 Web 界面
openclaw web 访问 `http://localhost:18789` 即可使用 Web 界面 [ref_1]。 Linux/Ubuntu 环境配置 bash # 更新系统包 sudo apt update && sudo apt upgrade -y #
安装依赖 sudo apt install -y curl git build-essential # Node.js 环境（通过 NVM） curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash source ~/.bashrc nvm install 22.22.0 nvm use 22.22.0 #
安装
OpenClaw npm install -g @
openclaw/cli #
快速初始化
openclaw quickstart macOS 环境配置 bash # 使用 Homebrew
安装依赖 brew install node git # 或者使用 NVM curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash source ~/.zshrc nvm install 22.22.0 #
安装
OpenClaw npm install -g @
openclaw/cli 🔧 高级功能配置 1. 飞书机器人集成 bash #
安装飞书插件
openclaw plugins install feishu # 配置飞书机器人
openclaw config set feishu.app_id “your_app_id”
openclaw config set feishu.app_secret “your_app_secret”
openclaw config set feishu.verification_token “your_token” 配置完成后需要在飞书开放平台创建应用并配置权限 [ref_2]。 2. 机器人接入 bash # 使用 nanobot 镜像的 机器人功能 docker run -d -p 8080:8080 -e _APP_ID=”your__app_id” -e _SECRET=”your__secret” –name nanobot- nanobot/
openclaw:latest 3. 多设备同步配置 yaml # 主节点配置 sync: enabled: true server_url: “http://your-m
ain-node:18789″ auth_token: “your-sync-token” # 客户端openclaw docker 教程配置 sync: enabled: true client_mode: true server_url: “http://your-m
ain-node:18789″ auth_token: “your-sync-token” 🎨 Web UI 与 TUI 配置 Web 界面访问 bash # 启动 Web 服务
openclaw web # 指定端口
openclaw web –port 3000 # 后台运行
openclaw web –daemon 启动后访问 `http://localhost:18789` 即可使用 Web 界面。 TUI（终端界面）配置 bash # 启动终端界面
openclaw tui # 配置 TUI 主题
openclaw config set tui.theme “dark”
openclaw config set tui.layout “vertical” 重要提示：Web UI 和 TUI 使用独立的认证令牌，需要确保令牌同步 [ref_4]。 🚨 常见问题排查 1.
安装失败处理 bash # 清理缓存重新
安装 npm cache clean –force npm uninstall -g @
openclaw/cli npm install -g @
openclaw/cli # 或者使用不同镜像源 npm install -g @
openclaw/cli –registry=https://registry.npmmirror.com 2. 模型连接问题 bash # 测试模型连接
openclaw test-connection –model moonshot # 查看详细日志
openclaw –debug web 3. 权限问题解决 bash # Linux/macOS 权限修复 sudo chown -R $(whoami) ~/.
openclaw # npm 全局
安装权限 npm config set prefix ~/.npm-global echo ‘export PATH=~/.npm-global/bin:$PATH’ >> ~/.bashrc 4. 端口冲突处理 bash # 查看占用端口 netstat -tulpn | grep 18789 # 使用其他端口
openclaw web –port 3000 📊 性能优化建议 硬件要求建议 | 部署类型 | 内存要求 | 存储空间 | 网络要求 | 推荐场景 | |———|———|———|———|———| | 纯 API 模式 | 4GB+ | 1GB | 稳定互联网 | 个人使用 [ref_1] | | 本地模型轻量 | 8GB+ | 5GB+ | 可选 | 开发测试 [ref_5] | | 本地模型完整 | 16GB+ | 20GB+ | 可选 | 生产环境 [ref_4] | | 多设备主节点 | 8GB+ | 2GB+ | 稳定内网 | 团队协作 [ref_3] | 网络优化配置 yaml network: timeout: 30000 retries: 3 proxy: enabled: false # http://your-proxy:port 通过以上完整的配置指南，您应该能够在 10-30 分钟内完成
OpenClaw 的
快速配置并开始使用。建议从简单的 API 模型开始，逐步探索本地模型部署和高级功能集成。