OpenClaw从安装到使用的完整教程(官方脚本版)
南果梨
本教程基于 OpenClaw 官方文档和安装脚本编写，保证准确！
OpenClaw 是什么？
OpenClaw 是一个个人 AI 助手框架，让你可以在本地运行自己的 AI 助手。
它能帮你做什么？
- ✅ 聊天问答（微信、QQ、Telegram、Discord 等）
- ✅ 写文章、写代码
- ✅ 定时提醒
- ✅ 自动化任务
- ✅ 浏览器操作
- ✅ 文件处理
最大的好处：数据在自己电脑上，隐私安全！
一键安装（1 条命令）
打开命令行，复制粘贴以下命令：
curl -fsSL https://openclaw.ai/install.sh | bash
等待安装完成，过程大约 2-5 分钟。
配置向导详细流程
安装完成后，会自动进入配置向导 (openclaw onboard)。
第 1 步：欢迎界面
🦞 Welcome to OpenClaw! This wizard will help you set up your personal AI assistant.
按 Enter 继续。
第 2 步：选择 AI 模型
向导会显示可选的 AI 模型：
Select your AI provider: ○ OpenAI (GPT-4) ● Dashscope (通义千问) ← 推荐国内用户 ○ Anthropic (Claude) ○ Google (Gemini) ○ Skip for now
操作方法：
- 用
↑↓方向键选择 - 按
Enter确认
模型推荐：
- 国内用户：选 Dashscope（通义千问），速度快，便宜
- 有 OpenAI：选 OpenAI，模型最强
- 有 Claude：选 Anthropic，长文本厉害
第 3 步：填写 API Key
选择模型后，输入 API Key：
Enter your Dashscope API Key: > sk-____________________
如何获取 API Key？
通义千问（Dashscope）：
- 访问：dashscope.console.aliyun.com/
- 登录阿里云账号（没有就注册一个）
- 点击左侧"API Key 管理"
- 点击"创建新的 API Key"
- 复制生成的 Key（以
sk-开头） - 粘贴到向导里
OpenAI：
- 访问：platform.openai.com/
- 登录或注册
- 点击左侧"API Keys"
- 点击"Create new secret key"
- 复制 Key（以
sk-proj-或sk-开头）
Claude（Anthropic）：
- 访问：console.anthropic.com/
- 登录或注册
- 点击"Get API keys"
- 点击"Create key"
- 复制 Key（以
sk-ant-开头）
第 4 步：测试连接
向导会测试 API Key 是否有效：
Testing connection to Dashscope... ✅ Connection successful! Model: qwen-max Credits remaining: ¥100.00
如果失败，会提示你重新输入。
第 5 步：选择连接平台
向导会问你要连接哪些聊天平台：
Select platforms to connect: ○ WhatsApp ○ Telegram ○ Discord ○ Slack ○ WeChat (微信) ○ QQ ○ Skip for now ← 新手建议先选这个
新手建议：
- 先选
Skip for now（跳过） - 等 OpenClaw 运行正常后再配置平台
- 配置平台需要额外的 Bot ID 或 Token
后续配置： 运行 openclaw channels add 可以添加平台
第 6 步：安装后台服务
向导会问是否安装后台服务（开机自启）：
Install Gateway daemon? This will start OpenClaw automatically on boot. ● Yes (recommended) ○ No
建议：
- 选
Yes：OpenClaw 会一直运行，随时可用 - 选
No：每次需要手动运行openclaw gateway
后台服务类型：
- macOS：launchd
- Linux：systemd
- Windows：WSL2 或手动运行
第 7 步：配置工作目录
向导会设置工作目录：
Workspace location: > /Users/你的用户名/.openclaw/workspace Change location? (y/N)
建议：
- 直接按
Enter使用默认位置 - 如果需要改，输入
y然后输入新路径
工作目录用途：
- 存放你的脚本
- 存放技能文件
- 存放记忆文件
第 8 步：完成配置
最后，向导会显示总结：
🎉 Setup complete! Configuration summary: • AI Provider: Dashscope (qwen-max) • Workspace: ~/.openclaw/workspace • Gateway: Running (port 18789) • Channels: None (add later with `openclaw channels add`) What's next? • Chat: openclaw agent --message "Hello" • Send message: openclaw message send --to xxx --message "Hi" • Add channel: openclaw channels add • View docs: openclaw docs
按 Enter 完成配置。
安装完成
配置完成后，你会看到：
🦞 OpenClaw installed successfully! ✅ Gateway started on port 18789 🤖 AI assistant ready
使用教程
1. 和 AI 对话
最简单的方式：
openclaw agent --message "你好"
带思考等级：
# 快速回答 openclaw agent --message "1+1 等于几" --thinking low # 深度思考 openclaw agent --message "帮我写个 Python 脚本" --thinking high # 最高思考等级（最贵但最聪明） openclaw agent --message "分析这个项目的架构" --thinking ultra
连续对话：
openclaw agent # 进入交互模式，可以一直聊天 # 输入 exit 退出
2. 发送消息
发送测试消息：
openclaw message send --message "Hello from OpenClaw"
发送到指定平台：
# Telegram openclaw message send --to telegram:@username --message "Hi" # Discord openclaw message send --to discord:channel_id --message "Hi" # 微信（需要配置） openclaw message send --to wechat:username --message "Hi"
3. WebUI 聊天（推荐新手）
OpenClaw 提供网页版聊天界面（Control UI），比命令行更直观！
方法 1：运行 dashboard 命令
openclaw dashboard
这会自动在浏览器打开控制面板。
方法 2：手动访问
- 确保网关已启动：
openclaw gateway - 打开浏览器
- 访问：http://127.0.0.1:18789/
步骤 3：开始聊天
在网页中：
- 看到聊天界面
- 在输入框输入消息
- 按
Enter或点击发送 - AI 会立即回复
WebUI 功能：
- ✅ 实时对话（类似 ChatGPT 界面）
- ✅ 查看对话历史
- ✅ 切换模型
- ✅ 调整思考等级
- ✅ 导出聊天记录
远程访问（从其他设备访问）：
openclaw ui --host 0.0.0.0 --port 3000
然后在其他设备访问：http://服务器IP:3000
4. 管理技能（Skills）
查看已安装的技能：
openclaw skills list
安装新技能：
openclaw skills install <技能名>
启用/禁用技能：
openclaw skills enable <技能名> openclaw skills disable <技能名>
更新技能：
openclaw skills update
4. 管理扩展（Extensions）
查看已安装的扩展：
openclaw extensions list
安装扩展：
openclaw extensions install <扩展名>
5. 管理通道（Channels）
查看已连接的通道：
openclaw channels list
添加新通道：
openclaw channels add # 跟着向导选择平台并配置
移除通道：
openclaw channels remove <通道名>
调试和排错
1. 查看状态
查看整体状态：
openclaw status
输出示例：
OpenClaw Status =============== Gateway: Running ✓ Port: 18789 Model: qwen-max Channels: 0 Skills: 5 Uptime: 2h 30m
2. 查看日志
查看最近的日志：
openclaw logs
实时查看日志：
openclaw logs --follow # 按 Ctrl+C 退出
查看特定级别的日志：
# 只看错误 openclaw logs --level error # 只看警告 openclaw logs --level warn # 详细模式 openclaw logs --level debug
查看特定时间的日志：
# 最近 1 小时 openclaw logs --since 1h # 最近 100 行 openclaw logs --tail 100
3. 运行医生检查
自动检查问题：
openclaw doctor
输出示例：
OpenClaw Doctor =============== ✓ Gateway is running ✓ Configuration is valid ✓ API key is valid ✓ Network connection OK ✓ Node.js version OK (v22.x.x) ⚠ No channels configured (run: openclaw channels add) 1 warning found.
非交互模式（适合脚本）：
openclaw doctor --non-interactive
4. 重启服务
重启网关：
openclaw gateway restart
停止网关：
openclaw gateway stop
启动网关：
openclaw gateway start
5. 常见问题排查
问题 1：AI 不回复
检查步骤：
# 1. 检查网关状态 openclaw status # 2. 检查 API Key openclaw doctor # 3. 查看日志 openclaw logs --level error # 4. 测试连接 openclaw agent --message "test"
问题 2：消息发送失败
检查步骤：
# 1. 检查通道配置 openclaw channels list # 2. 检查通道状态 openclaw channels status <通道名> # 3. 查看通道日志 openclaw logs --grep <通道名>
问题 3：技能不工作
检查步骤：
# 1. 查看已安装技能 openclaw skills list # 2. 检查技能是否启用 openclaw skills status <技能名> # 3. 更新技能 openclaw skills update <技能名> # 4. 重新安装技能 openclaw skills reinstall <技能名>
完整命令参考
基础命令
| 命令 | 说明 | 示例 |
|---|---|---|
openclaw status | 查看状态 | openclaw status |
openclaw doctor | 检查问题 | openclaw doctor |
openclaw logs | 查看日志 | openclaw logs --follow |
openclaw version | 查看版本 | openclaw version |
openclaw help | 查看帮助 | openclaw help |
网关命令
| 命令 | 说明 | 示例 |
|---|---|---|
openclaw gateway | 启动网关 | openclaw gateway --port 18789 |
openclaw gateway start | 启动 | openclaw gateway start |
openclaw gateway stop | 停止 | openclaw gateway stop |
openclaw gateway restart | 重启 | openclaw gateway restart |
AI 对话命令
| 命令 | 说明 | 示例 |
|---|---|---|
openclaw agent | 和 AI 对话 | openclaw agent --message "你好" |
openclaw chat | 交互模式 | openclaw chat |
agent 命令参数：
--message "文本"：发送的消息--thinking low|medium|high|ultra：思考等级--deliver <平台>：发送到指定平台
消息命令
| 命令 | 说明 | 示例 |
|---|---|---|
openclaw message send | 发送消息 | openclaw message send --to xxx --message "Hi" |
openclaw message broadcast | 群发消息 | openclaw message broadcast --message "通知" |
配置命令
| 命令 | 说明 | 示例 |
|---|---|---|
openclaw onboard | 配置向导 | openclaw onboard |
openclaw config | 编辑配置 | openclaw config edit |
openclaw config show | 查看配置 | openclaw config show |
技能命令
| 命令 | 说明 | 示例 |
|---|---|---|
openclaw skills list | 列出技能 | openclaw skills list |
openclaw skills install | 安装技能 | openclaw skills install weather |
openclaw skills enable | 启用技能 | openclaw skills enable weather |
openclaw skills disable | 禁用技能 | openclaw skills disable weather |
openclaw skills update | 更新技能 | openclaw skills update |
openclaw skills uninstall | 卸载技能 | openclaw skills uninstall weather |
扩展命令
| 命令 | 说明 | 示例 |
|---|---|---|
openclaw extensions list | 列出扩展 | openclaw extensions list |
openclaw extensions install | 安装扩展 | openclaw extensions install qqbot |
openclaw extensions update | 更新扩展 | openclaw extensions update |
通道命令
| 命令 | 说明 | 示例 |
|---|---|---|
openclaw channels list | 列出通道 | openclaw channels list |
openclaw channels add | 添加通道 | openclaw channels add |
openclaw channels remove | 移除通道 | openclaw channels remove telegram |
openclaw channels status | 查看状态 | openclaw channels status telegram |
更新命令
| 命令 | 说明 | 示例 |
|---|---|---|
openclaw update | 更新 | openclaw update |
openclaw update --channel | 切换版本 | openclaw update --channel beta |
版本通道：
stable：稳定版（推荐）beta：测试版dev：开发版
重要文件位置
| 内容 | 位置 | 说明 |
|---|---|---|
| 配置文件 | ~/.openclaw/openclaw.json | AI 模型、平台配置 |
| 日志文件 | ~/.openclaw/logs/ | 运行日志 |
| 工作目录 | ~/.openclaw/workspace/ | 你的文件和脚本 |
| 技能目录 | ~/.openclaw/skills/ | 安装的技能 |
| 扩展目录 | ~/.openclaw/extensions/ | 安装的扩展 |
| 记忆文件 | ~/.openclaw/memory/ | 对话历史 |
快速打开配置文件夹：
Windows：
explorer %USERPROFILE%\.openclaw
Mac：
open ~/.openclaw
Linux：
cd ~/.openclaw
常见问题
1. 如何卸载？
# 1. 停止服务 openclaw gateway stop # 2. 卸载 OpenClaw npm uninstall -g openclaw # 3. 删除配置（可选） rm -rf ~/.openclaw
2. 如何备份配置？
# 备份整个配置目录 cp -r ~/.openclaw ~/.openclaw.backup # 或只备份配置文件 cp ~/.openclaw/openclaw.json ~/backup/
3. 如何迁移到另一台电脑？
# 1. 在新电脑安装 OpenClaw curl -fsSL https://openclaw.ai/install.sh | bash # 2. 复制配置文件 cp ~/.openclaw/openclaw.json 新电脑:~/.openclaw/ # 3. 重启服务 openclaw gateway restart
4. 如何查看 API 使用量？
# 通义千问 openclaw usage # 或访问控制台 # https://dashscope.console.aliyun.com/usage
5. 如何切换 AI 模型？
# 方法 1：重新运行配置向导 openclaw onboard # 方法 2：手动编辑配置 openclaw config edit # 修改 model.provider 和 model.apiKey
6. 如何在后台运行？
# macOS/Linux openclaw gateway --daemon # Windows（PowerShell） Start-Process openclaw gateway -WindowStyle Hidden
总结
安装（1 条命令）
curl -fsSL https://openclaw.ai/install.sh | bash
配置（跟着向导走）
openclaw onboard # 安装后自动启动
使用（常用命令）
# 查看状态 openclaw status # 和 AI 对话 openclaw agent --message "你好" # 查看日志 openclaw logs # 检查问题 openclaw doctor
学习路径
- ✅ 安装完成
- ✅ 运行
openclaw agent测试对话 - ✅ 配置一个聊天通道（如 Telegram）
- ✅ 安装几个实用技能
- ✅ 探索自动化功能
总耗时：15-30 分钟
以上就是OpenClaw从安装到使用的完整教程(官方脚本版)的详细内容，更多关于OpenClaw安装到使用的教程的资料请关注脚本之家其它相关文章！