PageSourceSearch

https://docs.katbot.ai/guides/openclaw-katbot-integration/

html katbot.ai collected 2026-10-05 13:58:19 UTC 71,567 bytes, 2,205 lines download raw bytes

1
2<!doctype html>
3<html lang="en" class="no-js">
4  <head>
5    
6      <meta charset="utf-8">
7      <meta name="viewport" content="width=device-width,initial-scale=1">
8      
9        <meta name="description" content="Documentation for Katbot.ai — AI-powered trading intelligence for Hyperliquid perpetuals.">
10      
11      
12        <meta name="author" content="DeepOrb Labs LLC">
13      
14      
15        <link rel="canonical" href="https://docs.katbot.ai/guides/openclaw-katbot-integration/">
16      
17      
18        <link rel="prev" href="../community/">
19      
20      
21        <link rel="next" href="../faq/">
22      
23      
24        
25      
26      
27      <link rel="icon" href="../../img/favicon.ico">
28      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.6">
29    
30    
31      
32        <title>OpenClaw Integration - Katbot.ai Docs</title>
33      
34    
35    
36      <link rel="stylesheet" href="../../assets/stylesheets/main.484c7ddc.min.css">
37      
38        
39        <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
40      
41      
42
43
44    
45    
46      
47    
48    
49      
50        
51        
52        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
53        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Inter:300,300i,400,400i,700,700i%7CJetBrains+Mono:400,400i,700,700i&display=fallback">
54        <style>:root{--md-text-font:"Inter";--md-code-font:"JetBrains Mono"}</style>
55      
56    
57    
58      <link rel="stylesheet" href="../../assets/stylesheets/katbot.css">
59    
60    
60<script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
60
61    
62      
63
64    
65    
66  </head>
67  
68  
69    
70    
71      
72    
73    
74    
75    
76    <body dir="ltr" data-md-color-scheme="slate" data-md-color-primary="custom" data-md-color-accent="custom">
77  
78    
79    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
80    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
81    <label class="md-overlay" for="__drawer"></label>
82    <div data-md-component="skip">
83      
84        
85        <a href="#using-the-katbot-trading-skill-with-openclaw" class="md-skip">
86          Skip to content
87        </a>
88      
89    </div>
90    <div data-md-component="announce">
91      
92    </div>
93    
94      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
95        
96      </div>
97    
98    
99      
100
101  
102
103<header class="md-header md-header--shadow" data-md-component="header">
104  <nav class="md-header__inner md-grid" aria-label="Header">
105    <a href="https://katbot.ai" title="Katbot.ai Docs" class="md-header__button md-logo" aria-label="Katbot.ai Docs" data-md-component="logo">
106      
107  <img src="../../img/logo64.png" alt="logo">
108
109    </a>
110    <label class="md-header__button md-icon" for="__drawer">
111      
112      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg>
113    </label>
114    <div class="md-header__title" data-md-component="header-title">
115      <div class="md-header__ellipsis">
116        <div class="md-header__topic">
117          <span class="md-ellipsis">
118            Katbot.ai Docs
119          </span>
120        </div>
121        <div class="md-header__topic" data-md-component="header-topic">
122          <span class="md-ellipsis">
123            
124              OpenClaw Integration
125            
126          </span>
127        </div>
128      </div>
129    </div>
130    
131      
132        <form class="md-header__option" data-md-component="palette">
133  
134    
135    
136    
137    <input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="custom" data-md-color-accent="custom"  aria-label="Switch to light mode"  type="radio" name="__palette" id="__palette_0">
138    
139      <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_1" hidden>
140        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 7a5 5 0 0 1 5 5 5 5 0 0 1-5 5 5 5 0 0 1-5-5 5 5 0 0 1 5-5m0 2a3 3 0 0 0-3 3 3 3 0 0 0 3 3 3 3 0 0 0 3-3 3 3 0 0 0-3-3m0-7 2.39 3.42C13.65 5.15 12.84 5 12 5s-1.65.15-2.39.42zM3.34 7l4.16-.35A7.2 7.2 0 0 0 5.94 8.5c-.44.74-.69 1.5-.83 2.29zm.02 10 1.76-3.77a7.131 7.131 0 0 0 2.38 4.14zM20.65 7l-1.77 3.79a7.02 7.02 0 0 0-2.38-4.15zm-.01 10-4.14.36c.59-.51 1.12-1.14 1.54-1.86.42-.73.69-1.5.83-2.29zM12 22l-2.41-3.44c.74.27 1.55.44 2.41.44.82 0 1.63-.17 2.37-.44z"/></svg>
141      </label>
142    
143  
144    
145    
146    
147    <input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="custom" data-md-color-accent="custom"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_1">
148    
149      <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_0" hidden>
150        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m17.75 4.09-2.53 1.94.91 3.06-2.63-1.81-2.63 1.81.91-3.06-2.53-1.94L12.44 4l1.06-3 1.06 3zm3.5 6.91-1.64 1.25.59 1.98-1.7-1.17-1.7 1.17.59-1.98L15.75 11l2.06-.05L18.5 9l.69 1.95zm-2.28 4.95c.83-.08 1.72 1.1 1.19 1.85-.32.45-.66.87-1.08 1.27C15.17 23 8.84 23 4.94 19.07c-3.91-3.9-3.91-10.24 0-14.14.4-.4.82-.76 1.27-1.08.75-.53 1.93.36 1.85 1.19-.27 2.86.69 5.83 2.89 8.02a9.96 9.96 0 0 0 8.02 2.89m-1.64 2.02a12.08 12.08 0 0 1-7.8-3.47c-2.17-2.19-3.33-5-3.49-7.82-2.81 3.14-2.7 7.96.31 10.98 3.02 3.01 7.84 3.12 10.98.31"/></svg>
151      </label>
152    
153  
154</form>
155      
156    
157    
158      
158<script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
158
159    
160    
161    
162      
163      
164        <label class="md-header__button md-icon" for="__search">
165          
166          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
167        </label>
168        <div class="md-search" data-md-component="search" role="dialog">
169  <label class="md-search__overlay" for="__search"></label>
170  <div class="md-search__inner" role="search">
171    <form class="md-search__form" name="search">
172      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
173      <label class="md-search__icon md-icon" for="__search">
174        
175        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
176        
177        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
178      </label>
179      <nav class="md-search__options" aria-label="Search">
180        
181          <a href="javascript:void(0)" class="md-search__icon md-icon" title="Share" aria-label="Share" data-clipboard data-clipboard-text="" data-md-component="search-share" tabindex="-1">
182            
183            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg>
184          </a>
185        
186        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
187          
188          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
189        </button>
190      </nav>
191      
192        <div class="md-search__suggest" data-md-component="search-suggest"></div>
193      
194    </form>
195    <div class="md-search__output">
196      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
197        <div class="md-search-result" data-md-component="search-result">
198          <div class="md-search-result__meta">
199            Initializing search
200          </div>
201          <ol class="md-search-result__list" role="presentation"></ol>
202        </div>
203      </div>
204    </div>
205  </div>
206</div>
207      
208    
209    
210  </nav>
211  
212</header>
213    
214    <div class="md-container" data-md-component="container">
215      
216      
217        
218          
219        
220      
221      <main class="md-main" data-md-component="main">
222        <div class="md-main__inner md-grid">
223          
224            
225              
226              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
227                <div class="md-sidebar__scrollwrap">
228                  <div class="md-sidebar__inner">
229                    
230
231
232
233<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
234  <label class="md-nav__title" for="__drawer">
235    <a href="https://katbot.ai" title="Katbot.ai Docs" class="md-nav__button md-logo" aria-label="Katbot.ai Docs" data-md-component="logo">
236      
237  <img src="../../img/logo64.png" alt="logo">
238
239    </a>
240    Katbot.ai Docs
241  </label>
242  
243  <ul class="md-nav__list" data-md-scrollfix>
244    
245      
246      
247  
248  
249  
250  
251    <li class="md-nav__item">
252      <a href="../.." class="md-nav__link">
253        
254  
255  
256  <span class="md-ellipsis">
257    
258  
259    Overview
260  
261
262    
263  </span>
264  
265  
266
267      </a>
268    </li>
269  
270
271    
272      
273      
274  
275  
276    
277  
278  
279  
280    
281    
282    
283    
284      
285        
286        
287      
288    
289    
290    <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
291      
292        
293        
294        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" checked>
295        
296          
297          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="">
298            
299  
300  
301  <span class="md-ellipsis">
302    
303  
304    Guides
305  
306
307    
308  </span>
309  
310  
311
312            <span class="md-nav__icon md-icon"></span>
313          </label>
314        
315        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="true">
316          <label class="md-nav__title" for="__nav_2">
317            <span class="md-nav__icon md-icon"></span>
318            
319  
320    Guides
321  
322
323          </label>
324          <ul class="md-nav__list" data-md-scrollfix>
325            
326              
327                
328  
329  
330  
331  
332    <li class="md-nav__item">
333      <a href="../quickstart/" class="md-nav__link">
334        
335  
336  
337  <span class="md-ellipsis">
338    
339  
340    Quickstart
341  
342
343    
344  </span>
345  
346  
347
348      </a>
349    </li>
350  
351
352              
353            
354              
355                
356  
357  
358  
359  
360    <li class="md-nav__item">
361      <a href="../auth/" class="md-nav__link">
362        
363  
364  
365  <span class="md-ellipsis">
366    
367  
368    Authentication
369  
370
371    
372  </span>
373  
374  
375
376      </a>
377    </li>
378  
379
380              
381            
382              
383                
384  
385  
386  
387  
388    <li class="md-nav__item">
389      <a href="../subscriptions/" class="md-nav__link">
390        
391  
392  
393  <span class="md-ellipsis">
394    
395  
396    Subscriptions & Plans
397  
398
399    
400  </span>
401  
402  
403
404      </a>
405    </li>
406  
407
408              
409            
410              
411                
412  
413  
414  
415  
416    <li class="md-nav__item">
417      <a href="../agents/" class="md-nav__link">
418        
419  
420  
421  <span class="md-ellipsis">
422    
423  
424    Agents
425  
426
427    
428  </span>
429  
430  
431
432      </a>
433    </li>
434  
435
436              
437            
438              
439                
440  
441  
442  
443  
444    <li class="md-nav__item">
445      <a href="../portfolios/" class="md-nav__link">
446        
447  
448  
449  <span class="md-ellipsis">
450    
451  
452    Portfolios
453  
454
455    
456  </span>
457  
458  
459
460      </a>
461    </li>
462  
463
464              
465            
466              
467                
468  
469  
470  
471  
472    <li class="md-nav__item">
473      <a href="../research/" class="md-nav__link">
474        
475  
476  
477  <span class="md-ellipsis">
478    
479  
480    Research
481  
482
483    
484  </span>
485  
486  
487
488      </a>
489    </li>
490  
491
492              
493            
494              
495                
496  
497  
498  
499  
500    <li class="md-nav__item">
501      <a href="../hyperliquid/" class="md-nav__link">
502        
503  
504  
505  <span class="md-ellipsis">
506    
507  
508    Hyperliquid
509  
510
511    
512  </span>
513  
514  
515
516      </a>
517    </li>
518  
519
520              
521            
522              
523                
524  
525  
526  
527  
528    <li class="md-nav__item">
529      <a href="../recommendations/" class="md-nav__link">
530        
531  
532  
533  <span class="md-ellipsis">
534    
535  
536    Recommendations
537  
538
539    
540  </span>
541  
542  
543
544      </a>
545    </li>
546  
547
548              
549            
550              
551                
552  
553  
554  
555  
556    <li class="md-nav__item">
557      <a href="../strategy-composition/" class="md-nav__link">
558        
559  
560  
561  <span class="md-ellipsis">
562    
563  
564    Strategy Composition
565  
566
567    
568  </span>
569  
570  
571
572      </a>
573    </li>
574  
575
576              
577            
578              
579                
580  
581  
582  
583  
584    <li class="md-nav__item">
585      <a href="../community/" class="md-nav__link">
586        
587  
588  
589  <span class="md-ellipsis">
590    
591  
592    Community
593  
594
595    
596  </span>
597  
598  
599
600      </a>
601    </li>
602  
603
604              
605            
606              
607                
608  
609  
610    
611  
612  
613  
614    <li class="md-nav__item md-nav__item--active">
615      
616      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
617      
618      
619        
620      
621      
622        <label class="md-nav__link md-nav__link--active" for="__toc">
623          
624  
625  
626  <span class="md-ellipsis">
627    
628  
629    OpenClaw Integration
630  
631
632    
633  </span>
634  
635  
636
637          <span class="md-nav__icon md-icon"></span>
638        </label>
639      
640      <a href="./" class="md-nav__link md-nav__link--active">
641        
642  
643  
644  <span class="md-ellipsis">
645    
646  
647    OpenClaw Integration
648  
649
650    
651  </span>
652  
653  
654
655      </a>
656      
657        
658
659<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
660  
661  
662  
663    
664  
665  
666    <label class="md-nav__title" for="__toc">
667      <span class="md-nav__icon md-icon"></span>
668      Table of contents
669    </label>
670    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
671      
672        <li class="md-nav__item">
673  <a href="#risk-disclosure-read-before-you-proceed" class="md-nav__link">
674    <span class="md-ellipsis">
675      
676        ⚠️ Risk Disclosure — Read Before You Proceed
677      
678    </span>
679  </a>
680  
681</li>
682      
683        <li class="md-nav__item">
684  <a href="#what-the-katbot-trading-skill-does" class="md-nav__link">
685    <span class="md-ellipsis">
686      
687        What the Katbot Trading Skill Does
688      
689    </span>
690  </a>
691  
692</li>
693      
694        <li class="md-nav__item">
695  <a href="#prerequisites" class="md-nav__link">
696    <span class="md-ellipsis">
697      
698        Prerequisites
699      
700    </span>
701  </a>
702  
703</li>
704      
705        <li class="md-nav__item">
706  <a href="#step-1-install-the-skill-from-clawhub" class="md-nav__link">
707    <span class="md-ellipsis">
708      
709        Step 1: Install the Skill from ClawHub
710      
711    </span>
712  </a>
713  
714</li>
715      
716        <li class="md-nav__item">
717  <a href="#step-2-run-the-onboarding-wizard" class="md-nav__link">
718    <span class="md-ellipsis">
719      
720        Step 2: Run the Onboarding Wizard
721      
722    </span>
723  </a>
724  
725    <nav class="md-nav" aria-label="Step 2: Run the Onboarding Wizard">
726      <ul class="md-nav__list">
727        
728          <li class="md-nav__item">
729  <a href="#2a-authenticate-with-your-ethereum-wallet-siwe" class="md-nav__link">
730    <span class="md-ellipsis">
731      
732        2a. Authenticate with your Ethereum wallet (SIWE)
733      
734    </span>
735  </a>
736  
737</li>
738        
739          <li class="md-nav__item">
740  <a href="#2b-create-your-katbot-agent-and-assign-it-to-a-portfolio" class="md-nav__link">
741    <span class="md-ellipsis">
742      
743        2b. Create your Katbot Agent and assign it to a portfolio
744      
745    </span>
746  </a>
747  
748</li>
749        
750          <li class="md-nav__item">
751  <a href="#2c-what-gets-saved" class="md-nav__link">
752    <span class="md-ellipsis">
753      
754        2c. What gets saved
755      
756    </span>
757  </a>
758  
759</li>
760        
761      </ul>
762    </nav>
763  
764</li>
765      
766        <li class="md-nav__item">
767  <a href="#step-3-authorize-the-agent-wallet-on-hyperliquid" class="md-nav__link">
768    <span class="md-ellipsis">
769      
770        Step 3: Authorize the Agent Wallet on Hyperliquid
771      
772    </span>
773  </a>
774  
775</li>
776      
777        <li class="md-nav__item">
778  <a href="#step-4-talk-to-your-agent" class="md-nav__link">
779    <span class="md-ellipsis">
780      
781        Step 4: Talk to Your Agent
782      
783    </span>
784  </a>
785  
786    <nav class="md-nav" aria-label="Step 4: Talk to Your Agent">
787      <ul class="md-nav__list">
788        
789          <li class="md-nav__item">
790  <a href="#example-session" class="md-nav__link">
791    <span class="md-ellipsis">
792      
793        Example session
794      
795    </span>
796  </a>
797  
798</li>
799        
800      </ul>
801    </nav>
802  
803</li>
804      
805        <li class="md-nav__item">
806  <a href="#common-phrases" class="md-nav__link">
807    <span class="md-ellipsis">
808      
809        Common Phrases
810      
811    </span>
812  </a>
813  
814</li>
815      
816        <li class="md-nav__item">
817  <a href="#how-the-workflow-works" class="md-nav__link">
818    <span class="md-ellipsis">
819      
820        How the Workflow Works
821      
822    </span>
823  </a>
824  
825    <nav class="md-nav" aria-label="How the Workflow Works">
826      <ul class="md-nav__list">
827        
828          <li class="md-nav__item">
829  <a href="#btc-momentum-index-bmi-when-to-trade" class="md-nav__link">
830    <span class="md-ellipsis">
831      
832        BTC Momentum Index (BMI) — When to Trade
833      
834    </span>
835  </a>
836  
837</li>
838        
839          <li class="md-nav__item">
840  <a href="#recommendation-workflow" class="md-nav__link">
841    <span class="md-ellipsis">
842      
843        Recommendation Workflow
844      
845    </span>
846  </a>
847  
848</li>
849        
850          <li class="md-nav__item">
851  <a href="#leverage-guidelines" class="md-nav__link">
852    <span class="md-ellipsis">
853      
854        Leverage Guidelines
855      
856    </span>
857  </a>
858  
859</li>
860        
861      </ul>
862    </nav>
863  
864</li>
865      
866        <li class="md-nav__item">
867  <a href="#security" class="md-nav__link">
868    <span class="md-ellipsis">
869      
870        Security
871      
872    </span>
873  </a>
874  
875    <nav class="md-nav" aria-label="Security">
876      <ul class="md-nav__list">
877        
878          <li class="md-nav__item">
879  <a href="#architectural-necessity-of-credential-handling" class="md-nav__link">
880    <span class="md-ellipsis">
881      
882        Architectural Necessity of Credential Handling
883      
884    </span>
885  </a>
886  
887    <nav class="md-nav" aria-label="Architectural Necessity of Credential Handling">
888      <ul class="md-nav__list">
889        
890          <li class="md-nav__item">
891  <a href="#the-hyperliquid-agent-wallet-model" class="md-nav__link">
892    <span class="md-ellipsis">
893      
894        The Hyperliquid Agent Wallet Model
895      
896    </span>
897  </a>
898  
899</li>
900        
901          <li class="md-nav__item">
902  <a href="#transmission-logic" class="md-nav__link">
903    <span class="md-ellipsis">
904      
905        Transmission Logic
906      
907    </span>
908  </a>
909  
910</li>
911        
912          <li class="md-nav__item">
913  <a href="#metamask-wallet-key-security" class="md-nav__link">
914    <span class="md-ellipsis">
915      
916        MetaMask Wallet Key Security
917      
918    </span>
919  </a>
920  
921</li>
922        
923      </ul>
924    </nav>
925  
926</li>
927        
928          <li class="md-nav__item">
929  <a href="#implemented-security-mitigations" class="md-nav__link">
930    <span class="md-ellipsis">
931      
932        Implemented Security Mitigations
933      
934    </span>
935  </a>
936  
937</li>
938        
939          <li class="md-nav__item">
940  <a href="#summary-of-credential-behavior" class="md-nav__link">
941    <span class="md-ellipsis">
942      
943        Summary of Credential Behavior
944      
945    </span>
946  </a>
947  
948</li>
949        
950          <li class="md-nav__item">
951  <a href="#residual-trust-requirement" class="md-nav__link">
952    <span class="md-ellipsis">
953      
954        Residual Trust Requirement
955      
956    </span>
957  </a>
958  
959</li>
960        
961      </ul>
962    </nav>
963  
964</li>
965      
966        <li class="md-nav__item">
967  <a href="#troubleshooting" class="md-nav__link">
968    <span class="md-ellipsis">
969      
970        Troubleshooting
971      
972    </span>
973  </a>
974  
975</li>
976      
977        <li class="md-nav__item">
978  <a href="#api-reference" class="md-nav__link">
979    <span class="md-ellipsis">
980      
981        API Reference
982      
983    </span>
984  </a>
985  
986</li>
987      
988        <li class="md-nav__item">
989  <a href="#resources" class="md-nav__link">
990    <span class="md-ellipsis">
991      
992        Resources
993      
994    </span>
995  </a>
996  
997</li>
998      
999    </ul>
1000  
1001</nav>
1002      
1003    </li>
1004  
1005
1006              
1007            
1008              
1009                
1010  
1011  
1012  
1013  
1014    <li class="md-nav__item">
1015      <a href="../faq/" class="md-nav__link">
1016        
1017  
1018  
1019  <span class="md-ellipsis">
1020    
1021  
1022    FAQ
1023  
1024
1025    
1026  </span>
1027  
1028  
1029
1030      </a>
1031    </li>
1032  
1033
1034              
1035            
1036          </ul>
1037        </nav>
1038      
1039    </li>
1040  
1041
1042    
1043      
1044      
1045  
1046  
1047  
1048  
1049    
1050    
1051    
1052    
1053      
1054        
1055        
1056      
1057    
1058    
1059    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
1060      
1061        
1062        
1063          
1064        
1065        <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
1066        
1067          
1068          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
1069            
1070  
1071  
1072  <span class="md-ellipsis">
1073    
1074  
1075    Notices
1076  
1077
1078    
1079  </span>
1080  
1081  
1082
1083            <span class="md-nav__icon md-icon"></span>
1084          </label>
1085        
1086        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
1087          <label class="md-nav__title" for="__nav_3">
1088            <span class="md-nav__icon md-icon"></span>
1089            
1090  
1091    Notices
1092  
1093
1094          </label>
1095          <ul class="md-nav__list" data-md-scrollfix>
1096            
1097              
1098                
1099  
1100  
1101  
1102  
1103    <li class="md-nav__item">
1104      <a href="../../notices/privacy/" class="md-nav__link">
1105        
1106  
1107  
1108  <span class="md-ellipsis">
1109    
1110  
1111    Privacy Policy
1112  
1113
1114    
1115  </span>
1116  
1117  
1118
1119      </a>
1120    </li>
1121  
1122
1123              
1124            
1125              
1126                
1127  
1128  
1129  
1130  
1131    <li class="md-nav__item">
1132      <a href="../../notices/tos/" class="md-nav__link">
1133        
1134  
1135  
1136  <span class="md-ellipsis">
1137    
1138  
1139    Terms of Service
1140  
1141
1142    
1143  </span>
1144  
1145  
1146
1147      </a>
1148    </li>
1149  
1150
1151              
1152            
1153          </ul>
1154        </nav>
1155      
1156    </li>
1157  
1158
1159    
1160  </ul>
1161</nav>
1162                  </div>
1163                </div>
1164              </div>
1165            
1166            
1167              
1168              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
1169                <div class="md-sidebar__scrollwrap">
1170                  <div class="md-sidebar__inner">
1171                    
1172
1173<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
1174  
1175  
1176  
1177    
1178  
1179  
1180    <label class="md-nav__title" for="__toc">
1181      <span class="md-nav__icon md-icon"></span>
1182      Table of contents
1183    </label>
1184    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
1185      
1186        <li class="md-nav__item">
1187  <a href="#risk-disclosure-read-before-you-proceed" class="md-nav__link">
1188    <span class="md-ellipsis">
1189      
1190        ⚠️ Risk Disclosure — Read Before You Proceed
1191      
1192    </span>
1193  </a>
1194  
1195</li>
1196      
1197        <li class="md-nav__item">
1198  <a href="#what-the-katbot-trading-skill-does" class="md-nav__link">
1199    <span class="md-ellipsis">
1200      
1201        What the Katbot Trading Skill Does
1202      
1203    </span>
1204  </a>
1205  
1206</li>
1207      
1208        <li class="md-nav__item">
1209  <a href="#prerequisites" class="md-nav__link">
1210    <span class="md-ellipsis">
1211      
1212        Prerequisites
1213      
1214    </span>
1215  </a>
1216  
1217</li>
1218      
1219        <li class="md-nav__item">
1220  <a href="#step-1-install-the-skill-from-clawhub" class="md-nav__link">
1221    <span class="md-ellipsis">
1222      
1223        Step 1: Install the Skill from ClawHub
1224      
1225    </span>
1226  </a>
1227  
1228</li>
1229      
1230        <li class="md-nav__item">
1231  <a href="#step-2-run-the-onboarding-wizard" class="md-nav__link">
1232    <span class="md-ellipsis">
1233      
1234        Step 2: Run the Onboarding Wizard
1235      
1236    </span>
1237  </a>
1238  
1239    <nav class="md-nav" aria-label="Step 2: Run the Onboarding Wizard">
1240      <ul class="md-nav__list">
1241        
1242          <li class="md-nav__item">
1243  <a href="#2a-authenticate-with-your-ethereum-wallet-siwe" class="md-nav__link">
1244    <span class="md-ellipsis">
1245      
1246        2a. Authenticate with your Ethereum wallet (SIWE)
1247      
1248    </span>
1249  </a>
1250  
1251</li>
1252        
1253          <li class="md-nav__item">
1254  <a href="#2b-create-your-katbot-agent-and-assign-it-to-a-portfolio" class="md-nav__link">
1255    <span class="md-ellipsis">
1256      
1257        2b. Create your Katbot Agent and assign it to a portfolio
1258      
1259    </span>
1260  </a>
1261  
1262</li>
1263        
1264          <li class="md-nav__item">
1265  <a href="#2c-what-gets-saved" class="md-nav__link">
1266    <span class="md-ellipsis">
1267      
1268        2c. What gets saved
1269      
1270    </span>
1271  </a>
1272  
1273</li>
1274        
1275      </ul>
1276    </nav>
1277  
1278</li>
1279      
1280        <li class="md-nav__item">
1281  <a href="#step-3-authorize-the-agent-wallet-on-hyperliquid" class="md-nav__link">
1282    <span class="md-ellipsis">
1283      
1284        Step 3: Authorize the Agent Wallet on Hyperliquid
1285      
1286    </span>
1287  </a>
1288  
1289</li>
1290      
1291        <li class="md-nav__item">
1292  <a href="#step-4-talk-to-your-agent" class="md-nav__link">
1293    <span class="md-ellipsis">
1294      
1295        Step 4: Talk to Your Agent
1296      
1297    </span>
1298  </a>
1299  
1300    <nav class="md-nav" aria-label="Step 4: Talk to Your Agent">
1301      <ul class="md-nav__list">
1302        
1303          <li class="md-nav__item">
1304  <a href="#example-session" class="md-nav__link">
1305    <span class="md-ellipsis">
1306      
1307        Example session
1308      
1309    </span>
1310  </a>
1311  
1312</li>
1313        
1314      </ul>
1315    </nav>
1316  
1317</li>
1318      
1319        <li class="md-nav__item">
1320  <a href="#common-phrases" class="md-nav__link">
1321    <span class="md-ellipsis">
1322      
1323        Common Phrases
1324      
1325    </span>
1326  </a>
1327  
1328</li>
1329      
1330        <li class="md-nav__item">
1331  <a href="#how-the-workflow-works" class="md-nav__link">
1332    <span class="md-ellipsis">
1333      
1334        How the Workflow Works
1335      
1336    </span>
1337  </a>
1338  
1339    <nav class="md-nav" aria-label="How the Workflow Works">
1340      <ul class="md-nav__list">
1341        
1342          <li class="md-nav__item">
1343  <a href="#btc-momentum-index-bmi-when-to-trade" class="md-nav__link">
1344    <span class="md-ellipsis">
1345      
1346        BTC Momentum Index (BMI) — When to Trade
1347      
1348    </span>
1349  </a>
1350  
1351</li>
1352        
1353          <li class="md-nav__item">
1354  <a href="#recommendation-workflow" class="md-nav__link">
1355    <span class="md-ellipsis">
1356      
1357        Recommendation Workflow
1358      
1359    </span>
1360  </a>
1361  
1362</li>
1363        
1364          <li class="md-nav__item">
1365  <a href="#leverage-guidelines" class="md-nav__link">
1366    <span class="md-ellipsis">
1367      
1368        Leverage Guidelines
1369      
1370    </span>
1371  </a>
1372  
1373</li>
1374        
1375      </ul>
1376    </nav>
1377  
1378</li>
1379      
1380        <li class="md-nav__item">
1381  <a href="#security" class="md-nav__link">
1382    <span class="md-ellipsis">
1383      
1384        Security
1385      
1386    </span>
1387  </a>
1388  
1389    <nav class="md-nav" aria-label="Security">
1390      <ul class="md-nav__list">
1391        
1392          <li class="md-nav__item">
1393  <a href="#architectural-necessity-of-credential-handling" class="md-nav__link">
1394    <span class="md-ellipsis">
1395      
1396        Architectural Necessity of Credential Handling
1397      
1398    </span>
1399  </a>
1400  
1401    <nav class="md-nav" aria-label="Architectural Necessity of Credential Handling">
1402      <ul class="md-nav__list">
1403        
1404          <li class="md-nav__item">
1405  <a href="#the-hyperliquid-agent-wallet-model" class="md-nav__link">
1406    <span class="md-ellipsis">
1407      
1408        The Hyperliquid Agent Wallet Model
1409      
1410    </span>
1411  </a>
1412  
1413</li>
1414        
1415          <li class="md-nav__item">
1416  <a href="#transmission-logic" class="md-nav__link">
1417    <span class="md-ellipsis">
1418      
1419        Transmission Logic
1420      
1421    </span>
1422  </a>
1423  
1424</li>
1425        
1426          <li class="md-nav__item">
1427  <a href="#metamask-wallet-key-security" class="md-nav__link">
1428    <span class="md-ellipsis">
1429      
1430        MetaMask Wallet Key Security
1431      
1432    </span>
1433  </a>
1434  
1435</li>
1436        
1437      </ul>
1438    </nav>
1439  
1440</li>
1441        
1442          <li class="md-nav__item">
1443  <a href="#implemented-security-mitigations" class="md-nav__link">
1444    <span class="md-ellipsis">
1445      
1446        Implemented Security Mitigations
1447      
1448    </span>
1449  </a>
1450  
1451</li>
1452        
1453          <li class="md-nav__item">
1454  <a href="#summary-of-credential-behavior" class="md-nav__link">
1455    <span class="md-ellipsis">
1456      
1457        Summary of Credential Behavior
1458      
1459    </span>
1460  </a>
1461  
1462</li>
1463        
1464          <li class="md-nav__item">
1465  <a href="#residual-trust-requirement" class="md-nav__link">
1466    <span class="md-ellipsis">
1467      
1468        Residual Trust Requirement
1469      
1470    </span>
1471  </a>
1472  
1473</li>
1474        
1475      </ul>
1476    </nav>
1477  
1478</li>
1479      
1480        <li class="md-nav__item">
1481  <a href="#troubleshooting" class="md-nav__link">
1482    <span class="md-ellipsis">
1483      
1484        Troubleshooting
1485      
1486    </span>
1487  </a>
1488  
1489</li>
1490      
1491        <li class="md-nav__item">
1492  <a href="#api-reference" class="md-nav__link">
1493    <span class="md-ellipsis">
1494      
1495        API Reference
1496      
1497    </span>
1498  </a>
1499  
1500</li>
1501      
1502        <li class="md-nav__item">
1503  <a href="#resources" class="md-nav__link">
1504    <span class="md-ellipsis">
1505      
1506        Resources
1507      
1508    </span>
1509  </a>
1510  
1511</li>
1512      
1513    </ul>
1514  
1515</nav>
1516                  </div>
1517                </div>
1518              </div>
1519            
1520          
1521          
1522            <div class="md-content" data-md-component="content">
1523              
1524                
1525
1526
1527
1528  
1529
1530
1531  <nav class="md-path" aria-label="Navigation" >
1532    <ol class="md-path__list">
1533      
1534        
1535  
1536  
1537    <li class="md-path__item">
1538      <a href="../.." class="md-path__link">
1539        
1540  <span class="md-ellipsis">
1541    Overview
1542  </span>
1543
1544      </a>
1545    </li>
1546  
1547
1548      
1549      
1550        
1551  
1552  
1553    
1554    
1555      <li class="md-path__item">
1556        <a href="../quickstart/" class="md-path__link">
1557          
1558  <span class="md-ellipsis">
1559    Guides
1560  </span>
1561
1562        </a>
1563      </li>
1564    
1565  
1566
1567      
1568    </ol>
1569  </nav>
1570
1571              
1572              <article class="md-content__inner md-typeset">
1573                
1574                  
1575
1576
1577
1578<h1 id="using-the-katbot-trading-skill-with-openclaw">Using the Katbot Trading Skill with OpenClaw<a class="headerlink" href="#using-the-katbot-trading-skill-with-openclaw" title="Link to this section">&para;</a></h1>
1579<p><img alt="Open Claw" src="../../img/openclaw.png" /></p>
1580<p>This guide shows you how to install the <strong><a href="https://clawhub.ai/claytantor/katbot-trading">Katbot Trading Skill</a></strong> from ClawHub into your OpenClaw agent, complete first-time onboarding, and start getting AI-powered trade recommendations on <a href="https://app.hyperliquid.xyz">Hyperliquid</a> — all from natural conversation.</p>
1581<p><strong>NEED OPENCLAW?</strong></p>
1582<ul>
1583<li>Get VPS/cloud "1-click" OpenClaw on Hostinger for 20% Off with Coupon code: <strong><a href="https://www.hostinger.com/vps/openclaw-hosting?utm_campaign=Brand-RET|NT:Se|LO:USA&amp;utm_medium=ppc&amp;gad_source=1&amp;gad_campaignid=12461035153&amp;gbraid=0AAAAADMy-hZJPPVlwpsXcg1rv_ihor96E&amp;gclid=CjwKCAjwpcTNBhA5EiwAdO1S9h9edJZua7ODtRueHDiCV3ZxUdhcUIn-jUE6ZhkqCkPvn-FEd3V9KhoCoZ0QAvD_BwE#pricing">KATBOTAI</a></strong></li>
1584<li>Or install OpenClaw on your own server or local machine: <strong><a href="https://docs.openclaw.ai/install">OpenClaw Installation Documents</a></strong></li>
1585</ul>
1586<hr />
1587<h2 id="risk-disclosure-read-before-you-proceed">⚠️ Risk Disclosure — Read Before You Proceed<a class="headerlink" href="#risk-disclosure-read-before-you-proceed" title="Link to this section">&para;</a></h2>
1588<div class="admonition warning">
1589<p class="admonition-title">Live Trading Risks</p>
1590<p><strong>Live trading with AI agents carries financial risk.</strong></p>
1591<ul>
1592<li>Cryptocurrency markets are highly volatile. Prices can move against your position rapidly and without warning.</li>
1593<li>AI-generated recommendations are not financial advice. They are based on quantitative signals and may be wrong.</li>
1594<li>Automated trade execution means orders can be placed and filled faster than you can intervene.</li>
1595<li><strong>Katbot and its operators accept no responsibility for trade losses, missed opportunities, or errors resulting from the use of this skill or the Katbot API.</strong> You trade at your own risk.</li>
1596</ul>
1597<p><strong>You must read and agree to the <a href="../../notices/tos/">Katbot Terms and Conditions</a> before using this skill for live trading.</strong></p>
1598<p>Start on testnet. Never risk more than you can afford to lose entirely.</p>
1599</div>
1600<hr />
1601<h2 id="what-the-katbot-trading-skill-does">What the Katbot Trading Skill Does<a class="headerlink" href="#what-the-katbot-trading-skill-does" title="Link to this section">&para;</a></h2>
1602<p>Allows you connect you OpenClaw agent to the Katbot API, enabling AI-powered trade recommendations and execution on Hyperliquid. This also gives you a conversational interface to monitor your portfolio and market conditions using you favorite messaging client (for example telegram).</p>
1603<p><img alt="Katbot On Telegram" src="../../img/openclaw_telegram.png" /></p>
1604<p>Once installed, your OpenClaw agent can:</p>
1605<table>
1606<thead>
1607<tr>
1608<th style="text-align: left;">Capability</th>
1609<th style="text-align: left;">Description</th>
1610</tr>
1611</thead>
1612<tbody>
1613<tr>
1614<td style="text-align: left;"><strong>Market analysis</strong></td>
1615<td style="text-align: left;">Check the BTC Momentum Index (BMI) and top movers</td>
1616</tr>
1617<tr>
1618<td style="text-align: left;"><strong>Token selection</strong></td>
1619<td style="text-align: left;">Pick the best trading candidates based on market direction</td>
1620</tr>
1621<tr>
1622<td style="text-align: left;"><strong>AI recommendations</strong></td>
1623<td style="text-align: left;">Get trade setups with entry, take-profit, stop-loss, and leverage</td>
1624</tr>
1625<tr>
1626<td style="text-align: left;"><strong>Trade execution</strong></td>
1627<td style="text-align: left;">Place live orders on Hyperliquid — always with your approval</td>
1628</tr>
1629<tr>
1630<td style="text-align: left;"><strong>Position monitoring</strong></td>
1631<td style="text-align: left;">Track open trades, P&amp;L, and portfolio health</td>
1632</tr>
1633<tr>
1634<td style="text-align: left;"><strong>Portfolio management</strong></td>
1635<td style="text-align: left;">View balances, positions, and cash</td>
1636</tr>
1637</tbody>
1638</table>
1639<hr />
1640<h2 id="prerequisites">Prerequisites<a class="headerlink" href="#prerequisites" title="Link to this section">&para;</a></h2>
1641<div class="admonition info">
1642<p class="admonition-title">Requirements Checklist</p>
1643<table>
1644<thead>
1645<tr>
1646<th style="text-align: left;">Requirement</th>
1647<th style="text-align: left;">Notes</th>
1648</tr>
1649</thead>
1650<tbody>
1651<tr>
1652<td style="text-align: left;"><a href="https://docs.openclaw.ai">OpenClaw</a></td>
1653<td style="text-align: left;">Installed and running</td>
1654</tr>
1655<tr>
1656<td style="text-align: left;"><a href="https://metamask.io">MetaMask</a></td>
1657<td style="text-align: left;">With ETH on Arbitrum (for SIWE authentication)</td>
1658</tr>
1659<tr>
1660<td style="text-align: left;"><a href="https://katbot.ai">Katbot account</a></td>
1661<td style="text-align: left;">Whitelisted — currently Early Access</td>
1662</tr>
1663<tr>
1664<td style="text-align: left;"><a href="https://app.hyperliquid.xyz">Hyperliquid account</a></td>
1665<td style="text-align: left;">Testnet or Mainnet</td>
1666</tr>
1667</tbody>
1668</table>
1669</div>
1670<hr />
1671<h2 id="step-1-install-the-skill-from-clawhub">Step 1: Install the Skill from ClawHub<a class="headerlink" href="#step-1-install-the-skill-from-clawhub" title="Link to this section">&para;</a></h2>
1672<ol>
1673<li>Open OpenClaw</li>
1674<li>Go to <strong>Skills → Add Skill</strong></li>
1675<li>Search for <strong>"katbot-trading"</strong> or use the direct link:
1676   <strong><a href="https://clawhub.ai/claytantor/katbot-trading">clawhub.ai/claytantor/katbot-trading</a></strong></li>
1677<li>Click <strong>Install</strong></li>
1678</ol>
1679<p>The skill installs to <code>~/.openclaw/workspace/katbot-trading/</code>.</p>
1680<p>OpenClaw will automatically run the environment setup on first install. To run it manually:</p>
1681<div class="language-bash highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>bash<span class="w"> </span>~/.openclaw/workspace/katbot-trading/tools/ensure_env.sh<span class="w"> </span><span class="se">\</span>
1682</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="w">  </span>~/.openclaw/workspace/katbot-trading
1683</span></code></pre></div>
1684<hr />
1685<h2 id="step-2-run-the-onboarding-wizard">Step 2: Run the Onboarding Wizard<a class="headerlink" href="#step-2-run-the-onboarding-wizard" title="Link to this section">&para;</a></h2>
1686<p>The onboarding wizard walks you through authentication and portfolio setup in one session.</p>
1687<div class="language-bash highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>python3<span class="w"> </span>~/.openclaw/workspace/katbot-trading/tools/katbot_onboard.py
1688</span></code></pre></div>
1689<p>The wizard will guide you through the following steps:</p>
1690<h3 id="2a-authenticate-with-your-ethereum-wallet-siwe">2a. Authenticate with your Ethereum wallet (SIWE)<a class="headerlink" href="#2a-authenticate-with-your-ethereum-wallet-siwe" title="Link to this section">&para;</a></h3>
1691<div class="admonition tip">
1692<p class="admonition-title">Security Note</p>
1693<ul>
1694<li>Prompts for your <strong>MetaMask private key</strong> (hidden input — never stored on disk)</li>
1695<li>Signs a login message locally using Sign-In With Ethereum (SIWE)</li>
1696<li>Only the <strong>signature</strong> is sent to <code>api.katbot.ai</code> — your private key never leaves your machine</li>
1697<li>Saves access and refresh tokens to <code>~/.openclaw/workspace/katbot-identity/</code></li>
1698</ul>
1699<blockquote>
1700<p>⚠️ <strong>Never export your MetaMask private key to your shell profile or commit it to any file.</strong></p>
1701</blockquote>
1702</div>
1703<h3 id="2b-create-your-katbot-agent-and-assign-it-to-a-portfolio">2b. Create your Katbot Agent and assign it to a portfolio<a class="headerlink" href="#2b-create-your-katbot-agent-and-assign-it-to-a-portfolio" title="Link to this section">&para;</a></h3>
1704<p>After authentication, the onboarding flow will guide you to create your first <strong>Katbot Agent</strong> (your AI trading assistant) before creating a portfolio. Give your agent a name — this is the entity that will generate trading recommendations. Agent instructions (system prompt, model selection) are configured on the Agent in the Katbot Dashboard → Agent Detail Page → System Prompt tab.</p>
1705<ul>
1706<li>If this is your first time: creates a new portfolio and generates a unique <strong>agent wallet</strong> (Hyperliquid signing key)</li>
1707<li>If you have existing portfolios: lets you choose one</li>
1708<li>Once a portfolio is created, assign your Katbot Agent to it: Dashboard → Portfolio Settings → Assigned Agents → select your agent → "Assign Primary"</li>
1709</ul>
1710<p>The Hyperliquid agent wallet is a separate Ethereum wallet used only to sign trades. It cannot access your main MetaMask funds. This is different from your Katbot AI Agent — see <a href="../hyperliquid/#enabling-hyperliquid-portfolios">Note on Terminology</a>.</p>
1711<blockquote>
1712<p>⚠️ The <strong>agent private key</strong> is shown <strong>once</strong> during portfolio creation. Copy it immediately — it is saved to <code>~/.openclaw/workspace/katbot-identity/katbot_secrets.json</code> (chmod 600).</p>
1713</blockquote>
1714<h3 id="2c-what-gets-saved">2c. What gets saved<a class="headerlink" href="#2c-what-gets-saved" title="Link to this section">&para;</a></h3>
1715<table>
1716<thead>
1717<tr>
1718<th style="text-align: left;">File</th>
1719<th style="text-align: left;">Contents</th>
1720<th style="text-align: left;">Permissions</th>
1721</tr>
1722</thead>
1723<tbody>
1724<tr>
1725<td style="text-align: left;"><code>katbot_config.json</code></td>
1726<td style="text-align: left;">Portfolio ID, wallet address, API URL</td>
1727<td style="text-align: left;">readable</td>
1728</tr>
1729<tr>
1730<td style="text-align: left;"><code>katbot_token.json</code></td>
1731<td style="text-align: left;">Session token (auto-refreshes)</td>
1732<td style="text-align: left;">600</td>
1733</tr>
1734<tr>
1735<td style="text-align: left;"><code>katbot_secrets.json</code></td>
1736<td style="text-align: left;">Agent private key</td>
1737<td style="text-align: left;">600</td>
1738</tr>
1739</tbody>
1740</table>
1741<hr />
1742<h2 id="step-3-authorize-the-agent-wallet-on-hyperliquid">Step 3: Authorize the Agent Wallet on Hyperliquid<a class="headerlink" href="#step-3-authorize-the-agent-wallet-on-hyperliquid" title="Link to this section">&para;</a></h2>
1743<p>Katbot executes trades using the agent wallet. You must grant it trading permission on Hyperliquid:</p>
1744<ol>
1745<li>Copy the <strong>agent wallet address</strong> printed at the end of onboarding</li>
1746<li>Go to <strong><a href="https://app.hyperliquid.xyz">app.hyperliquid.xyz</a></strong> → <strong>Settings</strong> → <strong>API</strong></li>
1747<li>Click <strong>Add API Wallet</strong></li>
1748<li>Paste the agent wallet address</li>
1749<li>Enable <strong>Trading</strong> permission</li>
1750<li>Set expiration to <strong>180 days</strong></li>
1751<li>Confirm the MetaMask transaction</li>
1752</ol>
1753<p>See the <a href="../hyperliquid/">
1753Hyperliquid Integration Guide</a> for screenshots.</p>
1754<p>Your agent now has permission to trade on your behalf.</p>
1755<hr />
1756<h2 id="step-4-talk-to-your-agent">Step 4: Talk to Your Agent<a class="headerlink" href="#step-4-talk-to-your-agent" title="Link to this section">&para;</a></h2>
1757<p>Start OpenClaw and talk naturally. The skill handles the full workflow automatically.</p>
1758<h3 id="example-session">Example session<a class="headerlink" href="#example-session" title="Link to this section">&para;</a></h3>
1759<div class="language-text highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>You: &quot;What&#39;s the market looking like today?&quot;
1760</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a>
1761</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a>Agent: Checking BMI and top movers...
1762</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a>BTC Momentum Index: +22 (BULLISH)
1763</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a>Top 24h gainers on Hyperliquid: SOL +8.2%, AVAX +6.1%, NEAR +5.4%
1764</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a>The market is showing bullish momentum. Want me to get a trade recommendation?
1765</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a>
1766</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a>You: &quot;Yes, give me a recommendation.&quot;
1767</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a>
1768</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a>Agent: Requesting recommendation... (polling)
1769</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a>Recommendation ready:
1770</span><span id="__span-2-12"><a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a>  Action: LONG SOL
1771</span><span id="__span-2-13"><a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a>  Entry: $195.50
1772</span><span id="__span-2-14"><a id="__codelineno-2-14" name="__codelineno-2-14" href="#__codelineno-2-14"></a>  Take Profit: $210.75 (+7.8%)
1773</span><span id="__span-2-15"><a id="__codelineno-2-15" name="__codelineno-2-15" href="#__codelineno-2-15"></a>  Stop Loss: $180.25 (-7.8%)
1774</span><span id="__span-2-16"><a id="__codelineno-2-16" name="__codelineno-2-16" href="#__codelineno-2-16"></a>  Leverage: 3x
1775</span><span id="__span-2-17"><a id="__codelineno-2-17" name="__codelineno-2-17" href="#__codelineno-2-17"></a>  Position size: $2,000
1776</span><span id="__span-2-18"><a id="__codelineno-2-18" name="__codelineno-2-18" href="#__codelineno-2-18"></a>  Confidence: HIGH
1777</span><span id="__span-2-19"><a id="__codelineno-2-19" name="__codelineno-2-19" href="#__codelineno-2-19"></a>  R/R ratio: 1:1
1778</span><span id="__span-2-20"><a id="__codelineno-2-20" name="__codelineno-2-20" href="#__codelineno-2-20"></a>
1779</span><span id="__span-2-21"><a id="__codelineno-2-21" name="__codelineno-2-21" href="#__codelineno-2-21"></a>Want to execute this trade? (yes/no)
1780</span><span id="__span-2-22"><a id="__codelineno-2-22" name="__codelineno-2-22" href="#__codelineno-2-22"></a>
1781</span><span id="__span-2-23"><a id="__codelineno-2-23" name="__codelineno-2-23" href="#__codelineno-2-23"></a>You: &quot;Yes&quot;
1782</span><span id="__span-2-24"><a id="__codelineno-2-24" name="__codelineno-2-24" href="#__codelineno-2-24"></a>
1783</span><span id="__span-2-25"><a id="__codelineno-2-25" name="__codelineno-2-25" href="#__codelineno-2-25"></a>Agent: ⚠️ Confirming: This will place a LONG on SOL for $2,000 at 3x leverage.
1784</span><span id="__span-2-26"><a id="__codelineno-2-26" name="__codelineno-2-26" href="#__codelineno-2-26"></a>Max loss if stop is hit: ~$460. Confirm? (yes/no)
1785</span><span id="__span-2-27"><a id="__codelineno-2-27" name="__codelineno-2-27" href="#__codelineno-2-27"></a>
1786</span><span id="__span-2-28"><a id="__codelineno-2-28" name="__codelineno-2-28" href="#__codelineno-2-28"></a>You: &quot;Yes&quot;
1787</span><span id="__span-2-29"><a id="__codelineno-2-29" name="__codelineno-2-29" href="#__codelineno-2-29"></a>
1788</span><span id="__span-2-30"><a id="__codelineno-2-30" name="__codelineno-2-30" href="#__codelineno-2-30"></a>Agent: ✅ Trade executed. Order ID: 0x12ab3c...
1789</span><span id="__span-2-31"><a id="__codelineno-2-31" name="__codelineno-2-31" href="#__codelineno-2-31"></a>Position open. I&#39;ll monitor it for you.
1790</span></code></pre></div>
1791<hr />
1792<h2 id="common-phrases">Common Phrases<a class="headerlink" href="#common-phrases" title="Link to this section">&para;</a></h2>
1793<p>Talk to your agent naturally. Here are phrases that trigger the skill:</p>
1794<p><strong>Portfolio:</strong>
1795- "What's my current P&amp;L?"
1796- "Show me open positions"
1797- "How much cash do I have?"</p>
1798<p><strong>Market:</strong>
1799- "Check the momentum index"
1800- "What tokens are trending?"
1801- "Is the market bullish or bearish?"</p>
1802<p><strong>Trading:</strong>
1803- "Give me a recommendation"
1804- "Execute the recommendation"
1805- "Close my SOL position"
1806- "Get me a bearish recommendation"</p>
1807<p><strong>Help:</strong>
1808- "What can you do?"
1809- "Explain the recommendation"</p>
1810<hr />
1811<h2 id="how-the-workflow-works">How the Workflow Works<a class="headerlink" href="#how-the-workflow-works" title="Link to this section">&para;</a></h2>
1812<div class="admonition info">
1813<p class="admonition-title">Architecture Overview</p>
1814<div class="language-text highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>You (chat) → OpenClaw Agent → https://api.katbot.ai → Hyperliquid
1815</span></code></pre></div>
1816</div>
1817<h3 id="btc-momentum-index-bmi-when-to-trade">BTC Momentum Index (BMI) — When to Trade<a class="headerlink" href="#btc-momentum-index-bmi-when-to-trade" title="Link to this section">&para;</a></h3>
1818<p>The BMI tells the agent whether the market is trending strongly enough to warrant a trade.</p>
1819<table>
1820<thead>
1821<tr>
1822<th style="text-align: left;">BMI</th>
1823<th style="text-align: left;">Signal</th>
1824<th style="text-align: left;">Agent Action</th>
1825</tr>
1826</thead>
1827<tbody>
1828<tr>
1829<td style="text-align: left;">≥ +15</td>
1830<td style="text-align: left;">BULLISH</td>
1831<td style="text-align: left;">Selects top gainers → requests LONG recommendation</td>
1832</tr>
1833<tr>
1834<td style="text-align: left;">≤ -15</td>
1835<td style="text-align: left;">BEARISH</td>
1836<td style="text-align: left;">Selects worst performers → requests SHORT recommendation</td>
1837</tr>
1838<tr>
1839<td style="text-align: left;">-15 to +15</td>
1840<td style="text-align: left;">NEUTRAL</td>
1841<td style="text-align: left;">Exits cleanly. No trade.</td>
1842</tr>
1843</tbody>
1844</table>
1845<p>The agent will not request a recommendation in a neutral market — this protects you from low-conviction trades.</p>
1846<h3 id="recommendation-workflow">Recommendation Workflow<a class="headerlink" href="#recommendation-workflow" title="Link to this section">&para;</a></h3>
1847<ol>
1848<li><strong>Check BMI</strong> via CoinGecko</li>
1849<li><strong>Select tokens</strong> — best/worst 24h performers on Hyperliquid</li>
1850<li><strong>Request AI analysis</strong> — Katbot analyzes technicals, volatility, price history</li>
1851<li><strong>Generate trade setup</strong> — entry, TP, SL, leverage, position size</li>
1852<li><strong>Present to user</strong> — you see everything before any order is placed</li>
1853<li><strong>Execute only on approval</strong> — the agent never auto-trades</li>
1854</ol>
1855<h3 id="leverage-guidelines">Leverage Guidelines<a class="headerlink" href="#leverage-guidelines" title="Link to this section">&para;</a></h3>
1856<table>
1857<thead>
1858<tr>
1859<th style="text-align: left;">Market Condition</th>
1860<th style="text-align: left;">Recommended Leverage</th>
1861</tr>
1862</thead>
1863<tbody>
1864<tr>
1865<td style="text-align: left;">RSI &lt; 20 or &gt; 80 (extreme)</td>
1866<td style="text-align: left;">1x — high reversal risk</td>
1867</tr>
1868<tr>
1869<td style="text-align: left;">Clear trend, BMI ±15–30</td>
1870<td style="text-align: left;">1–2x</td>
1871</tr>
1872<tr>
1873<td style="text-align: left;">Strong momentum, BMI ±30+</td>
1874<td style="text-align: left;">2–5x</td>
1875</tr>
1876<tr>
1877<td style="text-align: left;">High volume breakout</td>
1878<td style="text-align: left;">Up to 5x</td>
1879</tr>
1880</tbody>
1881</table>
1882<blockquote>
1883<p>At 5x leverage, a 5% adverse move = 25% of your margin at risk. Always honour your stops.</p>
1884</blockquote>
1885<hr />
1886<h2 id="security">Security<a class="headerlink" href="#security" title="Link to this section">&para;</a></h2>
1887<p><code>katbot-trading</code> is an OpenClaw skill that connects an AI agent to <a href="https://api.katbot.ai">Katbot.ai</a>, a portfolio management service for trading perpetual futures on <a href="https://hyperliquid.xyz">Hyperliquid</a>. From a security perspective the skill allows an agent to:</p>
1888<ol>
1889<li>Authenticate with the Katbot API using Sign-In with Ethereum (SIWE).</li>
1890<li>Retrieve AI-generated trade recommendations (entry, take-profit, stop-loss, leverage).</li>
1891<li>Execute trades on Hyperliquid (requires mandatory explicit user confirmation).</li>
1892<li>Monitor open positions and portfolio performance.</li>
1893</ol>
1894<p>The skill does <strong>not</strong> interact with Hyperliquid directly. All on-chain interactions are delegated to the Katbot API using a scoped <strong>agent wallet</strong>
1894—rather than the user's primary wallet—to sign and submit transactions.</p>
1895<h3 id="architectural-necessity-of-credential-handling">Architectural Necessity of Credential Handling<a class="headerlink" href="#architectural-necessity-of-credential-handling" title="Link to this section">&para;</a></h3>
1896<h4 id="the-hyperliquid-agent-wallet-model">The Hyperliquid Agent Wallet Model<a class="headerlink" href="#the-hyperliquid-agent-wallet-model" title="Link to this section">&para;</a></h4>
1897<p>Hyperliquid uses an <strong>API wallet</strong> (agent wallet) system: a separate, limited-scope keypair authorized to trade on behalf of a main wallet.</p>
1898<ul>
1899<li><strong>Permissions:</strong> Trading only; it cannot withdraw funds to external addresses.</li>
1900<li><strong>Control:</strong> Can be revoked instantly by the user via the Hyperliquid UI.</li>
1901<li><strong>Isolation:</strong> The main wallet's funds are not directly accessible via this key.</li>
1902</ul>
1903<h4 id="transmission-logic">Transmission Logic<a class="headerlink" href="#transmission-logic" title="Link to this section">&para;</a></h4>
1904<p>Because the Katbot API operates as a server-side execution engine, the agent key must be available to the API at the time of execution to sign the order. This follows the industry-standard model used by platforms like 3Commas or Pionex.</p>
1905<p>The key is transmitted <strong>only</strong> during:</p>
1906<ul>
1907<li><code>POST /agent/recommendation/message</code> (Trade request)</li>
1908<li><code>POST /portfolio/{id}/execute</code> (Execution)</li>
1909</ul>
1910<p>It is sent via HTTP header (<code>X-Agent-Private-Key</code>) and JSON body. It is <strong>never</strong> logged, stored in browser state, or included in read-only calls.</p>
1911<h4 id="metamask-wallet-key-security">MetaMask Wallet Key Security<a class="headerlink" href="#metamask-wallet-key-security" title="Link to this section">&para;</a></h4>
1912<p>The <code>WALLET_PRIVATE_KEY</code> is used exclusively for SIWE authentication. Signing happens <strong>entirely locally</strong>; only the resulting signature is sent to the API. The private key itself is never transmitted over the network and is never persisted to disk.</p>
1913<h3 id="implemented-security-mitigations">Implemented Security Mitigations<a class="headerlink" href="#implemented-security-mitigations" title="Link to this section">&para;</a></h3>
1914<p>The following measures address specific feedback from the security review:</p>
1915<ol>
1916<li><strong>Elimination of Silent Injection:</strong> Removed the auto-loading of private keys from <code>.env</code> files into <code>os.environ</code> at import time.</li>
1917<li><strong>Narrowed File Discovery:</strong> Search paths for configuration are now restricted to <code>~/katbot_client.env</code> or an explicit <code>OPENCLAW_HOME</code> path, preventing accidental secret loading from repository trees.</li>
1918<li><strong>Registry Metadata Cleanup:</strong> Removed <code>WALLET_PRIVATE_KEY</code> from required environment variables to prevent users from pre-setting it insecurely.</li>
1919<li><strong>Filesystem Protections:</strong> Secrets are written with Unix file mode <code>0o600</code> (owner read/write only).</li>
1920<li><strong>User Consent Mandates:</strong> The <code>SKILL.md</code> now requires the agent to present a <strong>Credential Transmission Notice</strong> and obtain affirmative user confirmation before any sensitive operations.</li>
1921<li><strong>Agent Logic Constraints:</strong> Enumerated rules prevent the AI from logging keys, creating <code>.env</code> files, or reading identity directories.</li>
1922</ol>
1923<h3 id="summary-of-credential-behavior">Summary of Credential Behavior<a class="headerlink" href="#summary-of-credential-behavior" title="Link to this section">&para;</a></h3>
1924<table>
1925<thead>
1926<tr>
1927<th>Credential</th>
1928<th>Stored where</th>
1929<th>Transmitted to</th>
1930<th>When</th>
1931</tr>
1932</thead>
1933<tbody>
1934<tr>
1935<td><strong>WALLET_PRIVATE_KEY</strong></td>
1936<td>Memory only</td>
1937<td>Never (Signature only)</td>
1938<td>Onboarding / re-auth</td>
1939</tr>
1940<tr>
1941<td><strong>AGENT_PRIVATE_KEY</strong></td>
1942<td><code>katbot_secrets.json</code> (600)</td>
1943<td><code>api.katbot.ai</code></td>
1944<td>Recommendations &amp; Execution</td>
1945</tr>
1946<tr>
1947<td><strong>Access Tokens</strong></td>
1948<td><code>katbot_token.json</code> (600)</td>
1949<td><code>api.katbot.ai</code></td>
1950<td>All authenticated calls</td>
1951</tr>
1952</tbody>
1953</table>
1954<h3 id="residual-trust-requirement">Residual Trust Requirement<a class="headerlink" href="#residual-trust-requirement" title="Link to this section">&para;</a></h3>
1955<p>Users must trust <code>api.katbot.ai</code> with their Hyperliquid agent trading key. This is an explicit, documented trust grant required for server-side automation. Users who do not wish to extend this trust should not install the skill.</p>
1956<hr />
1957<h2 id="troubleshooting">Troubleshooting<a class="headerlink" href="#troubleshooting" title="Link to this section">&para;</a></h2>
1958<div class="admonition tip">
1959<p class="admonition-title">Common Issues</p>
1960<p><strong>"Module not found"</strong>
1961<div class="language-bash highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>bash<span class="w"> </span>~/.openclaw/workspace/katbot-trading/tools/ensure_env.sh<span class="w"> </span><span class="se">\</span>
1962</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a><span class="w">  </span>~/.openclaw/workspace/katbot-trading
1963</span></code></pre></div></p>
1964<p><strong>"401 Unauthorized"</strong> — session expired
1965<div class="language-bash highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>python3<span class="w"> </span>~/.openclaw/workspace/katbot-trading/tools/katbot_onboard.py
1966</span></code></pre></div>
1967The wizard re-authenticates and refreshes your tokens.</p>
1968<p><strong>"Trade won't execute"</strong>
1969- Check the agent wallet is authorized in Hyperliquid Settings → API
1970- Verify available cash balance (<code>"show me my portfolio"</code>)
1971- On testnet, orderbooks are thin — try BTC or ETH</p>
1972<p><strong>"Recommendation FAILED"</strong>
1973- Check your Katbot subscription includes AI recommendations
1974- Contact support on <a href="https://discord.gg/ZP73Y8zn">Discord</a></p>
1975<p><strong>"BMI always neutral"</strong>
1976BMI is based on BTC 4h momentum. In choppy, sideways markets this is expected — it's working correctly, keeping you out of bad trades.</p>
1977</div>
1978<hr />
1979<h2 id="api-reference">API Reference<a class="headerlink" href="#api-reference" title="Link to this section">&para;</a></h2>
1980<p>Full interactive docs: <strong><a href="https://api.katbot.ai/docs">https://api.katbot.ai/docs</a></strong></p>
1981<table>
1982<thead>
1983<tr>
1984<th style="text-align: left;">Operation</th>
1985<th style="text-align: left;">Method</th>
1986<th style="text-align: left;">Endpoint</th>
1987</tr>
1988</thead>
1989<tbody>
1990<tr>
1991<td style="text-align: left;">Get nonce</td>
1992<td style="text-align: left;">GET</td>
1993<td style="text-align: left;"><code>/get-nonce/{address}?chain_id=42161</code></td>
1994</tr>
1995<tr>
1996<td style="text-align: left;">Login</td>
1997<td style="text-align: left;">POST</td>
1998<td style="text-align: left;"><code>/login</code></td>
1999</tr>
2000<tr>
2001<td style="text-align: left;">Verify auth</td>
2002<td style="text-align: left;">GET</td>
2003<td style="text-align: left;"><code>/me</code></td>
2004</tr>
2005<tr>
2006<td style="text-align: left;">List portfolios</td>
2007<td style="text-align: left;">GET</td>
2008<td style="text-align: left;"><code>/portfolio</code></td>
2009</tr>
2010<tr>
2011<td style="text-align: left;">Create portfolio</td>
2012<td style="text-align: left;">POST</td>
2013<td style="text-align: left;"><code>/portfolio</code></td>
2014</tr>
2015<tr>
2016<td style="text-align: left;">Portfolio state</td>
2017<td style="text-align: left;">GET</td>
2018<td style="text-align: left;"><code>
2018/portfolio/{id}</code></td>
2019</tr>
2020<tr>
2021<td style="text-align: left;">Update tokens</td>
2022<td style="text-align: left;">PUT</td>
2023<td style="text-align: left;"><code>/portfolio/{id}</code></td>
2024</tr>
2025<tr>
2026<td style="text-align: left;">Request recommendation</td>
2027<td style="text-align: left;">POST</td>
2028<td style="text-align: left;"><code>/agent/recommendation/message</code></td>
2029</tr>
2030<tr>
2031<td style="text-align: left;">Poll recommendation</td>
2032<td style="text-align: left;">GET</td>
2033<td style="text-align: left;"><code>/agent/recommendation/poll/{ticket_id}</code></td>
2034</tr>
2035<tr>
2036<td style="text-align: left;">Get recommendation</td>
2037<td style="text-align: left;">GET</td>
2038<td style="text-align: left;"><code>/portfolio/{id}/recommendation</code></td>
2039</tr>
2040<tr>
2041<td style="text-align: left;">Execute trade</td>
2042<td style="text-align: left;">POST</td>
2043<td style="text-align: left;"><code>/portfolio/{id}/execute</code></td>
2044</tr>
2045<tr>
2046<td style="text-align: left;">Close position</td>
2047<td style="text-align: left;">POST</td>
2048<td style="text-align: left;"><code>/portfolio/{id}/close-position</code></td>
2049</tr>
2050</tbody>
2051</table>
2052<p>All requests require <code>Authorization: Bearer {JWT_TOKEN}</code>. Portfolio and trading endpoints also require the <code>X-Agent-Private-Key</code> header.</p>
2053<hr />
2054<h2 id="resources">Resources<a class="headerlink" href="#resources" title="Link to this section">&para;</a></h2>
2055<ul>
2056<li><a href="https://katbot.ai">Katbot.ai</a></li>
2057<li><a href="https://katbot.ai/terms">Katbot Terms and Conditions</a></li>
2058<li><a href="https://api.katbot.ai/docs">Katbot API Docs</a></li>
2059<li><a href="https://docs.openclaw.ai">OpenClaw Docs</a></li>
2060<li><a href="https://clawhub.ai/claytantor/katbot-trading">ClawHub Skill Page</a></li>
2061<li><a href="https://app.hyperliquid.xyz">Hyperliquid</a></li>
2062<li><a href="https://discord.gg/ZP73Y8zn">Katbot Discord</a></li>
2063<li><a href="https://discord.com/invite/clawd">OpenClaw Discord</a></li>
2064</ul>
2065
2066
2067
2068
2069
2070
2071
2072
2073
2074
2075
2076
2077                
2078              </article>
2079            </div>
2080          
2081          
2082  
2082<script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
2082
2083
2084<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
2084
2085        </div>
2086        
2087          <button type="button" class="md-top md-icon" data-md-component="top" hidden>
2088  
2089  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8z"/></svg>
2090  Back to top
2091</button>
2092        
2093      </main>
2094      
2095        
2096<footer class="md-footer">
2097  <div class="md-footer-meta md-typeset">
2098    <div class="md-footer-meta__inner md-grid">
2099      <div class="kb-footer-grid">
2100        <div class="kb-footer-col kb-footer-col--brand">
2101          <img src="../../img/logo64.png" alt="Katbot" class="kb-footer-logo" />
2102          <p class="kb-footer-tagline">
2103            Agentic AI trading intelligence for Hyperliquid perpetuals.
2104          </p>
2105          <a href="https://katbot.ai" class="md-button md-button--primary">Open Katbot</a>
2106        </div>
2107
2108        <div class="kb-footer-col">
2109          <h6>Product</h6>
2110          <ul>
2111            <li><a href="https://katbot.ai">Katbot.ai</a></li>
2112            <li><a href="https://katbot.ai/plans">Plans</a></li>
2113            <li><a href="https://katpack.ai">KatPack.ai</a></li>
2114          </ul>
2115        </div>
2116
2117        <div class="kb-footer-col">
2118          <h6>Docs</h6>
2119          <ul>
2120            <li><a href="../..">Overview</a></li>
2121            <li><a href="../quickstart/">Quickstart</a></li>
2122            <li><a href="./">OpenClaw</a></li>
2123          </ul>
2124        </div>
2125
2126        <div class="kb-footer-col">
2127          <h6>Legal</h6>
2128          <ul>
2129            <li><a href="../../notices/privacy/">Privacy</a></li>
2130            <li><a href="../../notices/tos/">Terms of Service</a></li>
2131          </ul>
2132        </div>
2133
2134        <div class="kb-footer-col">
2135          <h6>Community</h6>
2136          <div class="md-social">
2137            
2138<div class="md-social">
2139  
2140    
2141    
2142    
2143    
2144    <a href="https://x.com/kitty_katbot" target="_blank" rel="noopener" title="Katbot on X" class="md-social__link">
2145      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M357.2 48h70.6L273.6 224.2 455 464H313L201.7 318.6 74.5 464H3.8l164.9-188.5L-5.2 48h145.6l100.5 132.9zm-24.8 373.8h39.1L119.1 88h-42z"/></svg>
2146    </a>
2147  
2148    
2149    
2150    
2151    
2152    <a href="https://discord.gg/asTcxUTzRv" target="_blank" rel="noopener" title="Katbot Discord" class="md-social__link">
2153      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 576 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M492.5 69.8c-.2-.3-.4-.6-.8-.7-38.1-17.5-78.4-30-119.7-37.1-.4-.1-.8 0-1.1.1s-.6.4-.8.8c-5.5 9.9-10.5 20.2-14.9 30.6-44.6-6.8-89.9-6.8-134.4 0-4.5-10.5-9.5-20.7-15.1-30.6-.2-.3-.5-.6-.8-.8s-.7-.2-1.1-.2C162.5 39 122.2 51.5 84.1 69c-.3.1-.6.4-.8.7C7.1 183.5-13.8 294.6-3.6 404.2c0 .3.1.5.2.8s.3.4.5.6c44.4 32.9 94 58 146.8 74.2.4.1.8.1 1.1 0s.7-.4.9-.7c11.3-15.4 21.4-31.8 30-48.8.1-.2.2-.5.2-.8s0-.5-.1-.8-.2-.5-.4-.6-.4-.3-.7-.4c-15.8-6.1-31.2-13.4-45.9-21.9-.3-.2-.5-.4-.7-.6s-.3-.6-.3-.9 0-.6.2-.9.3-.5.6-.7c3.1-2.3 6.2-4.7 9.1-7.1.3-.2.6-.4.9-.4s.7 0 1 .1c96.2 43.9 200.4 43.9 295.5 0 .3-.1.7-.2 1-.2s.7.2.9.4c2.9 2.4 6 4.9 9.1 7.2.2.2.4.4.6.7s.2.6.2.9-.1.6-.3.9-.4.5-.6.6c-14.7 8.6-30 15.9-45.9 21.8-.2.1-.5.2-.7.4s-.3.4-.4.7-.1.5-.1.8.1.5.2.8c8.8 17 18.8 33.3 30 48.8.2.3.6.6.9.7s.8.1 1.1 0c52.9-16.2 102.6-41.3 147.1-74.2.2-.2.4-.4.5-.6s.2-.5.2-.8c12.3-126.8-20.5-236.9-86.9-334.5zm-302 267.7c-29 0-52.8-26.6-52.8-59.2s23.4-59.2 52.8-59.2c29.7 0 53.3 26.8 52.8 59.2 0 32.7-23.4 59.2-52.8 59.2m195.4 0c-29 0-52.8-26.6-52.8-59.2s23.4-59.2 52.8-59.2c29.7 0 53.3 26.8 52.8 59.2 0 32.7-23.2 59.2-52.8 59.2"/></svg>
2154    </a>
2155  
2156    
2157    
2158    
2159    
2160    <a href="https://www.youtube.com/@PurrfectIntel" target="_blank" rel="noopener" title="Purrfect Intel on YouTube" class="md-social__link">
2161      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 576 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M549.7 124.1c-6.2-23.7-24.8-42.3-48.3-48.6C458.9 64 288.1 64 288.1 64S117.3 64 74.7 75.5c-23.5 6.3-42 24.9-48.3 48.6C15 167 15 256.4 15 256.4s0 89.4 11.4 132.3c6.3 23.6 24.8 41.5 48.3 47.8C117.3 448 288.1 448 288.1 448s170.8 0 213.4-11.5c23.5-6.3 42-24.2 48.3-47.8 11.4-42.9 11.4-132.3 11.4-132.3s0-89.4-11.4-132.3zM232.2 337.6V175.2l142.7 81.2z"/></svg>
2162    </a>
2163  
2164    
2165    
2166    
2167    
2168    <a href="https://github.com/claytantor" target="_blank" rel="noopener" title="GitHub" class="md-social__link">
2169      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m
2169-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
2170    </a>
2171  
2172</div>
2173          </div>
2174        </div>
2175      </div>
2176
2177      <div class="kb-footer-bottom-copyright">
2178        <span>Copyright &copy; 2026 DeepOrb Labs LLC</span>
2179        <span><a href="https://katbot.ai" style="color: inherit; text-decoration: none;">katbot.ai</a></span>
2180      </div>
2181    </div>
2182  </div>
2183</footer>
2184      
2185    </div>
2186    <div class="md-dialog" data-md-component="dialog">
2187      <div class="md-dialog__inner md-typeset"></div>
2188    </div>
2189    
2190      <div class="md-progress" data-md-component="progress" role="progressbar"></div>
2191    
2192    
2193    
2194      
2195      
2196      
2196<script id="__config" type="application/json">{"annotate": null, "base": "../..", "features": ["navigation.sections", "navigation.expand", "navigation.path", "navigation.top", "navigation.instant", "navigation.instant.progress", "navigation.tracking", "toc.follow", "search.suggest", "search.highlight", "search.share", "content.code.copy", "content.code.annotate", "content.tabs.link", "content.action.edit", "content.tooltips"], "search": "../../assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"provider": "mike"}}</script>
2196
2197    
2198    
2199      
2199<script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>
2199
2200      
2201        
2201<script src="../../assets/javascripts/katbot.js"></script>
2201
2202      
2203    
2204  </body>
2205</html>

Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.