Edict 是基于开源项目 cft0808/edict 二次开发后,集成到 tarui 工具箱中的功能模块。通过封装,用户无需直接接触源码,也不必手动处理复杂的部署和启动流程,即可在本地完成程序获取、服务启动和页面访问,整体使用门槛更低。

本文将围绕该封装版本的实际使用方式展开,重点说明程序获取、本地启动、WebUI 访问和常见问题处理,帮助使用者快速完成上手并理解标准使用流程。

目前已整理为一组连续教程,分别对应部署启动、使用实战、二开扩展和封装版本使用四个方向。若希望完整了解该项目的源码运行方式、实际操作流程以及封装版本的使用方法,建议结合以下文章按需阅读。

文章 说明
【OpenClaw】Edict 三省六部制部署与启动 介绍 Edict 三省六部制的基础部署方式、运行环境准备和启动流程
【OpenClaw】Edict 三省六部制使用与实战流程 介绍系统启动后的主要使用方式、核心流程和实战操作思路
【OpenClaw】Edict 三省六部制二开与扩展 介绍项目在源码层面的二次开发、扩展思路和能力接入方式
AIGC工具平台-Edict 三省六部制 OpenClaw 集成封装版 介绍封装后的本地程序获取、启动配置、WebUI 访问和标准使用流程

模块定位

Edict 是 Project 整合项目中的本地服务控制台,适合需要通过桌面端统一启动服务、调整配置、打开 Web UI 和管理运行参数的用户。它的核心不是单次生成,而是让本地项目在正确目录、正确配置和正确模型下运行。

定位项 内容
所属板块 Project 整合项目
核心任务 启动 Edict 服务、维护 .env、切换 Agent 模型、打开 Web UI
适合用户 需要本地项目控制台、Web UI 和环境变量管理的用户
输入内容 项目目录、模型服务商、API 配置、环境变量和运行参数
输出结果 运行中的本地服务、可访问的 Web UI、保存后的配置状态
使用前提 本地项目目录和运行环境已经准备完成

项目配置

Edict 的配置重点是本地服务、项目目录、Web UI 和 .env 文件。出现本地服务地址或 Web UI 入口时,用户需要先在“项目说明”页通过网盘资源下载 Edict 程序,并按页面要求放到指定目录;统一说明可参考 AIGC工具平台-Tauri2.x智能工具桌面介绍与使用

配置项 配置内容 使用说明
服务状态 启动、停止、刷新和运行状态 服务运行中后再打开 Web UI 或进入核心功能
项目目录 本地 Edict 项目所在目录 目录错误会导致服务无法启动或配置无法读取
Web UI 项目自带浏览器页面 服务运行后打开,用于访问项目界面
Agent 模型 DeepSeek、Claude 或已支持服务商 切换后需要确认对应 API 配置可用
环境变量 .env 基础配置、网关配置、任务配置和变量配置 保存后通常需要重启服务才能生效
数据管理 历史数据或运行记录清理 演示时不建议使用真实数据清理
安全要求 API Key、访问地址、账号信息和敏感路径 截图时必须遮挡真实值

项目说明

项目说明页用于查看 Edict 的用途、教程资源、演示入口和网盘资源。首次使用时,用户应先在这里下载本地程序并放到指定目录,再进入服务管理启动项目。
在这里插入图片描述

服务管理

服务管理页用于启动、停止、刷新 Edict 本地服务,并展示端口、项目目录、服务状态和 Web UI 入口。用户进入配置或 Web UI 前,应先确认服务状态为运行中。

在这里插入图片描述
Agent 全员切换

Agent 全员切换区域用于统一调整 Agent 使用的模型供应商,例如 DeepSeek 或 Claude。切换后需要确认个人中心或配置文件中的 API Key 与当前服务商匹配,否则后续模型调用会失败。

在这里插入图片描述

数据管理

数据管理区域用于清理历史数据或运行记录。正式教程中应提醒用户先确认旧数据不再需要,演示截图建议使用测试项目,避免误导读者清理真实数据。

在这里插入图片描述

配置管理

配置管理页用于读取、编辑、恢复和刷新 .env 配置。基础配置、网关配置、任务配置和变量配置都会影响项目运行,保存配置后应回到服务管理重启服务,确认新配置真正生效。

在这里插入图片描述

或者手动修改配置文件。

# ── Edict 三省六部 事件驱动架构 ──
# 复制为 .env 并根据环境修改

# ── Postgres ──
POSTGRES_HOST=localhost
POSTGRES_PORT=5432
POSTGRES_DB=edict
POSTGRES_USER=edict
POSTGRES_PASSWORD=xxxxxx

# ── Redis ──
REDIS_URL=redis://:password@xxx.xxx.xxx.xxx:6399/2

# ── Backend ──
BACKEND_HOST=0.0.0.0
BACKEND_PORT=8000
SECRET_KEY=BCf6JgCxepoF6Mi2PG3_NKC2qnY19PD2lLLV_L_N81fJoC2WwsT2mEIismlZJAqx
DEBUG=true

# ── OpenClaw Gateway ──
OPENCLAW_GATEWAY_URL=http://localhost:18789
OPENCLAW_BIN=openclaw

# ── 文件路径(兼容旧系统过渡期) ──
LEGACY_DATA_DIR=../data
LEGACY_TASKS_FILE=../data/tasks_source.json

# ── 调度参数 ──
STALL_THRESHOLD_SEC=180
MAX_DISPATCH_RETRY=3
DISPATCH_TIMEOUT_SEC=300
HEARTBEAT_INTERVAL_SEC=30

# ── 飞书通知 ──
FEISHU_DELIVER=true
FEISHU_CHANNEL=feishu

Web UI

Web UI 是 Edict 项目自带的浏览器界面,只有服务运行后才能正常访问。教程中可以在服务启动成功后展示 Web UI 首页,用于证明本地服务和配置已经可用。

下面以创建一个 多邻国产品介绍文档 任务为例,说明各看板在实际使用中的作用。用户可先在 旨意看板 中创建任务并填写要求,再结合 省部调度官员总览 观察任务流转和执行状态,根据需要在 模型配置技能配置 中调整能力,最后在 奏折阁 查看结果内容。对于重复性任务,还可以通过 旨库 沉淀模板,后续直接复用。

看板名称 在本示例中的作用 配图
旨意看板 创建 多邻国产品介绍文档 任务,填写任务要求并查看执行状态 在这里插入图片描述
省部调度 查看任务在各部门之间的流转情况,判断是否存在停滞或积压 在这里插入图片描述
官员总览 查看不同 Agent 的参与情况和执行状态 在这里插入图片描述
模型配置 调整当前任务所使用的模型 在这里插入图片描述
技能配置 为任务接入文档处理、检索等附加能力 在这里插入图片描述
小任务 查看任务执行过程中产生的子任务或辅助任务 在这里插入图片描述
奏折阁 查看最终生成的多邻国产品介绍文档结果 在这里插入图片描述
旨库 将该任务整理为模板,便于后续重复使用 在这里插入图片描述
天下要闻 在需要时为任务补充外部资讯信息 在这里插入图片描述

操作流程

Edict 的操作流程可以按“准备本地程序、启动服务、检查模型和配置、打开 Web UI、根据结果回到配置修正”来理解。配置保存只是写入参数,真正生效通常还需要回到服务管理重启服务,因此流程中要把保存配置和服务重启分开说明。

进入 Edict 项目

查看项目说明和网盘资源

准备本地程序和项目目录

进入服务管理

服务是否运行

启动服务并刷新状态

检查 Agent 模型和配置管理

是否修改配置

保存配置并回到服务管理重启

打开 Web UI

Web UI 是否可访问

检查端口、项目目录和环境变量

确认基础流程完成

应用场景

Edict 适合把一个本地项目作为桌面控制台管理,尤其是需要频繁启动服务、切换模型供应商、修改 .env 和打开 Web UI 的场景。它能帮助用户把“项目目录是否正确、服务是否运行、配置是否保存、Web UI 是否可访问”集中到一个流程里。对新用户来说,先通过项目说明准备程序,再启动服务,是避免失败的关键;对长期使用者来说,配置管理和 Agent 全员切换可以减少手工改文件的成本。

应用场景 使用方式 关联功能 输出结果
本地 Web UI 启动 启动服务后打开 Web UI 服务管理、Web UI 可访问的项目页面
模型供应商切换 选择 Agent 服务商并确认 API 配置 Agent 全员切换、配置管理 更新后的模型调用方式
环境变量维护 编辑 .env 后重启服务 配置管理、服务管理 生效的运行参数
服务异常排查 检查目录、端口、配置和运行状态 服务管理、配置管理 可定位的启动失败原因

总结

Edict 的使用顺序是先准备本地项目目录,再启动服务,随后检查模型和 .env 配置,最后打开 Web UI 验证服务可用。配置保存后要重启服务,不能把保存动作直接等同于生效。

更多内容请访问:

文章链接 内容描述
AIGC工具箱安装与使用 介绍 AIGC 工具箱的安装流程、基础配置方式以及首次启动后的使用说明。
AIGC工具箱功能应用模块 介绍工具箱内各功能模块的分类、入口位置和实际使用方式,便于快速了解整体能力。
AIGC工具箱错误解决办法 汇总工具箱在安装、启动和使用过程中常见的报错情况,并提供对应的排查与解决方法。
AICG常用API获取方式 介绍桌面工具使用过程中所需 API 密钥的获取方式,便于完成接口配置与功能接入。
Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐