# claw-helper

**Repository Path**: fgai/claw-helper

## Basic Information

- **Project Name**: claw-helper
- **Description**: Open Claw龙虾助手，快速进行龙虾配置与交互
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-11
- **Last Updated**: 2026-03-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpenClaw 龙虾助手

轻量级 Web 管理面板，用于 OpenClaw 的配置管理与指令交互。

## 功能

### 配置管理
- 读取和编辑 OpenClaw JSON 配置文件
- 友好的树形编辑器界面，支持嵌套对象和数组
- 支持添加/删除字段，修改各种类型的值（字符串、数字、布尔值、对象、数组）
- 一键保存修改

### 指令运行
- 预设常用 OpenClaw 命令菜单（添加通道、启动/停止服务、查看日志等）
- 内嵌交互式终端，基于 xterm.js
- 支持自定义命令输入
- 实时展示命令执行情况，支持终端交互输入

在“添加社交管理”按钮上方增加安装“企业微信插件”：openclaw plugins install @wecom/wecom-openclaw-plugin

openclaw 似乎没有停止命令，所以检测进程来停止，修改用到openclaw stop字段

在“添加社交通道”按钮增加“企微授权配对”，命令为 echo “请输入 openclaw pairing approve openclaw-wecom 你的配对码”

删除重启服务按钮，不需要了
操作指南页面目前太窄了，需要宽一点


## 快速开始

### 环境要求
- Node.js >= 18

### 安装

```bash
git clone https://gitee.com/fgai/claw-helper.git
cd claw-helper
npm install
```

### 配置

复制环境变量模板并按需修改：

```bash
cp .env.example .env
```

可配置项：

| 变量 | 说明 | 默认值 |
|------|------|--------|
| PORT | 服务启动端口 | 3000 |

### 启动

```bash
npm start
```

启动后访问 `http://localhost:3000`

### 开发模式

```bash
npm run dev
```

文件变更后自动重启服务。

## 技术栈

- **后端**: Node.js + Express
- **终端**: xterm.js + node-pty (WebSocket)
- **前端**: Vanilla HTML/CSS/JS

## 项目结构

```
claw-helper/
├── server.js              # Express 服务入口
├── package.json
├── .env.example           # 环境变量模板
├── public/                # 前端静态文件
│   ├── index.html
│   ├── css/style.css
│   └── js/
│       ├── app.js
│       ├── config-editor.js
│       └── terminal.js
└── example.json           # 示例配置文件
```

## 许可证

ISC