OpenClaw agent runtime workflow

OpenClaw 仓库中智能体运行时（src/agents/）的开发者工作流。

类型检查和代码检查

• 默认本地检查关卡：pnpm check（类型检查、代码检查、策略防护）
• 构建关卡：当更改可能影响构建输出、打包或延迟加载/模块边界时，运行 pnpm build
• 完整的推送前检查关卡：pnpm build && pnpm check && pnpm check:test-types && pnpm test

运行 Agent Runtime 测试

运行智能体运行时单元测试套件：

pnpm test \  "src/agents/agent-*.test.ts" \  "src/agents/embedded-agent-*.test.ts" \  "src/agents/agent-hooks/**/*.test.ts"

第一个 glob 也涵盖 agent-tools*、agent-settings 和 agent-tool-definition-adapter* 测试套件。

单元测试配置不包含实时测试；请通过实时测试封装器运行它们 （该封装器会设置 OPENCLAW_LIVE_TEST=1，并且需要提供商凭据）：

pnpm test:live src/agents/embedded-agent-runner-extraparams.live.test.ts

手动测试

• 以开发模式运行 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 存储。

参考资料

• 测试
• 入门指南

相关内容

• OpenClaw agent runtime architecture