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">¶</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&utm_medium=ppc&gad_source=1&gad_campaignid=12461035153&gbraid=0AAAAADMy-hZJPPVlwpsXcg1rv_ihor96E&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">¶</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">¶</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&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">¶</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">¶</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">¶</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">¶</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">¶</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">¶</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">¶</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">¶</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">¶</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: "What's the market looking like today?" 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: "Yes, give me a recommendation." 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: "Yes" 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: "Yes" 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'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">¶</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&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">¶</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">¶</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">¶</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">¶</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 < 20 or > 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">¶</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">¶</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">¶</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">¶</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">¶</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">¶</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">¶</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 & 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">¶</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">¶</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">¶</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">¶</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 © 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.