夜雨聆风
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
• 查看系统信息