feishu

English | 中文

TrustClaw 可信审计版OpenClaw

「贾维斯」本地进化中枢 一个能管理、会拓展、可信任的AI工作伙伴

---

🎁 免费接口 & Token 福利

> 好消息！ 我们为社区贡献者提供 免费的安全审计接口 Token，助力你的 AI 安全开发之旅！

✅ 领取条件

给本项目点过 Star ⭐
提交过 Issue / Pull Request
或是项目的活跃使用者

📮 如何领取

前往 免费 Token 领取通道，按格式留下你的信息，我们会在 0-3 个工作日内审核并通过邮件发送 Token。

---

📦 下载安装

Windows 用户

1. 下载安装包

从 Releases 页面下载最新版本：

   TrustClaw-Setup-2026.x.xx.exe

2. 运行安装程序

双击 .exe 文件启动安装向导
选择安装目录（默认即可）
点击「安装」等待完成
勾选「运行 TrustClaw」后点击「完成」

3. 首次启动

安装完成后，应用会自动启动并：

显示 Loading 界面
后台启动 Gateway 服务
加载控制台界面

macOS 用户

1. 下载 DMG

   TrustClaw-2026.x.xx-arm64.dmg  # Apple Silicon
   TrustClaw-2026.x.xx-x64.dmg    # Intel

2. 安装应用

双击打开 DMG 文件
将应用拖拽到 Applications 文件夹
首次打开时，右键选择「打开」以绕过 Gatekeeper

---

🛠️ 源代码启动（开发者）

如果你想从源代码运行或参与开发，请按以下步骤操作：

环境要求

| 依赖 | 版本要求 | 说明 | |------|----------|------| | Node.js | 22+ | JavaScript 运行时 | | pnpm | 最新版 | 包管理器 | | Python | 3.10+ | Skill 脚本运行（可选） |

步骤一：克隆仓库

git clone https://github.com/GenTelLab/trustclaw.git
cd trustclaw

步骤二：安装依赖

# 安装项目依赖
pnpm install

# 进入桌面应用目录，安装 Electron 依赖
cd apps/desktop
npm install

步骤三：构建项目

# 回到项目根目录
cd ../..

# 构建主项目（TypeScript 编译）
pnpm build

# 构建 Control UI（Web 界面）
cd ui
pnpm build
cd ..

步骤四：启动应用

# 进入桌面应用目录
cd apps/desktop

# 启动 Electron 应用
npm start

开发模式

如果你在修改代码，可以使用开发模式：

# 终端 1：监听主项目变化（可选）
pnpm build --watch

# 终端 2：监听 UI 变化
cd ui
pnpm dev

# 终端 3：启动 Electron（开发模式）
cd apps/desktop
npm run dev

目录结构

trustclaw/
├── src/                    # 核心源代码
│   ├── cli/                # CLI 命令
│   ├── gateway/            # Gateway 服务
│   └── ...
├── ui/                     # Control UI (Web 界面)
│   ├── src/
│   └── ...
├── apps/
│   ├── desktop/            # Electron 桌面应用 ← 你在这里
│   │   ├── main.js         # Electron 主进程
│   │   ├── preload.js      # 预加载脚本
│   │   ├── renderer/       # 渲染进程（Loading 页面）
│   │   └── package.json    # Electron 配置
│   ├── android/            # Android 应用
│   ├── ios/                # iOS 应用
│   └── macos/              # 原生 macOS 应用
├── skills/                 # 技能/工具脚本
│   ├── game-code/          # 游戏代码生成器
│   └── ...
├── dist/                   # 构建输出
│   ├── control-ui/         # UI 构建产物
│   └── ...
└── package.json            # 项目配置

打包安装程序

构建完成后，可以打包为安装程序：

cd apps/desktop

# Windows 安装包
npm run build:win

# macOS 安装包（需在 macOS 上执行）
npm run build:mac

# 或使用一键脚本
# Windows:
.\build.bat

# macOS:
./build-mac.sh

打包输出位于 apps/desktop/dist/ 目录。

常见问题

Q: `pnpm build` 报错 WSL/bash 不可用

在 Windows 上如果没有 WSL，可以跳过 canvas 打包步骤，直接运行：

npx tsc -p tsconfig.json

Q: Electron 安装失败

设置国内镜像源：

# Windows PowerShell
$env:ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"
npm install

# macOS/Linux
export ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"
npm install

Q: 启动后显示 "Gateway 启动失败"

确保已完成主项目构建：

cd /path/to/trustclaw
pnpm build

> 💡 提示：Token 用于保护 Gateway API，无需手动配置。

---

🎛️ 基本操作

1. 模型配置

进入 配置 (Config) 页面，设置 AI 模型：

| 配置项 | 说明 | 示例 | |-------|------|------| | model.default | 默认模型 | gpt-4o, claude-3-5-sonnet | | model.apiKey | API 密钥 | sk-xxx... | | model.baseUrl | 自定义接口地址（可选） | https://api.openai.com/v1 |

支持的模型提供商：

OpenAI (GPT-4, GPT-4o)
Anthropic (Claude)
DeepSeek
智谱 AI (GLM-4)
本地模型 (Ollama)

2. 安全配置

进入 安全 (Security) 页面，配置安全策略：

安全网关设置

| 配置项 | 说明 | |-------|------| | 安全网关接口 | 第三方安全检测 API 地址 | | API Token | 安全接口的认证令牌 |

Bot 安全开关

| 开关 | 功能 | |------|------| | 🛡️ 工具执行确认 | 中高风险操作需要用户确认 | | 🌐 网络隔离模式 | 禁止访问外部网络 | | 📁 文件系统限制 | 限制文件读写范围 | | 📝 审计日志 | 记录所有工具调用 | | ⏱️ 速率限制 | 防止 API 滥用 |

---

🎮 Skill 功能演示：Game Code

Game Code 是一个 HTML5 小游戏生成器，支持模板生成和 AI 智能生成两种模式。

从面板快速使用

1. 在左侧菜单找到 代理 → 技能 2. 在筛选框中搜索 game 3. 找到 game-code 技能卡片 4. 填写参数后点击执行按钮

!Skill 面板 - Game Code

参数说明：

| 参数 | 说明 | 示例 | |------|------|------| | 输出目录 | 游戏文件保存位置 | D:\games | | 生成模式 | 模板模式或 AI 生成模式 | 模板模式 (快速生成经典游戏) | | 游戏类型 | 选择游戏模板 | 贪吃蛇、俄罗斯方块等 | | 游戏标题 | 自定义游戏名称（可选） | 我的小游戏 |

游戏效果预览：

!俄罗斯方块游戏演示

功能概述

┌─────────────────────────────────────────────────────────┐
│                    Game Code Skill                      │
├─────────────────────────────────────────────────────────┤
│  📦 模板模式          │  🤖 AI 生成模式                  │
│  ─────────────────    │  ─────────────────               │
│  • 贪吃蛇 (snake)     │  • 自然语言描述需求              │
│  • 俄罗斯方块 (tetris)│  • GPT-4o / Claude 生成代码      │
│  • 打砖块 (breakout)  │  • 完全自定义游戏逻辑            │
│  • 乒乓球 (pong)      │                                  │
│  • 跳跃小鸟 (flappy)  │                                  │
│  • 记忆翻牌 (memory)  │                                  │
└─────────────────────────────────────────────────────────┘

命令行方式

方式一：模板模式（快速生成）

# 生成贪吃蛇游戏
python scripts/game_gen.py --mode template --type snake --output ~/games/snake

# 生成俄罗斯方块
python scripts/game_gen.py --mode template --type tetris --output ~/games/tetris --title "我的俄罗斯方块"

支持的游戏模板：

| 类型 | 游戏 | 控制方式 | |------|------|---------| | snake | 🐍 贪吃蛇 | 方向键 | | tetris | 🧱 俄罗斯方块 | 方向键 + 空格 | | breakout | 🧱 打砖块 | 鼠标/触屏 | | pong | 🏓 乒乓球 | W/S 和 ↑/↓ | | flappy | 🐦 跳跃小鸟 | 空格/点击 | | memory | 🃏 记忆翻牌 | 鼠标点击 |

方式二：AI 生成模式（自定义游戏）

# 使用 GPT-4o 生成太空射击游戏
python scripts/game_gen.py --mode ai \
  --prompt "创建一个太空射击游戏，玩家控制飞船躲避陨石并射击敌人，有计分系统和3条生命" \
  --output ~/games/space-shooter \
  --model gpt-4o

# 使用 Claude 生成 2048 游戏
python scripts/game_gen.py --mode ai \
  --prompt "做一个2048数字合并游戏，要有漂亮的滑动动画效果，支持触屏操作" \
  --output ~/games/2048 \
  --model claude-3-5-sonnet

支持的 AI 模型：

| 模型 | 环境变量 | 特点 | |------|----------|------| | gpt-4o | OPENAI_API_KEY | 代码质量高，推荐 | | gpt-4o-mini | OPENAI_API_KEY | 速度快，成本低 | | claude-3-5-sonnet | ANTHROPIC_API_KEY | 创意性强 | | deepseek-chat | DEEPSEEK_API_KEY | 性价比高 |

输出结构

每个游戏生成后，目录结构如下：

~/games/snake/
├── index.html   # 游戏主页面（双击打开即可游玩）
├── game.js      # 游戏逻辑代码
└── style.css    # 游戏样式

演示：生成并运行贪吃蛇游戏

# 1. 生成游戏
python scripts/game_gen.py --mode template --type snake --output ./my-snake-game

# 2. 打开游戏（Windows）
start ./my-snake-game/index.html

# 2. 打开游戏（macOS）
open ./my-snake-game/index.html

---

📋 界面导航

| 菜单 | 功能 | |------|------| | Chat | AI 对话界面 | | Overview | 系统概览和状态 | | Channels | 消息渠道管理 (Telegram, Discord 等) | | Instances | 运行实例监控 | | Sessions | 会话管理 | | Cron | 定时任务配置 | | Security | 安全策略配置 | | Skills | 技能/工具管理 | | Nodes | 节点配置 | | Config | 全局配置 | | Debug | 调试工具 | | Logs | 日志查看 |

---

🔧 故障排除

Gateway 启动失败

1. 检查端口是否被占用：

   netstat -ano | findstr 18789

2. 重启应用或手动启动 Gateway：

   trustclaw gateway run --port 18789 --bind loopback

窗口显示空白

1. 等待 Gateway 完全启动（约 5-10 秒） 2. 检查网络连接 3. 按 F12 打开开发者工具查看错误

配置文件位置

| 系统 | 路径 | |------|------| | Windows | C:\Users\<用户名>\.openclaw\openclaw.json | | macOS | ~/.openclaw/openclaw.json | | Linux | ~/.openclaw/openclaw.json |

---

📞 获取帮助

---

Built with ❤️ by TrustClaw Team

Summary

Install to Claude Code