程序简介
《OpenClaw 网页控制界面》一个基于 Web 的 OpenClaw CLI 命令管理界面，通过可视化按钮代替命令行输入，提供更友好的用户体验。
功能特点
-
预设命令按钮 - 常用命令一键执行，无需手动输入
-
自定义命令输入 - 支持输入任意 OpenClaw 命令 -
实时输出显示 - 命令执行结果实时展示 -
美观界面设计 - 现代化响应式布局 -
跨平台支持 - 支持 Windows、macOS、Linux -
命令分类管理 - 按功能分类组织命令
支持的命令模块
| 分类 | 命令 | 说明 |
|------|------|------|
| 基础命令 | help, status, --version | 帮助、状态、版本信息 |
| 代理管理 | agent, agents | 代理配置和管理 |
| 消息管理 | message, sessions | 消息发送和会话管理 |
| 系统管理 | system, update, doctor | 系统状态和更新 |
| 安全管理 | security, secrets | 安全扫描和密钥管理 |
| 模型管理 | models, skills | 模型和技能管理 |
| 通道管理 | channels, gateway | 聊天频道和网关管理 |
安装步骤
前置要求
-
Python 3.8+ - 确保已安装 Python 3.8 或更高版本
-
OpenClaw CLI - 已安装并配置好 OpenClaw 命令行工具
-
pip - Python 包管理工具
环境搭建
1. 克隆项目
# 进入项目目录
cd c:\Users\Administrator\Documents\trae_projects\openclaw_web
2. 创建虚拟环境（推荐）
Windows 命令提示符：
python -m venv venv
venv\Scripts\activate.bat
Windows PowerShell：
python -m venv venv
.\venv\Scripts\Activate.ps1
Linux/macOS：
python3 -m venv venv
source venv/bin/activate
3. 安装依赖
pip install -r requirements.txt
依赖包说明：
-
Flask==3.0.0- Web 框架 -
flask-cors==4.0.0- 跨域资源共享支持
启动服务
python app.py
启动成功后，控制台将显示：
==================================================
OpenClaw 网页控制界面服务启动中...
服务地址: http://localhost:5000
==================================================
访问界面
在浏览器中打开：http://localhost:5000
配置说明
Token 配置
系统会自动读取 tokens.json 文件中的配置。确保该文件包含正确的 API Token：
{
"openclaw_token": "your-openclaw-api-token"
}
服务配置
在 app.py 中可修改以下配置：
app.config['SECRET_KEY'] = 'your-secret-key-here' # 会话密钥
app.run(
host='0.0.0.0', # 绑定地址
port=5000, # 服务端口
debug=True # 调试模式
)
使用方法
执行预设命令
-
在界面上找到对应的命令按钮
-
根据提示填写必要的参数（如消息内容、目标地址等）
-
点击"执行"按钮
-
在下方输出区域查看执行结果
执行自定义命令
-
在"自定义命令"输入框中输入命令
-
点击"执行"按钮或按 Enter 键
-
查看输出结果
交互式命令
某些命令需要在终端中交互式运行（如 gateway, tui, devices），系统会自动在新窗口中启动。
技术栈
| 组件 | 技术 | 版本 |
|------|------|------|
| 前端框架 | HTML5 | - |
| 样式 | CSS3 | - |
| 交互 | JavaScript | ES6+ |
| 后端框架 | Flask | 3.0.0 |
| 跨域支持 | Flask-CORS | 4.0.0 |
| 命令执行 | subprocess | Python 内置 |
故障排除
问题 1：服务无法启动
原因：端口 5000 被占用
解决方案：
# 查找占用端口的进程（Windows）
netstat -ano | findstr :5000
taskkill /F /PID <进程ID>
# 或修改 app.py 中的端口号
app.run(port=5001)
问题 2：命令执行失败
原因：OpenClaw CLI 未正确安装或未在 PATH 中
解决方案：
# 验证 OpenClaw 安装
openclaw --version
# 如果未找到命令，请将 OpenClaw 添加到系统 PATH
问题 3：网关相关命令报错
原因：OpenClaw Gateway 未启动
解决方案：
# 在终端中启动网关
openclaw gateway
问题 4：跨域错误
原因：浏览器安全策略限制
解决方案：
-
确保
flask-cors已正确安装 -
检查浏览器控制台的错误信息
更新日志
v1.0.0
-
初始版本
-
支持常用 OpenClaw 命令
-
实时命令执行和输出
-
美观的用户界面
许可证
MIT License
界面截图