OpenClaw 使用方法(2026 最新版)

OpenClaw 是本地运行、可执行任务的开源 AI 助手，能操作文件、浏览器、终端、邮件等，数据全在本地。下面是完整安装 + 配置 + 使用流程。

一、安装（3 种方式，新手选一键）

1. 一键脚本（推荐）

• Windows（管理员 PowerShell）
iwr -useb https://openclaw.ai/install.ps1 | iex
• macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash
2. npm/pnpm 全局安装（需 Node.js ≥22）
pnpm add -g openclaw@latest
# 或
npm i -g openclaw@latest
3. 源码安装（开发者）
git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git
cd openclaw-cn
pnpm config set registry https://registry.npmmirror.com
pnpm install
pnpm run build
npm link
二、初始化配置（关键）

执行向导（自动配置模型、渠道、技能）：
openclaw onboard --install-daemon
（--install-daemon 让它后台常驻、开机自启）

向导步骤：

1. 工作空间（默认即可）

2. 选择 AI 模型（新手选 OpenAI / Claude；本地用 Ollama）

3. 输入 API Key

4. 连接聊天渠道（推荐 Telegram）

5. 安装基础技能（文件、网页、邮件等）

三、连接聊天渠道（以 Telegram 为例）

1. Telegram 搜 @BotFather → /newbot → 起名 → 得到 Bot Token

2. 写入配置 openclaw.yaml：
channels:
telegram:
enabled: true
botToken: "你的Token"
dmPolicy: pairing
3. 重启网关：openclaw gateway restart

4. 给 Bot 发消息 → 输入配对码 → 开始使用

四、常用命令（CLI）
openclaw dashboard # 打开 Web 控制面板
openclaw gateway status # 查看运行状态
openclaw skills list # 查看已装技能
openclaw skills search 关键词 # 搜技能
openclaw skills install 技能名 # 装技能
openclaw channels list # 查看已连渠道
五、日常使用（自然语言即可）

直接在 Telegram / Web 面板发指令，例如：

• “整理桌面所有图片到 Pictures 文件夹”

• “搜索 OpenClaw 最新教程并保存 PDF”

• “发邮件给 xxx，主题 xxx，内容 xxx”

• “帮我写一段 Python 爬虫代码”

六、常用聊天指令
/reset # 重置会话
/context list # 查看上下文
/verbose on # 显示详细执行过程
/restart # 重启网关
七、常见问题

• 安装失败：确保 Node.js ≥22，Windows 用管理员 PowerShell

• 连不上模型：检查 API Key 与网络

• 后台不运行：重新执行 openclaw onboard --install-daemon

下面给你一份可直接复制、开箱即用的 OpenClaw 配置文件（openclaw.yaml），适配 Telegram + OpenAI（GPT‑4o），你只需要替换两处密钥即可。

openclaw.yaml（完整可用版）
# OpenClaw 主配置（Telegram + OpenAI GPT‑4o）
workspace: ~/.openclaw/workspace
logLevel: info

# AI 模型配置（OpenAI）
models:
default:
provider: openai
apiKey: "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" # 替换成你的 OpenAI Key
model: gpt-4o
temperature: 0.1
maxTokens: 4096

# 聊天渠道（Telegram）
channels:
telegram:
enabled: true
botToken: "123456789:ABCdefGhIJKlmNoPQRstUvWxYz123456789" # 替换成你的 Bot Token
dmPolicy: pairing
allowedUsers: []
webhook: false

# 技能（自动启用常用能力）
skills:
enabled:
- file
- browser
- terminal
- websearch
- email
- schedule
- code
- system

# 后台守护（开机自启）
daemon:
enabled: true
autoStart: true

# 安全（本地执行，不外传数据）
security:
sandbox: true
confirmBeforeAction: false
allowNetwork: true
使用步骤（复制即用）

1. 打开 OpenClaw 配置目录：

◦ Windows：C:\Users\用户名\.openclaw\openclaw.yaml

◦ macOS/Linux：~/.openclaw/openclaw.yaml

2. 把上面内容全部粘贴进去。

3. 替换两处密钥：

◦ apiKey：你的 OpenAI API Key

◦ botToken：你在 @BotFather 拿到的 Telegram Bot Token

4. 重启网关：
openclaw gateway restart
5. 给你的 Telegram Bot 发消息 → 输入配对码 → 即可开始用。

常用指令（直接发）

• 帮我整理桌面文件

• 打开 Chrome 搜索 xxx

• 写一段 Python 代码

• 帮我发邮件给 xxx

• 查看系统信息