最新OpenClaw使用手册：安装、卸载命令、换大模型等，新手也能上手

大家好，我是星哥。这段时间好多朋友问我 OpenClaw 怎么装、怎么用、怎么换模型、怎么接 和 Telegram，我干脆把自己踩过的坑、试过的方案，从头到尾整理成这份最全手册。

从一键安装、常用命令，到大模型切换、配置文件、故障排查，我都写得明明白白，新手跟着敲命令就能跑起来，老手也能直接拿去做定制部署。不管是服务器、还是 Windows 本地，看完这篇，OpenClaw 你就能彻底玩明白。

本文是openclaw写文档，星哥做了一些修改。

如何使用openclaw，openclaw的常用命令，更换大模型的方式，整理最全的文档，放到 /root/openclaw.md 文档中

核心特点

• • 自托管：在你的硬件上运行，按你的规则
• • 多渠道：一个网关同时服务 WhatsApp、Telegram、Discord 等
• • 智能体原生：专为编程智能体设计，支持工具使用、会话、记忆和多智能体路由
• • 开源：MIT 许可证，社区驱动

工作原理

星哥之前写的文章。

• • 云服务器部署OpenClaw：轻量应用服务器+钉钉和机器人
• • 宝塔面板一键部署OpenClaw，支持、飞书机器人
• • Windows 11系统OpenClaw安装教程

官方命令安装

手动安装

指定淘宝镜像源安装openclaw（强烈建议）

指定 npm 安装源为「淘宝 npm 镜像源」（国内常用），默认的 npm 官方源（registry.npmjs.org）在国内访问可能慢或不稳定，换这个源能提升安装速度和成功率。

把npm的源，永久改成淘宝 npm 镜像源（非必要操作）

使用国内源可以大大提高npm的下载速度。

查看npm源：

设置为淘宝 npm 镜像源

或使用配置向导：

1. 配对频道（以 WhatsApp 为例）

2. 启动网关

3. 打开控制面板

浏览器访问：http://127.0.0.1:18789

全局标志

• • ：隔离状态到 并切换默认端口
• • ：隔离状态到
• • ：禁用 ANSI 颜色
• • ： 的简写
• • ：打印版本并退出

设置和配置

网关管理

频道管理

添加频道

模型管理

身份验证

会话管理

智能体管理

节点管理（移动设备）

浏览器控制

 openclaw 安装 

技能和插件

记忆管理

定时任务（Cron）

给它一个命令” 5分钟之后，提醒我喝水”

诊断和维护

终端 UI

文档搜索

方式一：通过配置向导

选择模型配置选项，按提示完成。

方式二：直接设置模型

方式三：编辑配置文件

编辑 ：

方式四：使用 onboard 非交互式配置

支持的模型提供商

• • OpenAI – GPT 系列（API + Codex）
• • Anthropic – Claude 系列（API + Claude Code CLI）
• • Moonshot AI – Kimi + Kimi Coding
• • Mistral – Mistral 系列
• • OpenRouter – 统一接口访问多个模型
• • Vercel AI Gateway – 统一网关
• • Cloudflare AI Gateway – 边缘 AI 网关
• • GLM – 智谱 AI 模型
• • MiniMax – MiniMax 模型
• • Qwen – 通义千问（OAuth）
• • Qianfan – 百度千帆
• • Venice – 隐私优先的 AI
• • Z.AI – 字节跳动
• • OpenCode Zen
• • Kilocode
• • Amazon Bedrock – AWS 托管模型
• • Together AI
• • Ollama – 本地模型
• • vLLM – 本地模型服务
• • NVIDIA
• • Hugging Face
• • Xiaomi

聊天中切换模型

在聊天中发送：

或使用别名（如果已配置）：

配置文件位置：

OpenClaw 使用 JSON5 格式，支持注释和尾随逗号。

最小配置示例

完整配置示例

配置热重载

Gateway 会监听配置文件变化并自动应用，无需手动重启。

使用 $include 拆分配置

环境变量替换

在配置中使用 引用环境变量：

SecretRef（高级）

支持从环境变量、文件或执行命令获取密钥：

DM 访问策略

每个频道通过 控制 DM 访问：

• • (默认)：未知发送者获得一次性配对码以批准
• • ：仅允许 中的发送者
• • ：允许所有入站 DM（需要 ）
• • ：忽略所有 DM

群聊提及门控

诊断命令

某个微信群中看到的，自己试试看看

亲测如图：

常见问题

Gateway 无法启动

• • 检查配置验证：
• • 查看日志：
• • 运行诊断：

频道连接问题

• • 检查频道状态：
• • 查看频道日志：
• • 重新登录：

模型问题

• • 检查模型状态：
• • 验证认证：

连接问题

• • 探测网关：
• • 检查健康：
• • 发现网关：

SSH 远程访问

打开终端（PowerShell 或 CMD），直接运行：

npm卸载

本文是OpenClaw 自托管多渠道 AI 智能体网关的完整使用指南，覆盖从安装、基础使用到高级配置的全流程。文档详细说明官方、手动、国内镜像三种安装方式，整理网关、频道、模型、智能体等百余条常用命令，提供四种更换大模型的方法，并详解配置文件、频道权限、故障排查与卸载步骤。同时补充 等国内渠道配置、安全体检、定时任务等实用功能，适配新手快速上手与进阶用户定制需求，可直接作为部署与运维参考手册。

本文档基于 OpenClaw 最新版本整理，如有更新请参考官方文档。