JishuShell

https://github.com/x-aijishu/jishushell
Admin
JishuShell is a Web-based management panel for local and edge AI Agent instances, featuring...
Tokens:14,548
Snippets:181
Trust Score:3
License:Apache-2.0
Update:2 months ago
Show doc for...
Tokens:
Raw
### Install JishuShell via Shell Script

Source: https://github.com/x-aijishu/jishushell/blob/main/README.md

Use the provided shell script to install JishuShell on supported Linux or macOS systems.

```bash
curl -fsSL https://aijishu.com/install.sh | bash
```

--------------------------------

### Install JishuShell via NPM

Source: https://github.com/x-aijishu/jishushell/blob/main/README.md

Install the JishuShell package globally using the Node Package Manager.

```bash
npm install -g jishushell
```

--------------------------------

### 配置 Docker 权限

Source: https://github.com/x-aijishu/jishushell/blob/main/guidance/02-installation.md

手动将用户添加到 docker 组以获取访问权限。

```bash
sudo usermod -aG docker $USER
newgrp docker   # 在当前终端立即生效，或重新登录
```

--------------------------------

### 配置 npm 镜像

Source: https://github.com/x-aijishu/jishushell/blob/main/guidance/06-im-channels.md

当安装插件因网络受限失败时，可通过此命令配置 npm 镜像源。

```bash
/config npm set registry https://registry.npmmirror.com
```

--------------------------------

### 飞书配对审批命令行操作

Source: https://github.com/x-aijishu/jishushell/blob/main/guidance/06-im-channels.md

通过命令行查看待审批的配对请求并进行审批操作。

```bash
# 查看待审批请求（自动检测运行中的实例）
jishushell pairing list

# 审批指定配对码（默认 channel=feishu）
jishushell pairing approve LVU7PNYK

# 完整形式（多实例时需指定 --instance）
jishushell pairing approve feishu LVU7PNYK --instance my-instance
```

--------------------------------

### 备份实例配置

Source: https://github.com/x-aijishu/jishushell/blob/main/guidance/10-system-maintenance.md

备份单个实例配置或所有实例数据的命令。

```bash
# 备份单个实例配置
cp ~/.jishushell/instances/<id>/openclaw-home/.openclaw/openclaw.json \
   ~/backup-openclaw-<id>-$(date +%Y%m%d).json

# 备份全部实例
tar -czf ~/jishushell-backup-$(date +%Y%m%d).tar.gz \
    ~/.jishushell/instances/
```

--------------------------------

### Manage LLM Providers via CLI

Source: https://github.com/x-aijishu/jishushell/blob/main/blogs/v0.4.17.md

List available LLM providers or initiate a chat session with a specific provider using the command line.

```bash
jishushell llm list                   
jishushell llm ollama chat "你好"
```

--------------------------------

### 实例备份与管理命令

Source: https://github.com/x-aijishu/jishushell/blob/main/blogs/v0.4.10.md

用于执行实例备份、恢复、导出、导入及自动备份配置的命令行操作。

```bash
jishushell backup <id>                          # 完整备份
jishushell backup <id> --state-only             # 仅数据
jishushell restore <id> --latest                # 恢复到最新备份
jishushell restore --new --from <src-id> --latest  # 从备份创建新实例
jishushell export <id>                          # 导出分享包
jishushell import <file.tar.gz>                 # 导入为新实例
jishushell auto-backup <id> enable              # 开启自动备份
```

--------------------------------

### 查看实例完整日志

Source: https://github.com/x-aijishu/jishushell/blob/main/guidance/10-system-maintenance.md

通过命令行查看指定实例的完整 Agent 日志文件。

```bash
# 查看实例完整日志文件
cat ~/.jishushell/instances/<instance-id>/openclaw-home/.openclaw/logs/agent.log
```

--------------------------------

### 手动安装 Node.js

Source: https://github.com/x-aijishu/jishushell/blob/main/guidance/02-installation.md

当自动安装失败时，通过 nvm 手动安装 Node.js。

```bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 22
```

--------------------------------

### 开启 Agent 实例外设访问权限

Source: https://github.com/x-aijishu/jishushell/blob/main/blogs/v0.6.18.md

为指定的 Agent 实例开启提权模式，允许其访问本机外设。

```bash
jishushell job privileged <实例ID> on
```

--------------------------------

### 清理 Docker 镜像

Source: https://github.com/x-aijishu/jishushell/blob/main/guidance/10-system-maintenance.md

在磁盘空间不足时清理未使用的 Docker 镜像。

```bash
docker image prune -a
```

--------------------------------

### 执行日志收集脚本

Source: https://github.com/x-aijishu/jishushell/blob/main/skills/github-create-issue/SKILL.md

通过远程脚本或本地路径执行日志收集与打包操作。

```bash
bash <(curl -fsSL https://raw.githubusercontent.com/x-aijishu/jishushell/main/skills/github-create-issue/github-create-issue.sh)
```

```bash
bash ~/.jishushell/skills/github-create-issue/github-create-issue.sh
```

--------------------------------

### 重启 Nomad 调度引擎

Source: https://github.com/x-aijishu/jishushell/blob/main/guidance/10-system-maintenance.md

通过命令行重启 Nomad 引擎以解决调度异常。

```bash
systemctl restart nomad
```

--------------------------------

### 升级 JishuShell 至最新版本

Source: https://github.com/x-aijishu/jishushell/blob/main/blogs/summary.md

使用 npm 全局安装最新版本的 JishuShell。

```bash
npm install -g jishushell@latest
```

--------------------------------

### 执行一键安装脚本

Source: https://github.com/x-aijishu/jishushell/blob/main/guidance/02-installation.md

使用 curl 或 wget 下载并执行安装脚本以自动配置环境。

```bash
curl -fsSL https://aijishu.com/install.sh | bash
```

```bash
wget -qO- https://raw.githubusercontent.com/x-base/jishushell/main/install/jishu-install.sh | bash
```

--------------------------------

### 升级 JishuShell CLI

Source: https://github.com/x-aijishu/jishushell/blob/main/blogs/v0.7.17.md

使用 npm 全局安装指定版本的 JishuShell。

```bash
npm install -g jishushell@0.7.17
```

--------------------------------

### 升级 JishuShell CLI

Source: https://github.com/x-aijishu/jishushell/blob/main/blogs/v0.4.30.md

使用 npm 全局安装指定版本的 JishuShell。

```bash
npm install -g jishushell@0.4.30
```

--------------------------------

### 执行 JishuShell 环境检测

Source: https://github.com/x-aijishu/jishushell/blob/main/blogs/summary.md

升级后运行此命令以验证系统环境配置是否正常。

```bash
jishushell doctor
```

--------------------------------

### 执行系统级修复命令

Source: https://github.com/x-aijishu/jishushell/blob/main/blogs/v0.7.17.md

系统级安装后需执行此命令以完成本地状态自检与组件重载。

```bash
sudo jishushell repair
```

```bash
sudo ~/.jishushell/bin/jishushell repair
```

--------------------------------

### 验证安装状态

Source: https://github.com/x-aijishu/jishushell/blob/main/guidance/02-installation.md

检查服务运行状态并测试面板访问。

```bash
# 检查面板服务状态
systemctl status jishushell

# 检查 Nomad 状态
systemctl status nomad

# 访问面板
curl -I http://localhost:8090
```

--------------------------------

### 日志包预览与分析

Source: https://github.com/x-aijishu/jishushell/blob/main/skills/github-create-issue/SKILL.md

解压生成的日志包并查看环境信息文件，用于在提交前进行初步排查。

```bash
mkdir -p /tmp/jishushell-issue-preview
tar -xzf ~/jishushell-issue-*.tar.gz -C /tmp/jishushell-issue-preview/
cat /tmp/jishushell-issue-preview/*/env.txt
```

--------------------------------

### 查看安装后目录结构

Source: https://github.com/x-aijishu/jishushell/blob/main/guidance/02-installation.md

展示安装完成后 ~/.jishushell 目录下的文件布局。

```text
~/.jishushell/
├── bin/
│   ├── jishushell-start      # 面板启动脚本
│   └── nomad                 # Nomad 二进制
├── nomad/
│   ├── nomad.hcl             # Nomad 配置（含 ACL）
│   ├── nomad.log             # Nomad 启动日志
│   └── data/                 # Nomad 状态数据
├── instances/                # 所有 OpenClaw 实例目录
│   └── <instance-id>/
│       └── openclaw-home/
│           └── .openclaw/
│               ├── openclaw.json     # 实例配置
│               ├── workspace/
│               │   ├── skills/       # 已安装的 Skills
│               │   └── config/
│               │       └── mcporter.json  # MCP 配置
│               └── ...
├── packages/                 # npm 包缓存
├── panel.json                # 面板运行时配置
├── nomad.env                 # NOMAD_TOKEN（权限 600）
└── jishushell.log            # 面板服务日志
```

--------------------------------

### 配置模型代理

Source: https://github.com/x-aijishu/jishushell/blob/main/guidance/05-instance-config.md

通过 x-jishushell 字段配置上游 LLM 代理，无需在 OpenClaw 中直接配置 API Key。

```json
{
  "x-jishushell": {
    "proxy": {
      "upstream": {
        "provider": "openai",
        "apiKey": "sk-...",
        "baseUrl": "https://api.openai.com/v1"
      }
    }
  }
}
```

--------------------------------

### 安装 curl 工具

Source: https://github.com/x-aijishu/jishushell/blob/main/guidance/02-installation.md

在缺少 curl 的环境下安装该工具。

```bash
# Debian/Ubuntu
sudo apt-get install -y curl

# macOS
brew install curl
```

--------------------------------

### 手动重载系统服务

Source: https://github.com/x-aijishu/jishushell/blob/main/blogs/v0.6.5.md

在系统级安装且升级后提示 ACTION REQUIRED 时，执行此命令完成服务重载与配置协调。

```bash
sudo ~/.jishushell/bin/jishushell system reload
```

--------------------------------

### Manage Jobs via CLI

Source: https://github.com/x-aijishu/jishushell/blob/main/blogs/v0.4.17.md

Use these commands to list active jobs or check the status of a specific job ID.

```bash
jishushell job list
jishushell job status id
```

--------------------------------

### 安装微信插件

Source: https://github.com/x-aijishu/jishushell/blob/main/guidance/06-im-channels.md

在实例环境中执行此命令以安装微信集成插件。

```bash
npx -y @tencent-weixin/openclaw-weixin-cli install
```

--------------------------------

### 安装飞书插件

Source: https://github.com/x-aijishu/jishushell/blob/main/guidance/06-im-channels.md

在实例环境中执行此命令以安装飞书集成插件。

```bash
npx -y @larksuite/openclaw-lark install
```

--------------------------------

### 升级 JishuShell

Source: https://github.com/x-aijishu/jishushell/blob/main/blogs/v0.4.24.md

使用 npm 全局安装指定版本的 JishuShell。

```bash
npm install -g jishushell@0.4.24
```

--------------------------------

### 设置默认模型

Source: https://github.com/x-aijishu/jishushell/blob/main/guidance/05-instance-config.md

在 models 字段下指定实例启动时使用的默认模型名称。

```json
{
  "models": {
    "default": "claude-3-5-sonnet-20241022"
  }
}
```

--------------------------------

### Issue 草稿模板

Source: https://github.com/x-aijishu/jishushell/blob/main/skills/github-create-issue/SKILL.md

用于生成 Issue 报告的 Markdown 格式模板。

```markdown
**标题建议**：[根据错误关键词生成，15字以内]

**问题描述**
[一段话描述现象]

**复现步骤**
1. ...
2. ...

**错误信息**
[关键错误，≤30行]

**环境**
| 项目 | 版本 |
|------|------|
| OS   | ...  |
| Arch | ...  |
| Node | ...  |
| JishuShell | ... |

<details>
<summary>完整日志（已附件）</summary>
见附件 jishushell-issue-<时间戳>.tar.gz
</details>
```

--------------------------------

### 卸载 JishuShell

Source: https://github.com/x-aijishu/jishushell/blob/main/guidance/02-installation.md

使用内置命令卸载面板及相关组件。

```bash
jishushell uninstall
```

```bash
jishushell uninstall --yes
```

```bash
# 停止服务并取消开机自启（保留数据）
bash jishu-uninstall.sh

# 完全卸载（删除所有组件）
bash jishu-uninstall.sh --all

# 仅卸载特定组件
bash jishu-uninstall.sh --nomad         # 仅卸载 Nomad
bash jishu-uninstall.sh --openclaw      # 仅卸载 OpenClaw
bash jishu-uninstall.sh --node          # 仅卸载 Node.js（nvm）
bash jishu-uninstall.sh --docker        # 仅卸载 Docker
bash jishu-uninstall.sh --data          # 仅删除 ~/.jishushell 数据目录
```

```bash
bash jishu-uninstall.sh --all --dry-run
```

--------------------------------

### 自动版本检测提示

Source: https://github.com/x-aijishu/jishushell/blob/main/guidance/10-system-maintenance.md

仪表盘和实例详情页显示的新版本检测提示信息。

```text
发现新版本：0.1.0 → 0.2.0   [立即升级]
```

--------------------------------

### 手动登录目标网站

Source: https://github.com/x-aijishu/jishushell/blob/main/blogs/03-mac-browserless-guide.md

在 Browserless Debugger 中使用此代码打开目标网站，以便手动完成登录并持久化保存 Cookie 和 Session。

```typescript
export default async ({ page }: { page: Page }) => {
  await page.goto('https://flights.ctrip.com');
  // 页面打开后手动在右侧操作登录，无需点击执行
};
```

--------------------------------

### MCP 配置文件路径与结构

Source: https://github.com/x-aijishu/jishushell/blob/main/guidance/08-mcp-servers.md

查看 MCP 服务器的存储路径及配置文件结构示例。

```text
~/.jishushell/instances/<id>/openclaw-home/.openclaw/workspace/config/mcporter.json
```

```json
{
  "mcpServers": {
    "12306-mcp": {
      "command": "npx",
      "args": ["-y", "12306-mcp"]
    }
  }
}
```

--------------------------------

### Run AI-Assisted System Diagnosis

Source: https://github.com/x-aijishu/jishushell/blob/main/blogs/v0.4.17.md

Execute the doctor command with the --ai flag to collect system logs and receive automated troubleshooting advice from an AI model.

```bash
jishushell doctor --ai
```

--------------------------------

### 配置自定义 MCP 服务器

Source: https://github.com/x-aijishu/jishushell/blob/main/guidance/08-mcp-servers.md

通过 JSON 格式添加自定义 MCP 服务器，支持命令行或 HTTP 模式。

```json
{
  "my-tool": {
    "command": "npx",
    "args": ["-y", "my-mcp-package"]
  }
}
```

```json
{
  "my-tool": {
    "baseUrl": "http://localhost:3100"
  }
}
```

--------------------------------

### 自定义面板端口

Source: https://github.com/x-aijishu/jishushell/blob/main/guidance/02-installation.md

在安装前通过环境变量修改面板端口。

```bash
export JISHUSHELL_PORT=8091
curl -fsSL https://aijishu.com/install.sh | bash
```

--------------------------------

### 通用 Skill 调用格式

Source: https://github.com/x-aijishu/jishushell/blob/main/guidance/09-slash-commands.md

展示调用特定 Skill 的标准语法格式。

```text
/skill <skill-dir-name>
```

--------------------------------

### Upgrade JishuShell

Source: https://github.com/x-aijishu/jishushell/blob/main/blogs/v0.4.17.md

Update the global JishuShell package to version 0.4.17 using npm.

```bash
npm install -g jishushell@0.4.17
```

--------------------------------

### Upgrade JishuShell via NPM

Source: https://github.com/x-aijishu/jishushell/blob/main/blogs/v0.5.15.md

Use this command to update the JishuShell package to version 0.5.15 globally.

```bash
npm install -g jishushell@0.5.15
```

--------------------------------

### Upgrade JishuShell via NPM

Source: https://github.com/x-aijishu/jishushell/blob/main/blogs/v0.5.22.md

Use this command to update the JishuShell package to version 0.5.22 globally.

```bash
npm install -g jishushell@0.5.22
```

--------------------------------

### 调用特定 Skill 示例

Source: https://github.com/x-aijishu/jishushell/blob/main/guidance/09-slash-commands.md

展示调用名为 my-skill 的具体示例。

```text
/skill my-skill
```

--------------------------------

### 安装 Skill 命令格式

Source: https://github.com/x-aijishu/jishushell/blob/main/guidance/07-skills.md

通过发送特定格式的链接给 Agent 来安装 Skill。

```text
根据以下链接安装 skill：https://clawhub.ai/author/skill-name
```

--------------------------------

### 调用已安装的 Skill

Source: https://github.com/x-aijishu/jishushell/blob/main/guidance/07-skills.md

安装完成后，在对话框中输入对应的斜杠命令即可调用。

```text
/skill-vetter
```

--------------------------------

### 模型命令使用示例

Source: https://github.com/x-aijishu/jishushell/blob/main/guidance/09-slash-commands.md

展示如何通过斜杠命令配置模型名称、思考深度、详细输出模式及快速模式。

```text
/model claude-3-5-sonnet-20241022
/think high
/verbose on
/fast off
```

--------------------------------

### 安装 MCPorter

Source: https://github.com/x-aijishu/jishushell/blob/main/guidance/08-mcp-servers.md

在对话框中输入此命令以安装 MCPorter 管理工具。

```text
安装 https://clawhub.ai/steipete/mcporter
```
Tokens:
Raw