OpenClaw 基础使用流程（新手极简版）

一份去繁就简的 OpenClaw 开箱指南，只保留最核心、最不踩坑的操作步骤。

🟢 第一步：安装

OpenClaw 基于 Node.js。打开终端，运行：

1	npm install -g openclaw

安装完成后验证：

1 2	openclaw --version # 输出如：OpenClaw 2026.6.10

🔵 第二步：启动聊天

装好后的第一件事：直接聊。OpenClaw 会自动引导你完成模型配置。

1	openclaw chat

第一次运行会进入配置引导，按提示：

Workspace directory → 回车（默认路径）
Configure model/auth now? → 选 Yes
Model/auth provider → 选 More…，手动输入你的模型提供商（如 deepseek）
Enter API key → 粘贴密钥

完成后进入聊天界面，底部状态栏显示：

1	agent main \| deepseek/deepseek-v4-flash \| think high \| tokens 87k/1.0m

🟡 第三步：网页版模式

OpenClaw 也提供了网页版（WebChat），体验更直观：

1	openclaw gateway start

浏览器打开：http://127.0.0.1:18789/

如果想开机自启：

1 2	openclaw gateway install # 安装 systemd 服务 systemctl --user start openclaw-gateway.service

如果配置了语音（Microsoft TTS 等），网页版还支持语音输入和 TTS 朗读。

🟣 第四步：常用斜杠命令

在聊天界面中，以 / 开头的命令：

命令	作用
`/exit`	退出聊天界面
`/clear`	清屏（对话内容还在）
`/auth <provider>`	原地刷新密钥
`/status`	查看当前 session 状态
`/talk`	切换语音模式（需先配置 TTS）

🟠 第五步：用技能扩展能力

OpenClaw 真正的威力在技能系统（Skills）。技能分两类：

内建技能：npm 包自带
插件技能：~/.openclaw/plugin-skills/，社区或自建

安装社区技能

1	npx skills add <作者>/<仓库名>

技能	作用
obsidian-wiki	让 AI 自动维护你的 Obsidian 知识库
frontend-design	UI 设计辅助
nuwa-skill	15+ 人物视角技能（乔布斯、芒格、费曼等）

创建自己的技能

只需一个目录 + 一个 SKILL.md 文件：

1	mkdir -p ~/.openclaw/plugin-skills/my-skill/

# my-skill/SKILL.md

## 技能说明

告诉 AI 在什么场景下触发这个技能。

重启对话即生效，不需要重启 OpenClaw。

🔴 第六步：配置说明

OpenClaw 的配置集中在两个文件：

文件	作用
`~/.openclaw/openclaw.json`	全局配置（模型、代理、插件）
`~/.openclaw/auth-profiles.json`	密钥认证信息

不要手动编辑 openclaw.json 的密钥字段——密钥统一走 auth-profiles.json。

💡 日常工作流

终端 → openclaw chat（或浏览器 WebChat）
↓
开始对话
↓
处理完 → /wiki-update 把知识存入 Obsidian
↓
/exit 退出

⚠️ 常见踩坑

现象	原因	解决
`Too many arguments`	给 `openclaw chat` 传了参数	直接 `openclaw chat`，不加任何参数
密钥无效	过期或没配置	`/auth deepseek` 刷新
网页版打不开	Gateway 没启动	先跑 `openclaw gateway start`
语音报错	TTS 没配	在 `openclaw.json` 的 `messages.tts` 配置

以上就是 OpenClaw 最纯净、最基础的使用流程。祝聊得愉快 🚀