Troubleshooting

Common issues and how to fix them.

Secret reference is missing

If Doctor reports that a workflow or workspace references a missing secret:

text

Workflow "my-workflow" secret_refs references missing secret
  secret_refs maps "SLACK_TOKEN" to secret "slack_bot_token" which is not configured in the workspace.

Add the missing secret to the workspace:

bash

elasticclaw secret create slack_bot_token --workspace my-workspace --value "$SLACK_BOT_TOKEN"

Webhooks not triggering workflows

If webhooks from Linear, GitHub Issues, or Shortcut are not triggering workflows, check that the issue tracker is configured in the workspace and that the webhook URL includes the workspace name:

text

https://server.example.com/api/workspaces/my-workspace/webhooks/linear
https://server.example.com/api/workspaces/my-workspace/webhooks/github-issues

Configure tokens and webhook signing secrets in Settings → Workspaces → Issue Trackers.