Linux安装OpenClaw配置详解 OpenClaw对接QWEN模型 OpenClaw常用命令 OpenClaw免费模型推荐
Linux安装OpenClaw配置详解 OpenClaw对接QWEN模型 OpenClaw常用命令 OpenClaw免费模型推荐
一、启动OpenClaw配置向导
1、执行openclaw onboard --install-daemon
ØOpenClaw 默认是个人使用场景配置，若用于共享 / 多用户环境，必须先做安全加固。是否继续？
选项 | 含义 | 适用场景 | 风险提示 |
Yes | 确认接受默认配置，继续启动 OpenClaw | 你是唯一使用者（个人服务器 / 本地环境），不会让其他人直接访问这个代理实例 | 仅适合个人使用，多用户场景必须额外做安全加固 |
No | 拒绝当前配置，中止启动 | 你计划将 OpenClaw 用于共享 / 多用户环境，或对安全风险不确定 | 避免在未做安全加固的情况下暴露到多用户场景 |
2、选择“Yes”，键盘方向←回车确认，进入模式选择
ØOpenClaw 首次启动时的初始化配置模式选择，用来决定你后续的配置流程
选项 | 含义 | 适用场景 | 优点 | 缺点 |
QuickStart（快速启动） | 自动生成一套最小可用配置，跳过复杂的手动设置，后续可以用 openclaw configure 命令精细调整 | ✅ 个人快速体验✅ 不想一开始就纠结复杂配置✅ 先跑起来再优化 | 启动极快，一键完成基础配置，马上能用 | 配置是通用模板，需要后续手动调整细节 |
Manual （手动配置） | 引导你一步步填写所有核心配置项（如模型接入、工具权限、消息平台等） | ✅ 生产环境部署✅ 多用户 / 共享场景✅ 需要严格控制权限和安全 | 配置精准，一次到位，适合长期稳定运行 | 步骤繁琐，需要提前准备好各类接入信息 |
3、初学者建议选择“QuickStart”，进入模型选择
ØOpenClaw 用于选择大模型接入方的配置界面，你可以根据自己的模型使用场景选择对应提供商。
类别 | 代表选项 | 特点与适用场景 |
主流商业模型 | OpenAI、Anthropic、Google、xAI(Grok)、Mistral AI | 提供高性能通用模型，需 API Key 或 OAuth 认证，适合生产环境 |
国内模型服务 | Moonshot AI(Kimi)、Qwen、Qianfan、Alibaba Cloud Model Studio、BytePlus、MiniMax | 国内访问更稳定，支持中文场景，需对应平台 API Key |
本地 / 开源部署 | Ollama、vLLM、LiteLLM、Hugging Face | 支持本地部署开源模型（如 Llama 系列、Qwen 等），无需外网 API，适合隐私敏感场景 |
网关 / 聚合服务 | OpenRouter、Volcano Engine、Cloudflare AI Gateway、Kilo Gateway、Vercel AI Gateway | 聚合多家模型服务，统一接口调用，方便切换模型 |
其他 / 自定义 | Custom Provider、Skip for now | 自定义接入未列出的模型；或暂时跳过配置，后续补充 |
lOpenAI：默认选项，支持 GPT 系列模型，需提供 OpenAI API Key，部分场景支持 Codex OAuth 认证。
lOllama：适合你当前的本地部署场景，可直接对接本地运行的开源模型（如 Llama 3、Qwen 等），无需外网 API。
lSkip for now：暂时跳过模型配置，后续可通过 openclaw configure 命令重新设置。
l本地部署 / 开源模型：选择 Ollama 或 vLLM，适配你已有的 GPU 环境。
l使用国内模型：选择 Moonshot AI(Kimi) 或 Qwen，访问更稳定且中文支持更好。
l快速体验 / 已有 OpenAI 账号：保持 OpenAI，直接填入 API Key 即可使用。
l暂不配置模型：选择 Skip for now，先完成其他配置，后续再补充。
4、我选择的是Qwen（oAuth），如果你购买了其他模型或者使用其他方式部署本地模型请根据自身情况进行修改
需要登陆https://chat.qwen.ai/authorize?user_code=VHJDHGVC&client=qwen-code，如果没有账号，需要注册账号并登陆。
我这里选择“Confirm”，然后关闭浏览器
5、配置默认model，我选择“Keep current (qwen-portal/coder-model)”
6、配置channel
ØOpenClaw 用于选择对外交互的即时通讯平台的配置界面，你可以根据自己的使用场景选择对应的通道
类别 | 代表选项 | 特点与适用场景 |
推荐新手选项 | Telegram (Bot API) | 官方推荐，配置简单，Bot API 成熟稳定，适合快速体验 |
国内常用平台 | Feishu/Lark (飞书) | 支持飞书 / Lark 企业协作平台，适合国内团队使用 |
海外主流平台 | WhatsApp、Discord、Slack、LINE | 对应海外主流通讯工具，需各自平台的 Bot/API 接入 |
自托管/开源平台 | Mattermost、Nextcloud Talk、Matrix | 适合自建服务、注重隐私的场景 |
其他/暂不配置 | Skip for now | 暂时跳过通道配置，后续通过 openclaw configure 补充 |
7、现在暂时不配置，先跳过，选择”Skip for now“，后续对接飞书
8、配置Search provider（联网搜索能力），用于让 AI 代理获取实时信息、补充知识或验证内容
选项 | 含义 | 特点与适用场景 |
Brave Search (Structured results · country/language/time filters) | 默认选中，Brave 搜索引擎 | ✅ 结构化结果，支持国家 / 语言 / 时间过滤✅ 隐私友好，无追踪✅ 适合需要精准筛选搜索结果的场景 |
Gemini (Google Search) | 基于 Google Search 的 Gemini 搜索 | ✅ 覆盖范围广，信息全面✅ 适合需要全球信息、深度检索的场景 |
Grok (xAI) | xAI 旗下的 Grok 搜索服务 | ✅ 偏向实时、社交与趋势类信息✅ 适合获取热点话题、前沿动态 |
Kimi (Moonshot) | Moonshot AI 提供的 Kimi 搜索能力 | ✅ 中文支持优秀，长文本处理能力强✅ 适合国内用户、中文信息检索 |
Perplexity Search | Perplexity 提供的对话式搜索 | ✅ 以自然语言回答问题，直接生成摘要✅ 适合需要 “一问一答” 式信息获取 |
Skip for now | 暂时跳过搜索配置 | ✅ 先完成核心部署，后续再补充搜索能力✅ 无需联网搜索的纯离线场景 |
l默认 / 隐私优先：保持 Brave Search，结构化结果便于 AI 整理和引用，且隐私保护更好。
l国内 / 中文场景：切换到 Kimi (Moonshot)，中文信息获取更精准，访问更稳定。
l全球信息 / 深度检索：选择 Gemini (Google Search)，信息覆盖最全面。
l对话式问答：选择 Perplexity Search，直接获取自然语言回答，减少信息整理成本。
l离线 / 暂不需要搜索：选择 Skip for now，后续可通过 openclaw configure 重新配置。
9、现在暂时不配置，先跳过，选择“Skip for now“
10、配置工具 / 技能确认，标注为 recommended（推荐），本次选择“No“
选项 | 含义 | 适用场景 |
Yes | 进入技能配置向导，开启并配置 OpenClaw 的工具能力（如文件操作、系统命令、搜索、代码执行等） | ✅ 希望 OpenClaw 具备实际执行能力（如读写文件、调用命令、联网搜索）✅ 官方推荐，能让代理从 “聊天” 升级为 “可执行任务的助手” |
No | 跳过技能配置，仅保留基础对话能力，后续可通过 openclaw configure 补充 | ✅ 暂时只想体验基础对话功能✅ 先完成核心部署，再逐步开放工具权限 |
ØOpenClaw 用于选择安装技能所需依赖包的界面，你可以按需勾选需要的技能，避免安装无用依赖
选项 | 含义 | 适用场景 |
Skip for now | 暂时跳过所有依赖安装，仅启动基础功能，后续可通过 openclaw configure 补充 | ✅ 快速完成部署✅ 暂时不需要额外技能 |
单个技能选项 | 勾选后会自动安装该技能所需的依赖库 / 工具 | ✅ 你需要使用对应技能时 |
OpenClaw 技能速查表
技能名称 | 核心作用 | 前置条件 | 安全风险 |
1password | 对接 1Password 密码管理器，查询 / 获取密码、密钥 | 安装 1Password CLI 并登录账号 | ⚠️ 极高（可泄露所有密码） |
blogwatcher | 监控博客 / 网站更新，推送新内容通知 | 配置目标站点 RSS / 网页地址 | 低（仅被动监控） |
blucli | 控制本地蓝牙设备（连接、传输文件等） | 系统安装 bluez 等蓝牙工具，硬件可用 | ⚠️ 中（可访问 / 控制周边蓝牙设备） |
camsnap | 调用系统摄像头拍摄照片 / 视频 | 系统存在可用摄像头并授权 | ⚠️ 极高（可偷拍，侵犯隐私） |
clawhub | OpenClaw 协作同步中心，分享配置 / 技能 | 登录 Clawhub 账号 | 中（可能泄露配置到云端） |
eightctl | 控制 Eight Sleep 智能睡眠设备 | 拥有 Eight Sleep 设备并绑定账号 | 低（仅控制智能家居） |
gemini | 调用 Google Gemini 多模态模型（图文音视频处理） | 拥有 Gemini API Key | 低（仅模型调用，无系统权限） |
gifgrep | 搜索本地 / 网络 GIF / 图片 | 可访问本地图片目录或图床 API | 低（仅读取图片文件） |
github | 管理 GitHub 仓库、Issue、PR 等 | 拥有 GitHub PAT（个人访问令牌） | ⚠️ 高（PAT 权限过大可篡改代码） |
gog | 控制 GOG Galaxy 游戏客户端（安装 / 启动游戏） | 安装 GOG Galaxy 并登录 | 低（仅控制游戏客户端） |
goplaces | 地理位置服务（查路线、POI、天气） | 可访问定位 / 地图 API（如 Google Maps） | 低（仅查询位置信息） |
himalaya | 邮件客户端工具，收发 / 管理邮件 | 配置邮箱账号（IMAP/SMTP） | 中（可读取 / 发送你的邮件） |
mcporter | 迁移 / 备份各类应用数据 | 对应应用已安装并授权访问 | 中（可读取应用敏感数据） |
nano-banana-pro | 文本 / 代码增强编辑工具 | 无特殊依赖（基础文本操作） | 低（仅读写文本文件） |
nano-pdf | 读取 / 解析 PDF 内容 | 系统安装 PDF 处理库（如 poppler） | 低（仅读取 PDF 文本） |
obsidian | 对接 Obsidian 笔记软件，读写 / 同步笔记 | 安装 Obsidian 并指定 vault 路径 | 中（可读写你的笔记文件） |
openai-whisper | 语音转文字（音频 / 视频转文本） | 系统安装 FFmpeg，有可用音频输入 | 中（可读取麦克风 / 音频文件） |
openhue | 控制 Philips Hue 智能灯 | 拥有 Hue 桥接器并完成配对 | 低（仅控制智能家居照明） |
oracle | 对接 Oracle 数据库，执行查询 / 操作 | 拥有 Oracle 数据库连接凭证 | ⚠️ 高（可读写数据库敏感数据） |
ordercli | 管理订单 / 电商平台订单（查询、创建） | 电商平台 API 凭证 | 中（可查看 / 操作你的订单） |
sag | 系统管理工具（查看资源、进程、日志） | 运行用户拥有系统监控权限 | ⚠️ 中（可泄露系统敏感信息） |
songsee | 音乐识别 / 播放控制（如识别歌曲） | 可访问音频输入 / 音乐服务 API | 低（仅音频识别与播放控制） |
sonoscli | 控制 Sonos 智能音响（播放、音量） | 同一局域网内有 Sonos 设备 | 低（仅控制智能家居音响） |
summarize | 文本 / 长文档 / 网页内容摘要生成 | 可访问目标文本 / 网页 | 低（仅读取并生成摘要） |
video-frames | 提取视频帧为图片，分析视频内容 | 系统安装 FFmpeg 等视频处理库 | 中（可读取视频文件） |
wacli | 控制 WhatsApp 客户端（收发消息） | 登录 WhatsApp 账号（如 whatsapp-web.js） | ⚠️ 高（可读取 / 发送你的聊天记录） |
xurl | 抓取网页内容，提取信息 / 生成预览 | 可访问目标网页（网络连通） | 低（仅读取网页内容） |
Skip for now | 跳过所有依赖安装，仅启动基础功能 | 无 | 无（最小权限启动） |
选择建议
l个人安全优先：只勾选你明确会用到的技能，避免安装高风险项（如 1password、camsnap、oracle）。
l最小权限原则：给 API / 凭证分配最小必要权限（如 GitHub PAT 只给 repo 而非 admin 权限）。
l后续调整：随时可通过 openclaw configure 重新安装 / 卸载技能依赖。
l快速部署 / 最小化安装：先勾选 Skip for now，完成启动后再按需安装技能依赖。
11、OpenClaw 配置扩展钩子的界面，Hooks 是在核心流程中插入的自定义功能，用于增强 OpenClaw 的扩展能力，本次选择“Skip for now “，以下是各选项的完整说明：
选项 | 中文释义 | 核心作用 | 适用场景 | 风险 / 注意事项 |
Skip for now | 暂时跳过 | 不启用任何钩子，仅保留核心功能 | ✅ 快速部署✅ 暂时不需要扩展功能 | 无，最小化启动 |
🚀 boot-md | 启动脚本增强 | 加载自定义 Markdown 格式的启动脚本 / 配置 | ✅ 自定义启动流程✅ 批量配置初始化 | 低，仅加载配置文件 |
📎 bootstrap-extra-files | 额外文件引导 | 启动时自动加载指定目录的额外配置 / 脚本文件 | ✅ 扩展自定义工具✅ 加载第三方插件 | 中，若加载恶意文件可能有风险 |
📝 command-logger | 命令日志器 | 记录 OpenClaw 执行的所有命令 / 操作日志 | ✅ 审计 / 排查问题✅ 监控操作行为 | 低，仅记录日志（注意日志文件权限） |
💾 session-memory | 会话记忆 | 持久化存储对话会话，保留上下文记忆 | ✅ 长对话场景✅ 多轮交互 | 低，仅存储对话内容（注意隐私） |
l新手 / 快速体验：勾选 Skip for now，先完成核心部署，后续通过 openclaw configure 再启用需要的钩子。
l需要基础监控：勾选 command-logger（记录操作日志，方便排查问题）。
l需要会话记忆：勾选 session-memory（让 AI 记住多轮对话上下文）。
l自定义配置：勾选 boot-md + bootstrap-extra-files（适合有自定义配置需求的场景）。
lHooks 是可选扩展，不启用任何钩子也不影响 OpenClaw 核心功能（对话、技能调用）。
l后续可通过 openclaw configure 重新进入此界面，随时启用 / 关闭钩子。
l钩子的配置文件默认存储在 ~/.openclaw/hooks/ 目录，可手动修改。
12、选择“Skip for now “选项后，自动安装完成，并显示web登陆地址，登陆token信息
13、选择“Hatch in TUI (recommended) “，即可输入对话内容
OpenClaw 配置完成后，选择最终启动方式的界面，不同选项对应不同的交互形式
选项 | 中文释义 | 核心特点 | 适用场景 | 操作难度 |
Hatch in TUI (recommended) | 以终端交互界面启动（推荐） | ✅ 基于终端的图形化界面（TUI），无需浏览器✅ 官方推荐，功能完整且轻量✅ 直接在服务器终端操作，适配无图形界面环境 | ✅ 服务器 / 无桌面环境部署✅ 新手快速上手✅ 偏好终端操作 | 低（终端内可视化操作） |
Open the Web UI | 启动 Web 界面 | ✅ 浏览器访问的图形化界面，操作更直观✅ 支持多设备访问（需开放端口） | ✅ 有桌面环境 / 可访问浏览器✅ 希望可视化操作✅ 多设备管理 | 中（需配置端口 / 网络） |
Do this later | 稍后启动 | ✅ 仅完成配置，不启动服务✅ 后续可通过 openclaw hatch 命令手动启动 | ✅ 暂时不需要立即使用✅ 需先配置其他环境（如端口、权限） | 无（仅跳过启动） |
14、web登陆界面：http://127.0.0.1:18789/
二、配置OpenClaw Web UI供外部访问
OpenClaw Web UI默认只能本地访问：127.0.0.1:18789，通过执行ssh -N -L 18789:127.0.0.1:18789 root@192.168.154.133做IP+端口映射，让外部可以访问
-N：只建立连接，不执行远程命令（仅端口转发）；
-L：本地端口映射（格式：本地端口:服务器内网地址:服务器端口）；
root@192.168.154.133：服务器的登录账号 + 公网 IP
SSH 端口转发依赖这个命令窗口，关闭则映射失效；若想后台运行（Linux/Mac），可加 -f 参数，ssh -f -N -L 18789:127.0.0.1:18789 root@192.168.154.133
三、重新配置：可以通过执行openclaw onboard --install-daemon重新启动配置向导
OpenClaw 在启动或重新配置时，对已有配置文件的处理方式选择
选项 | 含义 | 适用场景 |
Use existing values（使用现有值） | 直接加载当前已保存的配置文件，不做任何修改，直接启动或继续流程 | ✅ 配置已完成且无需调整✅ 快速重启服务✅ 确认配置无误后复用 |
Update values（更新值） | 进入配置向导，保留已有配置项，仅允许修改你指定的部分 | ✅ 微调配置（如更换模型、修改工具权限）✅ 不想重新填写全部内容✅ 增量修改 |
Reset（重置） | 清空所有现有配置，恢复到初始状态，重新走完整配置流程 | ✅ 配置混乱 / 出错✅ 想从零开始重新部署✅ 切换到全新使用场景 |
l日常启动 / 无需改配置：保持 Use existing values，最快启动服务。
l需要微调参数：切换到 Update values，只改你需要的部分，避免重复操作。
l配置彻底失效 / 想重来：选择 Reset，清空后重新配置。
四、openclaw常用命令
命令 | 功能 |
openclaw status | 查看 OpenClaw 运行状态 |
openclaw onboard | 重新进入配置向导 |
openclaw gateway start | 启动服务 |
openclaw gateway stop | 停止服务 |
openclaw gateway restart | 重启服务 |
openclaw update | 更新到最新版本 |
openclaw health | 健康检查 |
openclaw doctor | 诊断问题 |
openclaw dashboard | 获取 Web UI 访问链接 |
openclaw security audit --deep | 安全审计 |
openclaw uninstall | 卸载 OpenClaw |
1、openclaw gateway status：服务状态查看
2、openclaw gateway restart/start/stop：服务重启，开始，停止
3、openclaw models list：模型列表
4、openclaw doctor：检查环境是否正常（排查配置/依赖问题）
5、openclaw dashboard：web登陆地址及token
五、OpenClaw 成本说明与免费模型推荐
OpenClaw 本身完全免费开源，主要成本来自两个方面：
服务器成本：一台最低配置的云服务器即可，如果使用 阿里云 OpenClaw 一键部署，可以省去环境配置的时间。
AI 模型 API 调用费用：各模型服务商的免费额度和计费模式不同，以下是常见选择：
模型服务商 | 免费额度 | 适合场景 |
通义千问（Qwen） | 免费额度充足 | 本教程推荐，入门首选 |
小米 MiMo | 有免费试用额度 | 成本敏感用户 |
KIMI (Moonshot) | 有免费额度 | 中文理解能力强 |
GLM 4.7 (Z.AI) | 有免费额度 | 性价比高 |
OpenAI GPT | 付费 | 英文场景最佳 |
Anthropic Claude | 付费 | 代码能力最强 |
对于刚接触 OpenClaw 的用户，建议先用通义千问的免费额度体验，熟练后再根据实际需求选择其他模型。
六、分享已安装配置好QWEN模型的openclaw虚拟机，OS是redhat9.7
链接: https://pan.baidu.com/s/1w7noJnTjF7LtzVm8dePntA?pwd=w7k4 提取码: w7k4
