OpenClaw如何开启本地化控制 OpenClaw本地化功能设置方法说明最佳实践|Duuu笔记
OpenClaw本地化控制功能需通过五种方式启用:一、执行openclaw start启动Web控制台;二、用openclaw tui进入实时交互终端;三、修改openclaw.json配置server地址端口;四、设置OPENCLAW_DEBUG=1等环境变量启用调试模式;五、运行openclaw configure --advanced开启本地文件系统权限。
如果您已成功部署 OpenClaw,但无法通过本地界面管理配置、查看运行状态或实时调试代理行为,则说明本地化控制功能尚未启用或未正确绑定。以下是开启 OpenClaw 本地化控制功能的具体方法:
一、启动内置 Web 控制台
OpenClaw 默认提供一个本地 HTTP 控制界面,运行在固定端口,用于可视化配置与状态监控。该界面仅监听本地回环地址,确保通信安全。
1、确保 OpenClaw 已完成初始化(即已执行
openclaw
onboard
并完成模型与服务商选择)。
2、在终端中执行命令启动网关服务:
openclaw start
。
3、等待终端输出类似
Gateway started on http://127.0.0.1:18789
的提示信息。
4、打开浏览器,访问地址:
http://127.0.0.1:18789
,即可进入控制台主界面。
二、启用 CLI 实时交互终端(TUI)
TUI 模式提供类终端的动态交互视图,支持实时日志流、会话追踪与快捷命令操作,是本地化调试的核心方式之一。
1、确认当前未运行其他 OpenClaw 进程,执行:
pkill -f openclaw
。
2、以 TUI 模式启动:
openclaw tui
。
3、界面加载完成后,按
Tab 键
切换面板,使用
↑/↓ 方向键
浏览日志流。
4、输入
/help
查看可用命令列表,例如
/status
显示当前 agent 状态。
三、手动配置本地监听地址与端口
当默认端口被占用或需调整访问策略时,可通过配置文件强制指定本地控制服务的绑定参数。
1、编辑 OpenClaw 配置文件:
~/.openclaw/openclaw.json
。
2、在根对象中添加或修改以下字段:
"server": {"host": "127.0.0.1", "port": 18789}
。
Zeemo
提供视频字幕、字幕制作和字幕翻译服务
下载
3、保存文件后执行:
openclaw config reload
使变更生效。
4、再次运行
openclaw start
,验证新端口是否可访问。
四、通过环境变量临时启用调试控制模式
此方法不修改持久配置,适用于一次性诊断场景,自动开启增强日志与本地 API 调试端点。
1、在终端中执行:
OPENCLAW_DEBUG=1 OPENCLAW_DEV_MODE=1 openclaw start
。
2、观察终端输出,确认出现
Debug mode enabled
与
Dev API exposed at /debug/*
提示。
3、访问
http://127.0.0.1:18789/debug/status
获取 JSON 格式运行时快照。
4、访问
http://127.0.0.1:18789/debug/logs?tail=100
实时流式获取最近 100 行日志。
五、启用本地文件系统代理控制开关
OpenClaw 的本地化控制不仅限于界面与网络,还包括对本机文件、进程、剪贴板等资源的直接操作权限开关。
1、运行配置向导并进入高级设置:
openclaw configure --advanced
。
2、定位到
"local_access"
区域,将
"enable_filesystem"
设为
true
。
3、将
"enable_clipboard"
与
"enable_process_control"
同步设为
true
。
4、保存后重启服务:
openclaw restart
,终端将提示
Local control capabilities activated
。
