OpenClaw agent runtime workflow

在 OpenClaw 中开发 OpenClaw 智能体运行时的合理工作流。

类型检查和 lint

• 默认本地门禁：pnpm check
• 构建门禁：当变更可能影响构建产物、打包或延迟加载/模块边界时运行 pnpm build
• 智能体运行时变更的完整合入门禁：pnpm check && pnpm test

运行 Agent Runtime 测试

直接用 Vitest 运行智能体运行时测试集：

pnpm test \  "src/agents/agent-*.test.ts" \  "src/agents/embedded-agent-*.test.ts" \  "src/agents/agent-tools*.test.ts" \  "src/agents/agent-settings.test.ts" \  "src/agents/agent-tool-definition-adapter*.test.ts" \  "src/agents/agent-hooks/**/*.test.ts"

要包含实时提供商练习：

OPENCLAW_LIVE_TEST=1 pnpm test src/agents/embedded-agent-runner-extraparams.live.test.ts

这会覆盖主要的智能体运行时单元测试套件：

• src/agents/agent-*.test.ts
• src/agents/embedded-agent-*.test.ts
• src/agents/agent-tools*.test.ts
• src/agents/agent-settings.test.ts
• src/agents/agent-tool-definition-adapter.test.ts
• src/agents/agent-hooks/*.test.ts

手动测试

推荐流程：

• 以开发模式运行 Gateway 网关：
  • pnpm gateway:dev
• 直接触发智能体：
  • pnpm openclaw agent --message "Hello" --thinking low
• 使用 TUI 进行交互式调试：
  • pnpm tui

对于工具调用行为，提示执行 read 或 exec 动作，这样你可以看到工具流式传输和载荷处理。

全新状态重置

状态位于 OpenClaw 状态目录下。默认是 ~/.openclaw。如果设置了 OPENCLAW_STATE_DIR，则改用该目录。

要重置所有内容：

• openclaw.json 用于配置
• agents/<agentId>/agent/auth-profiles.json 用于模型凭证配置文件（API 密钥 + OAuth）
• credentials/ 用于仍然位于凭证配置文件存储之外的提供商/渠道状态
• agents/<agentId>/sessions/ 用于智能体会话历史
• agents/<agentId>/sessions/sessions.json 用于会话索引
• 如果存在旧版路径，则使用 sessions/
• 如果你想要一个空白工作区，则使用 workspace/

如果你只想重置会话，请删除该智能体的 agents/<agentId>/sessions/。如果你想保留凭证，请保留 agents/<agentId>/agent/auth-profiles.json 和 credentials/ 下的任何提供商状态。

参考

• 测试
• 入门指南

相关

• OpenClaw agent runtime architecture