src/agents/)的开发者工作流。
类型检查和代码检查
- 默认本地检查:
pnpm check(类型检查、代码检查、策略防护) - 构建检查:当更改可能影响构建输出、打包或延迟加载/模块边界时,运行
pnpm build - 完整的推送前检查:
pnpm build && pnpm check && pnpm check:test-types && pnpm test
运行 Agent Runtimes 测试
运行 Agent Runtimes 单元测试套件:agent-tools*、agent-settings 和
agent-tool-definition-adapter* 测试套件。
单元测试配置不包含实时测试;请通过实时测试
包装器运行(它会设置 OPENCLAW_LIVE_TEST=1,并且需要提供商凭据):
手动测试
- 以开发模式运行 Gateway 网关(通过
OPENCLAW_SKIP_CHANNELS=1跳过渠道连接):pnpm gateway:dev - 通过 Gateway 网关触发一次智能体轮次:
pnpm openclaw agent --message "Hello" --thinking low - 使用 TUI 进行交互式调试:
pnpm tui
read 或 exec 操作,以便观察
工具的流式传输和载荷处理。
全新状态重置
状态存储在 OpenClaw 状态目录中:默认为~/.openclaw,设置
$OPENCLAW_STATE_DIR 后则使用该值。相对于该目录的路径如下:
删除这些路径即可完全重置。范围更小的重置:
- 仅重置会话:不要删除
agents/<agentId>/agent/openclaw-agent.sqlite;会话行与其他各智能体状态一同存储在其中。使用/new或/reset为单个聊天启动新会话,并使用openclaw sessions cleanup维护会话。 - 保留身份验证:保留
agents/<agentId>/agent/openclaw-agent.sqlite和credentials/。
auth-profiles.json 文件;
openclaw doctor --fix 会将其导入 SQLite 存储。