夜雨聆风OpenClaw 界面全解读,每个按钮都有用
核心问题:界面上的东西都是干嘛的?全面解读OpenClaw界面布局、配置文件详解、权限管理机制和日志排查方法，帮助用户深入了解工具配置与问题诊断，适合需要精细控制OpenClaw的用户。
系列教程第 7 篇 | 阅读时长:8-10 分钟
从陌生到熟悉
打开 OpenClaw,你可能会看到这样的界面:
┌─────────────────────────────────────────────────────┐│ OpenClaw [设置] [帮助] │├──────────────┬──────────────────────────────────────┤│ │ ││ 技能列表 │ 主工作区 ││ │ ││ ├ pdf │ [输入框:描述你的任务...] ││ ├ xlsx │ ││ ├ pptx │ ───────────────────────────── ││ └ browser │ ││ │ 执行结果 ││ │ │├──────────────┴──────────────────────────────────────┤│ 日志输出 ││ [2026-03-11 14:30] 任务开始: pdf extract ││ [2026-03-11 14:30] 读取文件: report.pdf ││ [2026-03-11 14:30] ✓ 任务完成 │└─────────────────────────────────────────────────────┘这一篇,我们逐一解读每个区域和按钮的作用。
一、主界面布局:任务区、技能区、日志区
OpenClaw 界面分为三个主要区域:
1. 左侧:技能区
功能:展示已安装的技能列表
包含内容:
• 技能名称 • 技能状态(启用/禁用) • 快速操作按钮
常用操作:
• 点击技能:查看技能详情 • 右键技能:启用/禁用/卸载 • 搜索框:快速查找技能
2. 中间:任务区(主工作区)
功能:任务输入和结果展示
包含内容:
• 输入框:描述你的任务 • 执行结果:显示任务输出 • 操作按钮:运行、停止、导出
工作流程:
输入任务 → 智能体理解 → 调用技能 → 执行操作 → 展示结果3. 底部:日志区
功能:记录任务执行过程
日志级别:
• INFO:常规信息(任务开始、完成)• WARNING:警告(非致命问题)• ERROR:错误(任务失败)• DEBUG:调试信息(详细执行过程)
用途:
• 任务失败时排查问题 • 了解执行细节 • 性能分析
二、配置文件详解:config.json 各字段含义
OpenClaw 的核心配置文件位于 ~/.openclaw/config.json。
完整配置示例
{ "version": "1.0", "model": { "provider": "openai", "model": "gpt-4", "api_key": "sk-xxx", "base_url": "https://api.openai.com/v1", "temperature": 0.7, "max_tokens": 2000 }, "skills": [ { "name": "pdf", "version": "latest", "enabled":true }, { "name": "xlsx", "version": "1.1.5", "enabled":true } ], "permissions": { "file_access": ["~/Documents", "~/Downloads"], "network_access":true, "execute_commands":false }, "storage": { "data_dir": "~/.openclaw/data", "cache_dir": "~/.openclaw/cache", "log_dir": "~/.openclaw/logs" }, "ui": { "theme": "light", "language": "zh-CN", "show_notifications":true }}字段详解
1. model 配置
2. skills 配置
3. permissions 配置
⚠️ 安全提示:谨慎开放
execute_commands权限,可能导致安全风险
4. storage 配置
5. ui 配置
三、权限管理:给技能正确的"通行证"
为什么需要权限管理?
技能在执行任务时,可能需要:
• 访问文件系统 • 连接网络 • 执行系统命令
如果无限制,可能带来安全风险。权限管理就是给技能"最小必要权限"。
权限类型
如何配置权限
方式一:全局配置
在 config.json 中设置:
{ "permissions": { "file_access": ["~/Documents", "~/Downloads"], "network_access":true, "execute_commands":false }}方式二:技能级配置
某些技能可能需要特殊权限,安装时会提示:
openclaw skill install browser输出:
⚠ 技能 browser 需要以下权限: - 网络访问:访问网页 - 文件写入:保存截图、下载文件是否同意? (y/n)输入 y 后,权限会被记录到技能配置中。
查看技能权限
openclaw skill permissions browser输出:
技能: browser─────────────────────────────权限列表: ✓ 文件读取:~/Downloads ✓ 文件写入:~/Downloads ✓ 网络访问:所有网站 ✗ 命令执行:未授权四、日志查看:任务失败了怎么排查
当任务执行失败时,日志是最好的排查工具。
查看实时日志
在界面底部日志区,或命令行:
openclaw logs follow实时输出任务执行过程。
查看历史日志
# 查看最近 100 行openclaw logs show --lines 100# 查看特定时间段openclaw logs show --since "2026-03-11 14:00" --until "2026-03-11 15:00"# 只看错误日志openclaw logs show --level ERROR日志文件位置
日志保存在 ~/.openclaw/logs/ 目录:
~/.openclaw/logs/├── openclaw.log # 主日志├── tasks.log # 任务日志├── skills.log # 技能日志└── errors.log # 错误日志典型排查流程
场景:任务执行失败
1. 查看错误信息:
openclaw logs show --level ERROR --lines 10输出:
[ERROR] 2026-03-11 14:35:12 - pdf.extract文件不存在: ~/Documents/reprot.pdf(你是否想访问 report.pdf?)2. 根据提示修正:
原来是文件名拼写错误:reprot.pdf → report.pdf
3. 重新执行任务。
五、常用快捷操作
界面快捷键
Ctrl/Cmd + N | |
Ctrl/Cmd + Enter | |
Ctrl/Cmd + S | |
Ctrl/Cmd + L | |
Ctrl/Cmd + , | |
Ctrl/Cmd + Q |
命令行快捷命令
# 快速执行任务openclaw run <skill> <command># 快速查看帮助openclaw help <skill># 快速安装技能openclaw install <skill># 快速查看状态openclaw status小结
这一篇,你学会了:
1. ✅ 主界面三大区域:技能区、任务区、日志区 2. ✅ 配置文件各字段含义 3. ✅ 权限管理的原理和配置方法 4. ✅ 通过日志排查问题 5. ✅ 常用快捷键和命令
现在,你已经熟悉 OpenClaw 的界面和配置,可以更自如地使用了。
下篇预告
基础配置掌握后,下一篇我们进入进阶阶段:深入使用文档处理技能,实现 PDF、Word、Excel 的全面自动化。
下一篇:文档处理三部曲:PDF、Word、Excel 一网打尽
