OpenClaw 用户部署和使用指南汇总 (2026年2月版)
OpenClaw (原名 MoltBot / ClawdBot) 是一款开源的、本地优先的 AI 代理框架。它最大的特点是“把云端大模型的能力变成你电脑上的一个系统级员工”，能通过自然语言操作你的文件、浏览器、终端，甚至 7x24 小时帮你处理消息。
本文档为你汇总了从零基础部署到高阶使用的全链路指南。
一、 核心部署方案（三选一）
http://dd.0508.top/pyyRAfsfz
http://dd.0508.top/lRAdQborV
http://dd.0508.top/mviLeiCjB
http://dd.0508.top/ZownDsdNN
http://dd.0508.top/vWEgIRRQl
http://dd.0508.top/jbrXmfOvf
http://dd.0508.top/pPOEhKzbx
http://dd.0508.top/sQnJxdYyA
http://dd.0508.top/oHLGcQQzd
http://dd.0508.top/LsxOWmbUs
http://dd.0508.top/OjIaVgEby
http://dd.0508.top/RLUIUNTCm
http://dd.0508.top/HmkLMFgTj
http://dd.0508.top/qwlLpWVBV
http://dd.0508.top/HLspsTviD
http://dd.0508.top/RboWlNfOs
http://dd.0508.top/sEEZzWSMP
http://dd.0508.top/XYAuSwTBW
http://dd.0508.top/EPFIsXlzx
http://dd.0508.top/mZAdtowzK
http://dd.0508.top/rvXiKujCJ
http://dd.0508.top/SRSskNRyW
http://dd.0508.top/EUEIJSzXN
http://dd.0508.top/WdxaQrPVV
http://dd.0508.top/eTeXgtiAN
http://dd.0508.top/kzVMgsqFC
http://dd.0508.top/VcKihnHbO
http://dd.0508.top/VhIXlBieR
http://dd.0508.top/bayFiTmjo
http://dd.0508.top/HBljaMqeB
http://dd.0508.top/YOaKuGHMq
http://dd.0508.top/EQdGAYPwX
http://dd.0508.top/pGrjtyZpm
http://dd.0508.top/XwcZucqnX
http://dd.0508.top/cebAPpSuF
http://dd.0508.top/umIEPAOmo
http://dd.0508.top/yMqYtckOR
http://dd.0508.top/iWgoTeyFw
http://dd.0508.top/SceMLupjY
http://dd.0508.top/OKmiaXGlV
http://dd.0508.top/GZjRRbAXA
http://dd.0508.top/WthyPOVmw
http://dd.0508.top/ZMxxDESNl
http://dd.0508.top/AKaQeJvLG
http://dd.0508.top/TpMkXfQIm
http://dd.0508.top/fKItTnWDO
http://dd.0508.top/oAtLEvYQe
http://dd.0508.top/SegvuzfTH
http://dd.0508.top/eQRKszJeH
根据你的设备和技术背景，选择最适合的路径。
方案 适用人群 核心步骤 关键优势
阿里云轻量服务器（推荐新手） 不想折腾本地环境、需要公网访问、国内用户 1. 购买“OpenClaw”应用镜像
2. 控制台一键配置百炼API
3. 生成Token访问Web页面 无需懂Linux，自带国内网络优化，支持钉钉/飞书本地一键脚本（推荐Mac/Linux） 开发者、有本地算力需求、注重隐私 1. 安装 Node.js 22+
2. 执行 curl -fsSL https://openclaw.ai/install.sh | bash
3. 运行 openclaw onboard 数据完全留在本地，响应速度最快，权限最高Windows WSL2 Windows 用户 1. 启用 WSL2 并安装 Ubuntu
2. 在 WSL 中执行上述“本地脚本” 避免原生 Windows 的兼容性坑
⚠️ 安全红线：如果你选择本地部署，绝对不要将 Gateway 端口（默认 18789）暴露在公网（即不要使用 --bind lan 或 --bind tailnet 除非你懂防火墙），否则你的电脑文件可能被黑客通过 AI 指令清空。
二、 环境配置与模型接入
部署完成后，核心是让 OpenClaw 能“思考”。它本身不包含模型，需要你提供“大脑”。
- 模型提供商选择（配置 API Key）
提供商 推荐模型 配置命令/位置 特点
阿里云百炼 (国内首选) qwen-max / qwen-plus 阿里云控制台“应用详情”页一键填入 无需翻墙，速度极快，价格便宜（新用户有额度）
Anthropic (Claude) claude-3-5-sonnet openclaw configure --section models 逻辑能力强，适合复杂推理
OpenAI gpt-4o openclaw configure --section models 通用性最好，插件生态丰富
本地模型 (Ollama) llama3.2 / qwen2.5 设置 base_url: http://localhost:11434/v1 完全免费、断网可用，但能力较弱
- 初始化向导（Onboarding）
首次安装后，必须运行引导命令。它会帮你设置工作空间、安全策略和默认频道。
启动交互式配置向导（最重要的一步）
openclaw onboard
如果卡住或报错，可以跳过向导，直接设置模型
openclaw configure --section models
三、 使用方式与核心命令
OpenClaw 支持多种交互前端，你可以把它当成一个在后台运行的“服务”。
- 三种交互界面
界面 启动命令 适用场景
Web 控制台 (Control UI) openclaw dashboard 或访问 http://127.0.0.1:18789 本地调试、查看日志、文件管理（最常用）
即时通讯 App openclaw channels add (选 WhatsApp/Telegram) 移动办公、7x24 待命、群聊管理
终端 CLI openclaw agent --message "你好" 脚本集成、自动化流水线
- 常用 CLI 命令速查
1. 服务管理（Gateway 是心脏）
openclaw gateway status # 查看状态
openclaw gateway restart # 重启服务（修改配置后必执行）
openclaw gateway --port 19000 --verbose # 指定端口并看日志
2. 模型管理
openclaw models list # 列出所有配置的模型
openclaw models set gpt-4o # 切换默认模型
openclaw models auth # 管理 API 密钥
3. 会话与记忆
openclaw sessions # 查看所有对话会话（占用 Token 情况）
openclaw memory search "关键词" # 从历史记忆中搜索
openclaw health # 系统健康检查（医生模式）
4. 直接让 AI 执行命令并返回结果（超实用）
openclaw agent --message "请用 curl 查询我的公网 IP 并告诉我"
- 聊天中的斜杠命令（Slash Commands）
在 Web 界面或 WhatsApp 聊天窗口中，输入这些命令直接控制 AI：
命令 功能 示例
/new 开启一个新对话（清空上下文） /new
/status 查看 AI 的运行状态和资源 /status
/thinking 设置思考深度 /thinking deep (想久一点)
/model 切换模型 /model claude-3-5-sonnet
/help 显示帮助 /help
四、 技能（Skills）与实战场景
OpenClaw 的强大在于它的“技能”（Skills），即允许 AI 调用你的电脑工具。
- 内置核心技能（开箱即用）
• 文件系统 (Filesystem)：AI 可以读取、创建、修改、删除你工作目录下的任何文件。
• 终端 (Shell)：AI 可以执行 ls, grep, git 等命令（高危，需谨慎授权）。
• 浏览器 (Browser)：AI 可以打开网页、截图、填写表单（需配合 chromium）。
• 计算机控制 (Computer Control)：AI 可以模拟键盘鼠标（仅限本地 UI 模式）。
- 如何安装社区技能（Plugins）
安装技能包（例如联网搜索）
clawhub install searxng
安装后需要在 config.yaml 中启用
或者通过 UI 的 Skills 页面点击启用
- 典型工作流指令示例
任务 你对 OpenClaw 说的话（自然语言）
整理下载文件夹 “请查看 ~/Downloads 目录，把所有图片移动到 Pictures 文件夹，并按日期创建子文件夹。”
写周报 “读取我本周的 Git 提交记录和日历事件，生成一份 Markdown 格式的周报，保存为 weekly.md。”
监控服务器 “每隔 1 小时执行 df -h 命令，如果磁盘使用率超过 90%，就发消息到 Telegram 提醒我。”
处理邮件 “扫描我的收件箱，找出所有来自 ‘boss@company.com’ 且包含 ‘urgent’ 的邮件，总结要点并回复‘已收到，正在处理’。”
五、 高频问题（FAQ）与排错
- 安装类问题
现象 原因与解决
npm install 卡住或报错 网络问题。请使用国内镜像源：npm config set registry https://registry.npmmirror.com
Windows 提示“openclaw 不是命令” 未正确配置 WSL2 环境变量，或未在 WSL 的 Ubuntu 终端中执行命令。
Error: Node version < 22 OpenClaw 强制要求 Node.js 22 或更高版本，请卸载旧版重装。
- 运行类问题
现象 原因与解决
Web 页面打不开 (ERR_CONNECTION_REFUSED) Gateway 服务没启动。执行 openclaw gateway restart。
AI 回复“I can't help with that” 权限不足。在 Web UI 的右上角点击“权限开关”，为当前会话授权“文件读写”或“Shell 执行”。
消息发出去没反应（Channel 显示 Disconnected） 频道（如 WhatsApp）掉线。执行 openclaw channels login 重新扫码配对。
调用模型超时 (Timeout) API Key 错误、余额不足或网络不通。执行 openclaw health 检测模型连通性。
- 安全警告
• 不要给 AI 管理员 (root/sudo) 权限：在 onboarding 时，工作空间应设置为用户目录（如 ~/workspace），而非系统根目录。
• 谨慎使用 shell 技能：除非你完全信任当前的对话，否则不要轻易点击“允许执行 Shell”，尤其是 rm -rf 或格式化的指令。
• 备份 ~/.openclaw 目录：这里存放了你的所有配置和记忆，定期备份以防配置文件损坏。
