本篇只讲安装与启动目标很明确把 Edict 在本地成功跑起来并完成基础验收。内容按实际部署顺序展开减少概念说明重点放在环境检查、启动命令、页面访问、接口验证和常见报错处理上。完成后可以独立完成 Demo 启动、本地完整栈启动以及基础问题排查。目前已整理为一组连续教程分别对应部署启动、使用实战、二开扩展和封装版本使用四个方向。若希望完整了解该项目的源码运行方式、实际操作流程以及封装版本的使用方法建议结合以下文章按需阅读。文章说明【OpenClaw】Edict 三省六部制部署与启动介绍 Edict 三省六部制的基础部署方式、运行环境准备和启动流程【OpenClaw】Edict 三省六部制使用与实战流程介绍系统启动后的主要使用方式、核心流程和实战操作思路【OpenClaw】Edict 三省六部制二开与扩展介绍项目在源码层面的二次开发、扩展思路和能力接入方式AIGC工具平台-Edict 三省六部制 OpenClaw 集成封装版介绍封装后的本地程序获取、启动配置、WebUI 访问和标准使用流程文章目录项目简介与适用人群架构速览环境准备三种安装方式Docker 快速体验macOS/Linux 原生安装Windows 本地生产仿真一键启动与停止首次验收清单常见安装问题排查可选扩展总结项目简介与适用人群Edict 是一个围绕“三省六部”协作机制构建的任务流转系统包含看板、后端服务、同步脚本和 OpenClaw 支撑层。学习这类项目最有效的入口不是先读完整架构而是先把系统跑起来再通过页面、接口和日志理解整体结构。本篇完成后应达到下面的运行结果看板http://127.0.0.1:7891 健康检查http://127.0.0.1:7891/healthz 实时状态http://127.0.0.1:7891/api/live-status 后端文档http://127.0.0.1:8000/docs Gatewayhttp://127.0.0.1:18789部署完成的最低标准浏览器能打开http://127.0.0.1:7891接口http://127.0.0.1:7891/api/live-status能返回 JSON完整模式下http://127.0.0.1:8000/docs能打开这说明本地环境已经具备继续学习和联调的条件。架构速览安装阶段只需要先记住四个组成部分。看板负责展示页面后端负责接口同步脚本负责刷新数据OpenClaw 负责网关与 Agent 能力。页面打不开多半看端口和看板服务。接口打不开多半看后端和基础依赖。页面能开但数据不变多半看同步脚本和日志。快速记忆可以直接看下面这组对应关系看板服务dashboard/server.py 同步脚本scripts/run_loop.sh 后端接口http://127.0.0.1:8000/docs 网关地址http://127.0.0.1:18789 日志目录.runtime\prod\logs首页能打开但面板没有数据这类问题通常不是浏览器异常而是同步链路或后端接口没有准备好。此时应优先检查api/live-status和日志而不是反复刷新页面。环境准备运行 Edict 之前需要先准备 Git、Python、Node.js、OpenClaw 和 Docker。安装是否成功不能只看图形界面而要以命令行检查结果为准。命令能执行后续脚本才有机会正常运行。先检查基础命令openclaw--versionpython--versionnpm-vdocker-vgit--version常见要求如下Python 3.9 Node.js 18 Docker 可正常运行如果python --version正常但npm -v报错说明 Python 已准备完成Node.js 仍未就绪。继续执行前端相关安装脚本时通常会直接失败。在新环境中先执行下面这一组命令openclaw--versionpython--versionnpm-vdocker-vgit--version只有这些命令都能正常输出版本才适合进入仓库安装阶段。这样可以减少一半以上的基础环境报错。三种安装方式这一部分保留三种路径但直接按“适用场景 命令 验收方式”展开方便照着执行。Docker 快速体验这一方式最适合第一次启动命令最少目标是先看到页面。dockerrun-p7891:7891 cft0808/sansheng-demo打开浏览器访问http://127.0.0.1:7891如果仓库根目录已提供docker-compose.yml也可以执行dockercompose up停止运行Ctrl C这组命令的意义很直接就是先确认项目最外层界面能否正常访问。只要页面能打开后续再切到完整模式就会更顺手。执行dockerrun-p7891:7891 cft0808/sansheng-demo看到终端持续运行后浏览器打开http://127.0.0.1:7891只要页面出现就说明 Demo 模式已经成功启动。macOS/Linux 原生安装原生安装更适合继续做本地开发和联调。安装并初始化 OpenClawbrewinstallopenclaw openclaw init克隆项目并执行安装脚本gitclone https://github.com/cft0808/edict.gitcdedictchmodx install.sh./install.sh启动同步脚本bashscripts/run_loop.sh启动看板服务python3 dashboard/server.py打开页面http://127.0.0.1:7891这里的重点不是死记命令而是理解启动顺序。安装脚本负责准备环境和数据同步脚本负责更新状态看板服务负责提供页面。少任意一个环节都可能出现页面能开但功能不完整的情况。进入项目目录后依次执行chmodx install.sh./install.shbashscripts/run_loop.sh python3 dashboard/server.py另开浏览器访问http://127.0.0.1:7891如果页面正常再访问http://127.0.0.1:7891/api/live-status能看到 JSON 数据就说明原生安装基本成功。Windows 本地生产仿真Windows 环境更适合直接用批处理脚本拉起整套服务。本地准备 OpenClaw02_setup_openclaw_local.bat准备 Python 依赖和前端产物01_setup_prod_env.bat --sync启动 Postgres 和 Redisdockercompose-fedict/docker-compose.yml up-dpostgres redis启动整套服务03_start_prod_stack.bat --open-browser --migrate停止服务04_stop_prod_stack.bat启动成功后重点检查下面这些地址看板http://127.0.0.1:7891 后端文档http://127.0.0.1:8000/docs Gatewayhttp://127.0.0.1:18789 日志目录.runtime\prod\logs执行01_setup_prod_env.bat --sync 03_start_prod_stack.bat --open-browser --migrate如果脚本执行完成后浏览器打开看板页面再访问http://127.0.0.1:8000/docs能打开 Swagger 页面就说明完整链路已经进入可用状态。一键启动与停止启动与停止命令是日常最常用的操作。很多异常并不是安装失败而是旧进程没退出、端口没释放或依赖服务没先启动。Linux 或 macOS 常用命令bashscripts/run_loop.sh python3 dashboard/server.pyWindows 常用命令03_start_prod_stack.bat --open-browser --migrate 04_stop_prod_stack.bat启动前如果系统状态不确定更稳妥的做法是先执行停止脚本再重新启动。这样可以减少端口占用和旧进程残留带来的干扰。当页面异常但原因不明时可以先执行04_stop_prod_stack.bat 03_start_prod_stack.bat --open-browser --migrate这一套做法比直接双击旧脚本更可靠因为它会先清理已有服务再重新拉起当前环境。首次验收清单安装完成后不要只看“命令执行结束”还要看页面、接口和日志是否正常。只有这三部分都通过部署才算真正完成。浏览器检查http://127.0.0.1:7891 http://127.0.0.1:7891/healthz http://127.0.0.1:7891/api/live-status http://127.0.0.1:8000/docs命令行检查curlhttp://127.0.0.1:7891/healthzcurlhttp://127.0.0.1:7891/api/live-status日志位置.runtime\prod\logshealthz用来判断看板服务是否存活api/live-status用来判断数据接口是否连通docs用来判断后端是否正常启动。日志则用来确认是否存在持续重复报错。执行curlhttp://127.0.0.1:7891/healthzcurlhttp://127.0.0.1:7891/api/live-status如果有正常返回再打开http://127.0.0.1:8000/docsSwagger 页面能显示说明前端、接口和后端文档链路都已打通。常见安装问题排查安装阶段最常见的问题通常集中在端口、基础依赖、同步链路和配置生效这几类。排查时不必大范围重装按现象查对应模块更高效。7891 端口被占用先停止旧服务04_stop_prod_stack.bat继续检查端口netstat -ano | findstr 7891如果已经查到进程号可以直接结束进程taskkill /PID 进程号 /F页面能开但提示服务未启动检查健康接口curlhttp://127.0.0.1:7891/healthz检查实时状态接口curlhttp://127.0.0.1:7891/api/live-status如果健康检查正常但实时状态没有数据问题大多出在后端或同步链路。后端起不来先启动基础依赖dockercompose-fedict/docker-compose.yml up-dpostgres redis再重新启动完整服务03_start_prod_stack.bat --open-browser --migrate模型切换后没生效同步配置并重启网关python scripts/apply_model_changes.py openclaw gateway restart数据不刷新手动刷新一次python scripts/refresh_live_data.py如果刷新后仍无变化通常需要继续检查run_loop是否正在运行。数据不更新示例页面能打开但状态始终不变化可以先执行curlhttp://127.0.0.1:7891/api/live-status python scripts/refresh_live_data.py如果接口仍没有新数据再去查看日志目录中的 backend 和 dispatcher 输出排查会更有方向。可选扩展接入消息渠道本地启动完成后还可以把消息渠道接入到 OpenClaw让任务从外部进入系统而不只是停留在页面演示阶段。查看已有渠道openclaw channels list添加飞书渠道openclaw channelsadd--typefeishu--agenttaizi配置完成后任务可以从入口 Agent 进入系统流转。执行openclaw channels list openclaw channelsadd--typefeishu--agenttaizi完成配置后通过飞书发送任务消息就可以测试外部任务进入“三省六部”流程的效果。总结本篇的重点只有一个把 Edict 跑起来。实际操作上可以分成三步先检查环境再选安装方式最后做首次验收。只想快速看效果用 Docker。准备本地开发用 macOS 或 Linux 原生安装。需要在 Windows 中做完整联调用批处理脚本启动整套服务。只要看板能打开、接口能返回、后端文档能访问这一篇的目标就已经达成。下一篇就可以直接进入实战使用包括任务下发、状态流转、看板观察和常用操作。