/install adaptive-cruise-control-pid-controller
PID Controller Implementation
Overview
A PID (Proportional-Integral-Derivative) controller is a feedback control mechanism used in industrial control systems. It continuously calculates an error value and applies a correction based on proportional, integral, and derivative terms.
Control Law
output = Kp * error + Ki * integral(error) + Kd * derivative(error)
Where:
error= setpoint - measured_valueKp= proportional gain (reacts to current error)Ki= integral gain (reacts to accumulated error)Kd= derivative gain (reacts to rate of change)
Discrete-Time Implementation
class PIDController:
def __init__(self, kp, ki, kd, output_min=None, output_max=None):
self.kp = kp
self.ki = ki
self.kd = kd
self.output_min = output_min
self.output_max = output_max
self.integral = 0.0
self.prev_error = 0.0
def reset(self):
"""Clear controller state."""
self.integral = 0.0
self.prev_error = 0.0
def compute(self, error, dt):
"""Compute control output given error and timestep."""
# Proportional term
p_term = self.kp * error
# Integral term
self.integral += error * dt
i_term = self.ki * self.integral
# Derivative term
derivative = (error - self.prev_error) / dt if dt > 0 else 0.0
d_term = self.kd * derivative
self.prev_error = error
# Total output
output = p_term + i_term + d_term
# Output clamping (optional)
if self.output_min is not None:
output = max(output, self.output_min)
if self.output_max is not None:
output = min(output, self.output_max)
return output
Anti-Windup
Integral windup occurs when output saturates but integral keeps accumulating. Solutions:
- Clamping: Limit integral term magnitude
- Conditional Integration: Only integrate when not saturated
- Back-calculation: Reduce integral when output is clamped
Tuning Guidelines
Manual Tuning:
- Set Ki = Kd = 0
- Increase Kp until acceptable response speed
- Add Ki to eliminate steady-state error
- Add Kd to reduce overshoot
Effect of Each Gain:
- Higher Kp -> faster response, more overshoot
- Higher Ki -> eliminates steady-state error, can cause oscillation
- Higher Kd -> reduces overshoot, sensitive to noise
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install adaptive-cruise-control-pid-controller - After installation, invoke the skill by name or use
/adaptive-cruise-control-pid-controller - Provide required inputs per the skill's parameter spec and get structured output
What is pid-controller?
Use this skill when implementing PID control loops for adaptive cruise control, vehicle speed regulation, throttle/brake management, or any feedback control... It is an AI Agent Skill for Claude Code / OpenClaw, with 102 downloads so far.
How do I install pid-controller?
Run "/install adaptive-cruise-control-pid-controller" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is pid-controller free?
Yes, pid-controller is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does pid-controller support?
pid-controller is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created pid-controller?
It is built and maintained by wu-uk (@wu-uk); the current version is v0.1.0.